LISTBOX Get property

Home

4D v19.8


LISTBOX Get property ( {* ;} Objekt ; Eigenschaft ) -> Funktionsergebnis

Parameter	Typ	Beschreibung
*	Operator	Mit : Objekt ist ein Objektname (String), Ohne : Objekt ist eine Variable
Objekt	Formularobjekt	Objektname (mit ) oder Variable (ohne )
Eigenschaft	Lange Ganzzahl	Eigenschaft, dessen Wert Sie erhalten wollen
Funktionsergebnis	Lange Ganzzahl, String	Aktueller Wert

Beschreibung

Die Funktion LISTBOX Get property gibt den Wert des Parameters Eigenschaft für die Listbox oder Spalte 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.

Hinweis: Existiert keine Listbox oder Spalte der Listbox, definiert durch die Parameter Objekt und *, gibt die Funktion für numerische Eigenschaften -1 zurück, oder einen leeren String.

In Eigenschaft übergeben Sie eine Konstante mit der Eigenschaft, deren Wert Sie erhalten möchten. Sie können eine der vordefinierten Konstanten aus dem Thema Listbox verwenden:

Konstante	Typ	Wert	Kommentar
_o_lk display hor scrollbar	Lange Ganzzahl	2	*Konstante ist überholt* Befehl OBJECT GET SCROLLBAR verwenden
_o_lk display ver scrollbar	Lange Ganzzahl	4	*Konstante ist überholt* Befehl OBJECT GET SCROLLBAR verwenden.
_o_lk footer height	Lange Ganzzahl	9	*Konstante ist überholt* Befehl LISTBOX Get footers height verwenden
_o_lk header height	Lange Ganzzahl	1	*Konstante ist überholt* Befehl LISTBOX Get headers height verwenden
_o_lk hor scrollbar position	Lange Ganzzahl	6	*Konstante ist überholt* Befehl OBJECT GET SCROLL POSITION verwenden
_o_lk ver scrollbar position	Lange Ganzzahl	7	*Konstante ist überholt* Befehl OBJECT GET SCROLL POSITION verwenden
lk allow wordwrap	Lange Ganzzahl	14	Eigenschaft Zeilenumbruch Gilt für: Spalte* Mögliche Werte: lk no: (0) lk yes: (1)
lk auto row height	Lange Ganzzahl	31	Eigenschaft Automatische Zeilenhöhe für Listbox vom Typ Array Gilt für: Listbox oder Spalte Mögliche Werte: lk yes (0) lk no (1)
lk background color expression	Zeichenkette	22	Eigenschaft Hintergrundfarbe Ausdruck für Listbox vom Typ Auswahl Gilt für: Listbox oder Spalte
lk column max width	Lange Ganzzahl	26	Eigenschaft Maximale Breite Gilt für: Spalte*
lk column min width	Lange Ganzzahl	25	Eigenschaft Minimale Breite Gilt für: Spalte*
lk column resizable	Lange Ganzzahl	15	Eigenschaft Vergrößerbar Gilt für: Spalte * Mögliche Werte: lk no (0): lk yes (1):
lk detail form name	Zeichenkette	19	Eigenschaft Name Detailformular für Listbox vom Typ Auswahl. Gilt für: Listbox
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 type	Lange Ganzzahl	21	Eigenschaft Typanzeige für Spalten der Listbox vom Typ Zahl Gilt für: Spalte* Mögliche Werte: lk numeric format: (0) Zeigt Werte im Zahlenformat an lk three states checkbox: (1) Zeigt Werte als Kontrollkästchen mit drei Zuständen an
lk double click on row	Lange Ganzzahl	18	Eigenschaft Doppelklick auf Zeile für Listbox vom Typ Auswahl Gilt für: Listbox Mögliche Werte: lk do nothing (0): Löst keine automatische Aktion aus lk edit record (1): Zeigt den entsprechenden Datensatz im Lese-/Schreibmodus an lk display record (2): Zeigt den entsprechenden Datensatz im Nur-Lesen Modus an
lk extra rows	Lange Ganzzahl	13	Eigenschaft Zusätzliche Leerzeilen ausblenden Gilt für für Listbox Mögliche Werte: lk display: (0) lk hide: (1)
lk font color expression	Zeichenkette	23	Eigenschaft Schriftfarbe Ausdruck für Listbox vom Typ Auswahl Gilt für: Listbox oder Spalte
lk font style expression	Zeichenkette	24	Eigenschaft Stilausdruck für Listbox vom Typ Auswahl Gilt für: Listbox oder Spalte
lk hide selection highlight	Lange Ganzzahl	16	Eigenschaft Markierung Auswahl ausblenden Gilt für: Listbox Mögliche Werte: lk no: (0) lk yes: (1)
lk highlight set	Zeichenkette	27	Eigenschaft Markierung Menge für Listbox vom Typ Auswahl Gilt für: Listbox
lk hor scrollbar height	Lange Ganzzahl	3	Höhe in Pixel
lk movable rows	Lange Ganzzahl	35	Eigenschaft Bewegliche Zeilen für Listbox vom Typ Array Gilt für: Listbox (außer hierarchischer Modus) Mögliche Werte: lk no (0): Zeilen lassen sich nicht im laufenden Betrieb bewegen lk yes (1):Zeilen lassen sich im laufenden Betrieb bewegen (Standard)
lk multi style	Lange Ganzzahl	30	Eigenschaft Mehrfachstil Gilt für: Spalte * Mögliche Werte: lk no (0) lk yes (1)
lk named selection	Zeichenkette	28	Eigenschaft temporäre Auswahl Gilt für: Listbox
lk resizing mode	Lange Ganzzahl	11	Eigenschaft Spaltenbreite Automatisch Gilt für: Listbox Mögliche Werte: lk manual: (0) lk automatic: (1)
lk row height unit	Lange Ganzzahl	17	Eigenschaft Einheit für Zeilenhöhe Gilt für: Listbox Mögliche Werte: lk lines (1) lk pixels (0)
lk selection mode	Lange Ganzzahl	10	Eigenschaft Auswahlmodus Gilt für: Listbox Mögliche Werte: lk none (0) lk single (1) lk multiple (2)
lk single click edit	Lange Ganzzahl	29	Eigenschaft Einzelklick editieren Gilt für: Listbox Mögliche Werte: lk no (0) lk yes (1)
lk sortable	Lange Ganzzahl	20	Eigenschaft Sortierbar Gilt für: Listbox Mögliche Werte: lk no: (0) lk yes: (1)
lk truncate	Lange Ganzzahl	12	Eigenschaft Abkürzen mit Auslassungspunkten Gilt für: Listbox oder Spalte Mögliche Werte: lk without ellipsis: (0) lk with ellipsis: (1)
lk ver scrollbar width	Lange Ganzzahl	5	Breite in Pixel

* Diese Eigenschaften gelten nur für Spalten der Listbox; übergeben Sie eine Listbox als Parameter mit einer dieser Eigenschaften, gibt LISTBOX Get property, je nach übergebener Eigenschaft, -1 oder einen leeren String zurück.

Im allgemeinen gibt LISTBOX Get property zum Anzeigen eines ungültigen Ergebnisses bei Eigenschaften mit numerischen Werten -1 zurück, oder einen leeren String; es werden jedoch keine Fehler generiert. Das passiert insbesondere in folgenden Fällen:

Wenn Sie eine Eigenschaft übergeben, die nicht existiert
Wenn Sie eine Eigenschaft übergeben, die für die angegebene Listbox oder Spalte nicht verfügbar ist, z.B. die Eigenschaft lk font color expression für eine Listbox vom Typ Array
Wenn Sie eine Spalte als Parameter übergeben mit einer Eigenschaft, die für eine Listbox gilt, bzw. eine Listbox mit einer Eigenschaft, die für eine Spalte gilt. (siehe * oben)

Außerdem lassen sich zur gleichen Zeit nur Werte für eine Spalte zurückgeben; verwenden Sie z.B. Teile von Spaltennamen mit dem Symbol "@", um mehrere Spalten mit ähnlichen Namen anzugeben, gibt LISTBOX Get property den ersten gefundenen Wert an; demzufolge ist der zurückgegebene Wert nicht wirklich signifikant.

Hinweise:

Die Konstanten lk display footer und lk display header sind hilfreich zum Berechnen der aktuellen Größe eines Listbox-Bereichs in einem Formular.
Mit den Konstanten _o_lk hor scrollbar position oder _o_lk ver scrollbar position gibt LISTBOX Get property die Position des scrollenden Cursors in Bezug auf seine Ausgangsposition an, z.B. die Größe des ausgeblendeten Teils des Fensters in Pixel. Diese 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. Beachten Sie jedoch, dass diese Konstanten überholt sind und sich besser mit dem Befehl OBJECT GET SCROLL POSITION ersetzen lassen.
Die Anweisung LISTBOX Get property(vLB;_o_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 property 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 1

Sie führen bei der vorgegebenen Listbox "MyListbox" folgende Anweisung aus:

$Value:=LISTBOX Get property(*;"MyListbox";lk selection mode) // der zurückgegebene Wert gibt den Auswahlmodus an

Das zurückgegebene Ergebnis zeigt an, ob sich mehrfache Zeilen auswählen lassen.

Beispiel 2

Sie führen bei der vorgegebenen Listbox "MyListbox" folgende Anweisung aus:

$resizable:=LISTBOX Get property(*;"MyListbox";lk column resizable)

LISTBOX Get property gibt -1 zurück, da die Eigenschaft lk column resizable für Spalten gilt und eine Listbox als Parameter übergeben wurde.

Siehe auch

LISTBOX SET GRID
LISTBOX SET PROPERTY
OBJECT SET SCROLLBAR