Zweck
Fügt eine neue Zellengruppe der Liste hinzu.
Klasse
Typ
Methode
Syntax
<oCellGroupList>:Add(<oCellGroupItem>) Æ lSuccess
Argumente
<oCellGroupItem> | Zellengruppe, die der Liste hinzugefügt werden soll. |
Datentyp: | bCellGroupItem |
Rückgabewert
lSuccess | Logischer Wert, der definiert, ob die Zellengruppe der Liste hinzugefügt werden konnte. |
TRUE | Zellengruppe konnte hinzugefügt werden. |
FALSE | Zellengruppe konnte nicht hinzugefügt werden. |
Datentyp: | Logic |
Beschreibung
bCellGroupList:Add() fügt eine Zellengruppe in die Liste ein. Wenn in den Optionen der Wert BCGLO_ROWCONTROL definiert ist, dann wird die Zellengruppe bezogen auf die Startzelle aufsteigend in die Liste einsortiert. Anderenfalls wird die Zellengruppe am Ende der Liste angehängt. Als Parent der Zellengruppe wird der Owner der Liste gesetzt. Des Weiteren werden die Start- und Endzelle der Zellengruppe in relative Werte, bezogen auf den Parent, transformiert. Dies geschieht nur, wenn im Zugriff bCellGroupItem:Options die Option BCGIO_ABSOLUTEPOSITION nicht gesetzt ist.
Die Methode überprüft nicht, ob die Zellengruppe bereits in der Liste existiert. Soll vermieden werden, das eine Zellengruppe mehrmals in die Liste aufgenommen wird, muss vor dem Hinzufügen mit der Methode bCellGroupList:Exist() geprüft werden, ob die Zellengruppe bereits in der Liste enthalten ist.
Siehe auch
Page url: http://www.YOURSERVER.com/index.html?bcellgrouplist_add.htm