LISTBOX Get array

Home

4D v20 R7

LISTBOX Get array


LISTBOX Get array ( {* ;} Objekt ; arrTyp ) -> Funktionsergebnis

Parameter	Typ	Beschreibung
*	Operator	Mit Stern: Objekt ist Objektname (String) Ohne Stern: Objekt ist Variable
Objekt	Formularobjekt	Objektname (mit ) oder Variable (ohne )
arrTyp	Lange Ganzzahl	Typ des Array
Funktionsergebnis	Zeiger	Zeiger auf das Array, verbunden mit der Eigenschaft

Beschreibung

Hinweis: Diese Funktion funktioniert nur für Listboxen vom Typ Array.

Die Funktion LISTBOX Get array gibt einen Zeiger auf das Array zurück, verbunden mit dem Stil oder der Farbe der Listbox oder Spalte der Listbox, definiert durch die Parameter Objekt und *.

Arrays Stil, Farbe, Hintergrundfarbe oder Zeilenkontrolle lassen sich mit Listboxen vom Typ Array oder mit Spalten von Listboxen vom Typ Array (außer für Arrays Zeilenkontrolle) verbinden, entweder über die Eigenschaftenliste im Designmodus oder über den Befehl LISTBOX SET ARRAY.

Mit dem optionalen Parameter * geben Sie an, dass der Parameter Objekt ein Objektname (String) ist. Ohne diesen Parameter ist Objekt eine Variable. In diesem Fall übergeben Sie eine Variablenreferenz anstelle eines String.
In Objekt können Sie eine Listbox oder die Spalte einer Listbox angeben.

In arrTyp übergeben Sie den Arraytyp für die Eigenschaft, die Sie erhalten wollen. Sie können eine der folgenden Konstanten unter dem Thema Listbox verwenden:

Konstante	Typ	Wert
lk background color array	Lange Ganzzahl	1
lk control array	Lange Ganzzahl	3
lk font color array	Lange Ganzzahl	0
lk row height array	Lange Ganzzahl	4
lk style array	Lange Ganzzahl	2

Die Funktion gibt einen der folgenden Werte zurück:

Is nil pointer, wenn kein Array für die angeforderte Eigenschaft mit der Spalte oder Listbox verbunden ist.
Ein Zeiger auf das Array der angeforderten Eigenschaft, vom Benutzer definiert.
Ein Zeiger auf das Array der angeforderten Eigenschaft, dynamisch beim Aufrufen des Befehls LISTBOX SET ROW COLOR oder LISTBOX SET ROW FONT STYLE definiert.

Beispiel

Typische Anwendungsbeispiele:

 vPtr:=LISTBOX Get array(*;"MyLB";lk font color array)

  // gibt einen Zeiger auf das Array Schriftfarbe zurück, verbunden mit der Listbox "MeineLB"

 

 vPtr:=LISTBOX Get array(*;"Col4";lk style array)

  // gibt einen Zeiger auf das Array Schriftstil zurück, verbunden mit den Spalten der Listbox "Col4"

Siehe auch

LISTBOX GET ARRAYS
LISTBOX SET ARRAY