LISTBOX INSERT ROWS

Home

4D v16.3

LISTBOX INSERT ROWS


LISTBOX INSERT ROWS ( {* ;} Objekt ; ZeilePosition {; AnzZeilen} )

Parameter	Typ	Beschreibung
*	Operator	Mit : Objekt ist ein Objektname (String), Ohne : Objekt ist eine Variable
Objekt	Formularobjekt	Objektname (mit ) oder Variable (ohne )
ZeilePosition	Lange Ganzzahl	Stelle der einzufügenden Zeile
AnzZeilen	Lange Ganzzahl	Anzahl der einzufügenden Zeilen

Beschreibung

Der Befehl LISTBOX INSERT ROWS fügt eine oder mehrere Zeilen in der Listbox ein, definiert durch die Parameter Objekt und *.

Hinweis: Dieser Befehl funktioniert nur mit Listboxen, die auf Arrays basieren. Bei Verwenden von Listboxen, die auf Auswahlen basieren, hat er keine Auswirkung. Die Systemvariable OK gibt 0 (Null) zurück.

Mit dem optionalen Parameter * geben Sie an, dass Objekt ein Objektname (String) ist. Ohne diesen Parameter ist Objekt eine Variable, d.h. Sie übergeben keinen String, sondern die Referenz auf eine Variable. Weitere Informationen zu Objektnamen finden Sie im Abschnitt Objekteigenschaften.

Standardmäßig, d.h. ohne den Parameter AnzZeilen wird nur 1 Zeile eingefügt.

Die Zeile wird an der Position eingefügt, definiert durch ZeilePosition. An dieser Position wird automatisch eine neue Zeile in allen Arrays hinzugefügt, welche die Spalten der Listbox verwenden, unabhängig vom Typ und der Sichtbarkeit.

Ist der Wert in ZeilePosition höher als die Gesamtanzahl der Zeilen in der Listbox, wird die Zeile am Ende jedes Array hinzugefügt. Ist der Wert gleich 0 (Null), wird die Zeile zu Beginn jedes Array hinzugefügt. Ist der Wert negativ, führt der Befehl nichts aus.

Siehe auch

LISTBOX DELETE ROWS