CMarkup OutOfElem Method

bool CMarkup::OutOfElem();

Whereas IntoElem is used to go deeper into the document, OutOfElem is used to get back out. When you call OutOfElem, the main position goes to the parent element and the child position goes to what was the main position. The return value is false if the current position is already at the top of the document.

See Navigating Levels in CMarkup.

<config>
  <diagnostics d="3">
    <file>C:\temp\a.txt</file>
  </diagnostics>
</config>

If the main position is the file element, calling OutOfElem makes the diagnostics element the main position (leaving the file element as the child position). Another call to OutOfElem makes the config element the main position (leaving the diagnostics element as the child position). Another call to OutOfElem returns false and leaves the config element as the main position and the diagnostics element as the child position.