ListControl(Listenfeld)

Das ListControl dient zur Darstellung von Listenattributen als Auswahllisten. Anders als bei der ComboBox wird die Werteliste sofort bei Auswahl des Felds angezeigt und muss nicht extra aufgeklappt werden. Ist die Werteliste länger als das ListControl, wird ein Scroll-Balken angezeigt.

Beispiel für ein ListControl:



Anmerkung: Die Verwendung eines ListControls ist dann sinnvoll, wenn im Dialog ausreichend Platz vorhanden ist und die Anzeige aller Werte einen Vorteil verspricht.
Anmerkung: Es wird empfohlen, ein Label über oder neben dem ListControl zu platzieren, damit der Agent erkennen kann, um welches Attribut es sich handelt.

Eigenschaften

Dieses Control verfügt ausschließlich über die Standard-Eigenschaften.

Events

SelectionChanged

Dieses Event tritt ein, wenn ein neuer Eintrag in der Liste ausgewählt (markiert) wurde.

Methoden

DeleteItem

Diese Methode löscht den angegebenen Eintrag aus der Dropdownliste.

Syntax DeleteItem(Index)
Parameter Index: Index der Position des Eintrags, der gelöscht werden soll. Die Indizes der Einträge sind nullbasiert, d.h. der erste Eintrag hat den Index 0, der zweite den Index 1 usw.
Beispiel 1 : Im ListControl "list1" soll der erste Eintrag gelöscht werden:

list1.DeleteItem(0)
Beispiel 2 Im ListControl „list1“ soll der letzte Eintrag gelöscht werden:

count = list1.GetItemsCount () (=Anzahl der Einträge, siehe Kapitel „GetItemsCount“)

list1.DeleteItem(count -1)
Anmerkung: Nach dem Löschen des Eintrags werden alle folgenden Einträge um eine Position nach vorne verschoben, so dass die Lücke in den Indizes aufgefüllt werden.

GetItemsCount

Diese Methode ermittelt die Anzahl der Einträge in der Dropdownliste.

Syntax GetItemsCount
Rückgabewert Zahl: Anzahl der Einträge in der Dropdownliste.
Beispiel Im ListControl „list1“ soll die Anzahl der Einträge ermittelt und in der Variablen „count“ gespeichert werden:

count = list1.GetItemsCount()

SelectItem

Diese Methode wählt den angegebenen Eintrag aus der Dropdownliste aus.

Syntax SelectItem(Index)
Parameter Index: Index der Position des Eintrags, der ausgewählt werden soll. Die Indizes der Einträge sind nullbasiert, d. h. der erste Eintrag hat den Index 0, der zweite den Index 1 usw.
Beispiel 1 Im ListControl "list1" soll der erste Eintrag ausgewählt werden:

list1.SelectItem(0)
Beispiel 2 Im ListControl „list1“ soll der letzte Eintrag ausgewählt werden:

count = list1.GetItemsCount () (=Anzahl der Einträge, siehe Kapitel „GetItemsCount“)

list1.SelectItem(count -1)

GetSelected

Diese Methode ermittelt die Position des in der Dropdownliste ausgewählten Eintrags.

Syntax GetSelected
Rückgabewert Zahl:

-1 = In der Dropdownliste wurde kein Eintrag ausgewählt.

>=0 = Index des ausgewählten Eintrags. Die Indizes der Einträge sind nullbasiert, d.h. der erste Eintrag hat den Index 0, der zweite den Index 1 usw.
Beispiel Im ListControl „list1“ soll die Position des ausgewählten Eintrags ermittelt und in der Variablen „pos“ gespeichert werden:

pos = list1.GetSelected()

Tastenkombinationen

Für dieses Control stehen keine Tastenkombinationen zur Verfügung.