CXI-Basis-Programmierreferenz / Version 2 / Datenspeicherung / CxiTree / Position sichern und wiederherstellen /

MovePop - Position wiederherstellen

CxiError CxiTree :: MovePop ()
CxiError cxiMovePop (CxiHandle self)

Stellt eine gesicherte Position des Sichtfensters wieder her

return:
0 ok, sonst Fehler

MovePop liest das oberste Element des Stapelspeichers und bewegt das Sichtfenster an die dort angegebene Position. Dann wird das oberste Element vom Stack entfernt. Alle noch vorhandenen Stackelemente rücken daher eine Position nach oben.

Damit diese Funktion die Position korrekt wiederherstellen kann, darf zwischen Push und MovePop kein Knoten des Baums gelöscht worden sein, der auf dem Weg zwischen der Wurzel und der wiederherzustellenden Position (einschließlich) lag. In diesem Fall existiert der Zielknoten nicht mehr, MovePop kann den Fehler in der Regel jedoch nicht feststellen und springt an eine undefinierte Position.

Die Sicherung der Position des Sichtfensters auf dem Stack erfolgt mit der Funktion Push. Um das oberste Stackelement zu löschen, ohne die Position zu ändern, ist StayPop aufzurufen.

Portabilität:
Diese Funktion ist in allen unterstützten Systemen verfügbar.

Siehe auch:
Push
StayPop
NewSub (mit Beispiel)
MoveDown
MoveUp
MoveHome
MoveNext
MovePath