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

Push - Position sichern

CxiError CxiTree :: Push ()
CxiError cxiPush (CxiHandle self)

Sichert die aktuelle Position des Sichtfensters

return:
0 ok, sonst Fehler

Zur Abspeicherung der Position verwendet das CXI-System einen Stack-Speicher (daher der Name Push). Jedes CxiTree-Objekt besitzt einen eigenen Stack, der momentan bis zu 60 Einträge aufnehmen kann.

Push legt die aktuelle Position als neues oberstes Element auf dem Stapelspeicher ab. Alle bereits vorhandenen Stackelemente rücken daher eine Position nach unten.

Zur Wiederherstellung der gesicherten Position ist MovePop zu verwenden. Um das oberste Stackelement zu löschen, ohne die Position zu ändern, ist StayPop aufzurufen.

Zur Zwischensicherung der Position im Baum und späterer Wiederherstellung sind die Funktionen Push und MovePop den Funktionen QueryPath und MovePath vorzuziehen.

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

Siehe auch:
NewSub (mit Beispiel)
QueryPath
MovePath
MovePop
StayPop