CXI-Basis-Programmierreferenz / Version 2 / Datenspeicherung / CxiTree / Erweiterung des Baums /
CxiError CxiTree :: MoveDownAuto (CxiName pname, CxiLong options = cxiOptAutoCreate)
CxiError cxiMoveDownAuto (CxiHandle self, CxiName pname, CxiLong options)
Wechselt das aktuelle Sichtfenster des CXI-Baums, der Knoten wird ggf. angelegt
pname:
Name der Unterbaum-Variablen, die das neue Sichtfenster wird
options:
Verhalten, wenn Knoten nicht existiert (nur eine Angabe möglich):
cxiOptNoCreate (=0): Knoten nicht automatisch anlegen;
cxiOptAutoCreate (Vorgabe): Knoten anlegen, falls Variable pname nicht existiert;
cxiOptForceCreate: Knoten anlegen, falls Variable pname nicht existiert oder nicht vom Typ cxiTypeSub ist
return:
0 ok, sonst Fehler
Mit dieser Funktion wird das Sichtfenster vom aktuellen Knoten auf einen Kindknoten verschoben, wobei der Zielknoten automatisch angelegt werden kann.
Die verwandte const-Funktion MoveDown bewegt das Sichtfenster, ohne einen neuen Knoten anzulegen; sie liefert einen Fehlercode, wenn der angegebene Knoten nicht existiert.
Für die Erstellung ganzer Pfade kann die Funktion MovePathAuto verwendet werden.
Um einen Knoten anzulegen, ohne das Sichtfenster zu bewegen, ist cxiNewSub vorgesehen.
Portabilität:
Diese Funktion ist in allen unterstützten Systemen verfügbar.
Siehe auch:
NewSub (mit Beispiel)
MovePathAuto
MoveDown
MovePath