Version 2004.1 (Geändert)
Get listbox information ({*; }Objekt; Info) Lange Ganzzahl
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 Get listbox 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.
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 | Zurückgegebener Wert(e) |
Display listbox header | Lange Ganzzahl | 0 | 0=ausgeblendet, 1=sichtbar |
Listbox header height | Lange Ganzzahl | 1 | Höhe in Pixel |
Display listbox hor scrollbar | Lange Ganzzahl | 2 | 0=ausgeblendet, 1=sichtbar |
Listbox hor scrollbar height | Lange Ganzzahl | 3 | Höhe in Pixel |
Display listbox ver scrollbar | Lange Ganzzahl | 4 | 0=ausgeblendet, 1=sichtbar |
Listbox ver scrollbar width | Lange Ganzzahl | 5 | Breite in Pixel |
Position listbox hor scrollbar | Lange Ganzzahl | 6 | Cursor-Position in Pixel |
Position listbox ver scrollbar | Lange Ganzzahl | 7 | Cursor-Position 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 Get listbox 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:=Get listbox 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).
Referenz
SET SCROLLBAR VISIBLE, SHOW LISTBOX GRID.