LISTBOX Get information

Home

4D v16.3


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 die Parameter Objekt und *.

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	Kommentar
lk display footer	Lange Ganzzahl	8	Eigenschaft Fußteil anzeigen Gilt für: Listbox Mögliche Werte: lk no (0): Ausgeblendet lk yes (1): Eingeblendet
lk display header	Lange Ganzzahl	0	Eigenschaft Kopfteil anzeigen Gilt für: Listbox Mögliche Werte: lk no (0): Ausgeblendet lk yes (1): Eingeblendet
lk display hor scrollbar	Lange Ganzzahl	2	0=ausgeblendet, 1=angezeigt
lk display ver scrollbar	Lange Ganzzahl	4	0=ausgeblendet, 1=angezeigt
lk footer height	Lange Ganzzahl	9	Höhe in Pixel
lk header height	Lange Ganzzahl	1	Höhe in Pixel
lk hor scrollbar height	Lange Ganzzahl	3	Höhe in Pixel
lk hor scrollbar position	Lange Ganzzahl	6	Position des Cursor in Pixel
lk ver scrollbar position	Lange Ganzzahl	7	Position des Cursor in Pixel
lk 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 lk hor scrollbar position oder lk ver scrollbar position 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;lk 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";lk ver scrollbar position)

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

Siehe auch

LISTBOX SET GRID
OBJECT SET SCROLLBAR