Sprung zum Seitenende Struktur Themen A...Z Titel << >>

CXI-Basis-Programmierreferenz / Version 2 / Datenspeicherung / CxiTree / Erweiterung des Baums /

MoveDownAuto - Knoten anlegen und Sichtfenster wechseln

[C++] CxiError CxiTree :: MoveDownAuto (CxiName pname, CxiLong options = cxiOptAutoCreate)
[C] CxiError cxiMoveDownAuto (CxiHandle self, CxiName pname, CxiLong options)

[S1:BASIS] 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


[i] CXI-Basis-Programmierreferenz
Version 2.10 72 (1014-001), erstellt am 15. April 2000
Textseite 232 von 855, Thema 8396 (MoveDownAuto)
[c] Copyright (c) 1996-2000 by TeraConnect GmbH

Sprung zum Seitenanfang Struktur Themen A...Z Titel << >>