LISTBOX Get property

Home

4D v20 R7


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	Wert	Kommentar
lk allow wordwrap	14	Eigenschaft Zeilenumbruch Gilt für: Spalte* Mögliche Werte: lk no: (0) lk yes: (1)
lk auto row height	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	22	Eigenschaft Hintergrundfarbe Ausdruck für Listbox vom Typ Auswahl Datensatz, Collection oder Entity-Selection Gilt für: Listbox oder Spalte
lk cell horizontal padding	36	Horizontale Einrückung der Zelle in Pixel (gleicher Wert für linke und rechte Einrückung) Gilt für: Listbox, Spalte, Kopfteil, Fußteil
lk cell vertical padding	37	Vertikale Einrückung der Zelle in Pixel (gleicher Wert für obere und untere Einrückung) Gilt für: Listbox, Spalte, Kopfteil, Fußteil
lk column max width	26	Eigenschaft Maximale Breite Gilt für: Spalte*
lk column min width	25	Eigenschaft Minimale Breite Gilt für: Spalte*
lk column resizable	15	Eigenschaft Vergrößerbar Gilt für: Spalte * Mögliche Werte: lk no (0): lk yes (1):
lk detail form name	19	Eigenschaft Name Detailformular für Listbox vom Typ Auswahl. Gilt für: Listbox
lk display footer	8	Eigenschaft Fußteil anzeigen Gilt für: Listbox Mögliche Werte: lk no (0): Ausgeblendet lk yes (1): Eingeblendet
lk display header	0	Eigenschaft Kopfteil anzeigen Gilt für: Listbox Mögliche Werte: lk no (0): Ausgeblendet lk yes (1): Eingeblendet
lk display type	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	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	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	23	Eigenschaft Schriftfarbe Ausdruck für Listbox vom Typ Auswahl Datensatz, Collection oder Entity-Selection Gilt für: Listbox oder Spalte
lk font style expression	24	Eigenschaft Stilausdruck für Listbox vom Typ Auswahl Datensatz, Collection und Entity-Selection Gilt für: Listbox oder Spalte
lk hide selection highlight	16	Eigenschaft Markierung Auswahl ausblenden Gilt für: Listbox Mögliche Werte: lk no: (0) lk yes: (1)
lk highlight set	27	Eigenschaft Markierung Menge für Listbox vom Typ Auswahl Gilt für: Listbox
lk hor scrollbar height	3	Höhe in Pixel
lk movable rows	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	30	Eigenschaft Mehrfachstil Gilt für: Spalte * Mögliche Werte: lk no (0) lk yes (1)
lk named selection	28	Eigenschaft temporäre Auswahl Gilt für: Listbox
lk resizing mode	11	Eigenschaft Spaltenbreite Automatisch Gilt für: Listbox Mögliche Werte: lk manual: (0) lk automatic: (2)
lk row height unit	17	Eigenschaft Einheit für Zeilenhöhe Gilt für: Listbox Mögliche Werte: lk lines (1) lk pixels (0)
lk selection mode	10	Eigenschaft Auswahlmodus Gilt für: Listbox Mögliche Werte: lk none (0) lk single (1) lk multiple (2)
lk single click edit	29	Eigenschaft Einzelklick editieren Gilt für: Listbox Mögliche Werte: lk no (0) lk yes (1)
lk sortable	20	Eigenschaft Sortierbar Gilt für: Listbox Mögliche Werte: lk no: (0) lk yes: (1)
lk truncate	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	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