next up previous contents index
Next: overwriteObjectWithObject Up: Schnittstellenbeschreibung Previous: insertElement   Contents   Index


insertObjectInElement

Syntax: bool insertObjectInElement(
cFibElement * fibObject,
const char cType='u', unsignedIntFib elementPoint=0,
bool first=true, bool bAbsolute=false )


Diese Methode fügt das übergebene fibObject unter dem Fib-Element an der angegeben Stelle ein. Das Fib-Element unter dem das Fib-Objekt fibObject eingefügt wird, ist das elementPoint'te Fib-Element vom angegebenen Typ cType. In diesem Fib-Element wird ein neues Listenelement eingefügt. Wenn first=true (wahr), wird das übergebene Fib-Objekt fibObject als erstes Teilobjekt im Listenelement eingesetzt, sonst als zweite. Das andere Teilobjekt im neuem Listenelement ist das Objekt, welches durch das Listenelement ersetzt wurde bzw. das Objekt was ursprünglich im Fib-Element zu Position stand. Auf diese Weise enthält des Fib-Element nach der Operation sowohl das ursprünglich enthaltende Fib-Objekt wie auch das neue fibObject.

Ist das Fib-Element an der angegeben Stelle schon Unterobjekt eines Listenelements, wird das fibObject einfach in dieses Listelement eingefügt. Wobei es bei first=true an der Stelle des Fib-Elements eingefügt wird und sonst (first=false) im Listelement direkt hinter der Stelle des Fib-Elements.

Steht an der angegeben Stelle (elementPoint=0) bisher kein Unterobjekt, wird das fibObject als Unterobjekt eingefühgt, ohne ein weiteres Listenelement.

Zurückgegeben wird, ob die Operation erfolgreich war. Diese Operation ist beispielsweise niemals auf Punktelementen, als Fib-Element in denen das Fib-Objekt eingefügt werden soll, erfolgreich, da diese keine Fib-Objekte enthalten können.

Das übergebene fibObject wird für das Einfügen nicht kopiert und darf daher nicht einfach gelöscht werden (z. B. mit delete fibObject).

Im Bild 15 ist ein Beispielaufruf dargestellt.

Figure: Beispiel für insertObjectInElement()
\includegraphics[scale=0.5]{insertObjectInElement}


Eingabeparameter:


Rückgabe: Wenn das Fib-Objekt fibObject eingefügt wurde wird true (=wahr) zurückgegeben, sonst false (=falsch).


next up previous contents index
Next: overwriteObjectWithObject Up: Schnittstellenbeschreibung Previous: insertElement   Contents   Index
Betti Österholz 2013-02-13