4D Doc Center : LISTBOX Get information

Home

4D v14.3

LISTBOX Get information


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

Parameter	Typ	Beschreibung
*	Operator	Mit : Objekt ist ein Objektname (String), Ohne : Objekt ist eine Variable
Objekt	Formularobjekt	Objektname (mit ) oder Variable (ohne )
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
Listbox display footer	Lange Ganzzahl	8	0=ausgeblendet, 1=angezeigt
Listbox display header	Lange Ganzzahl	0	0=ausgeblendet, 1=angezeigt
Listbox display hor scrollbar	Lange Ganzzahl	2	0=ausgeblendet, 1=angezeigt
Listbox display ver scrollbar	Lange Ganzzahl	4	0=ausgeblendet, 1=angezeigt
Listbox footer height	Lange Ganzzahl	9	Höhe in Pixel
Listbox header height	Lange Ganzzahl	1	Höhe in Pixel
Listbox hor scrollbar height	Lange Ganzzahl	3	Höhe in Pixel
Listbox hor scrollbar position	Lange Ganzzahl	6	Position des Cursor in Pixel
Listbox ver scrollbar position	Lange Ganzzahl	7	Position des Cursor in Pixel
Listbox ver scrollbar width	Lange Ganzzahl	5	Breite in Pixel

Die ersten 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.
Die Anweisung LISTBOX Get information(vLB;Listbox footer height) gibt denselben Wert zurück wie die Funktion LISTBOX Get footers height, wenn Fußteile angezeigt werden. Werden dagegen Fußteile nicht angezeigt, gibt LISTBOX Get information 0 (Null) zurück, während LISTBOX Get footers height weiterhin die Höhe der Fußteile angibt, die in diesem Fall theoretisch ist.

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).