4D Doc Center : LISTBOX Get information

4D v12.4

LISTBOX Get information


LISTBOX Get information ( {* ;} Objekt ; Info ) -> Funktionsergebnis

Parameter	Typ	Beschreibung
*		Mit : Objekt ist ein Objektname (String), Ohne : Objekt ist eine Variable
Objekt	Formularobjekt	Mit : Objektname, Ohne : Variable
Info	Lange Ganzzahl	Zu erhaltende Information
Funktionsergebnis	Lange Ganzzahl	Aktueller Wert

Beschreibung

Die Funktion LISTBOX Get information gibt Informationen über die Sichtbarkeit, die Größe der Kopfteile und Rollbalken zur Listbox zurück, definiert durch Objekt und den Parameter *.

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.

In Info übergeben Sie einen Wert, der die Art der Information angibt, die Sie erhalten möchten. Sie können eine der vordefinierten Konstanten aus dem Thema Listbox verwenden:

Konstante	Typ	Wert	Meldung
Display listbox header	Lange Ganzzahl	0	0=ausgeblendet, 1=angezeigt
Display listbox hor scrollbar	Lange Ganzzahl	2	0=ausgeblendet, 1=angezeigt
Display listbox ver scrollbar	Lange Ganzzahl	4	0=ausgeblendet, 1=angezeigt
Listbox header height	Lange Ganzzahl	1	Höhe in Pixel
Listbox hor scrollbar height	Lange Ganzzahl	3	Höhe in Pixel
Listbox ver scrollbar width	Lange Ganzzahl	5	Breite in Pixel
Position listbox hor scrollbar	Lange Ganzzahl	6	Position des Cursor in Pixel
Position listbox ver scrollbar	Lange Ganzzahl	7	Position des Cursor in Pixel

Die ersten sechs Konstanten sind hilfreich zum Berechnen der aktuellen Größe eines Listbox-Bereichs in einem Formular.
Mit den Konstanten Position listbox hor scrollbar oder Position listbox ver scrollbar gibt die Funktion LISTBOX Get information die Position des scrollenden Cursors in Bezug auf seine Ausgangsposition an, z.B. die Größe des ausgeblendeten Teils des Fenster, ausgedrückt in Pixel. Die Position ist standardmäßig 0 (Null). In Kombination mit Informationen zur Zeilenhöhe können Sie über diesen Wert den in der Listbox angezeigten Inhalt herausfinden.

Beispiel

Wir gehen aus von einer Listbox mit Zeilen von jeweils 20 Pixel in der Höhe. Führen Sie folgende Anweisung aus:

$scroll:=LISTBOX Get information(*;"Listbox";Position listbox ver scrollbar)

Gibt $scroll 200 zurück, können Sie daraus schließen, dass die 11. Zeile aktuell als erste in der Listbox angezeigt wird (200/20=10, d.h. 10 Zeilen sind ausgeblendet).