ListViewGadget()

Syntax

Ergebnis = ListViewGadget(#Gadget, x, y, Breite, Hoehe [, Flags])

Erstellt ein ListView Gadget (Auswahlliste) innerhalb der aktuellen Gadgetliste.

Wenn #PB_Any als '#Gadget' Parameter verwendet wird, dann wird die Nummer des neuen Gadgets als 'Ergebnis' zurückgegeben. '#Gadget' ist die Nummer, die (später) von der EventGadget() Funktion zurückgegeben wird.

'Flags' sind immer optional und können sich aus einer oder mehreren der folgenden Konstanten (verknüpft mit dem '|' OR-Operator) zusammensetzen:

  #PB_ListView_Multiselect: ermöglicht die Auswähl mehrerer Einträge
  #PB_ListView_ClickSelect: ermöglicht die Auswähl mehrerer Einträge. Das Anklicken eines Eintrags markiert diesen
                                     bzw. entfernt die Auswahl.

Zu diesem Gadget kann mittels GadgetToolTip() eine 'Mini-Hilfe' hinzugefügt werden.

Sobald ein ListView Gadget erstellt wurde, ist dessen Listeninhalt leer. Die folgenden Befehle können benutzt werden, um auf den Listen-Inhalt zuzugreifen:

- AddGadgetItem(): fügt einen Eintrag hinzu.
- RemoveGadgetItem(): entfernt einen Eintrag.
- ClearGadgetItems(): entfernt alle Einträge.
- CountGadgetItems(): ermittelt die Anzahl der aktuellen Einträge im #Gadget.

- GetGadgetItemData(): ermittelt den Wert, der mit dem Gadget-Eintrag gespeichert wurde.
- GetGadgetItemState(): gibt einen Wert ungleich Null zurück, wenn der Eintrag ausgewählt ist, andernfalls Null.
- GetGadgetItemText(): ermittelt den Inhalt des angegebenen Eintrags.
- GetGadgetState(): ermittelt den Index vom ausgewählten Eintrag oder -1, wenn kein Eintrag selektiert ist.
- GetGadgetText() ermittelt den Textinhalt vom ausgewählten Eintrag.
- SetGadgetItemData(): speichert einen Wert mit dem angegebenen Eintrag.
- SetGadgetItemState(): selektiert den angegebenen Eintrag oder entfernt die Auswahl.
- SetGadgetItemText(): ändert den Text des angegebenen Eintrags.
- SetGadgetState() ändert den ausgewählten Eintrag. Wird -1 angegeben, dann wird die Auswahl entfernt.
- SetGadgetText(): wählt den Eintrag mit dem angegebenen Text aus (der Text muss exakt übereinstimmen).

Dieses Gadget unterstützt die SetGadgetColor() und GetGadgetColor() Befehle mit den folgenden Werten als 'FarbTyp':

  #PB_Gadget_FrontColor: Textfarbe
  #PB_Gadget_BackColor : Hintergrundfarbe

Das Auftreten der folgenden Ereignisse kann mittels EventType() abgefragt werden:

  #PB_EventType_LeftClick
  #PB_EventType_LeftDoubleClick

Beispiel:

  If OpenWindow(0, 0, 0, 270, 140, "ListViewGadget", #PB_Window_SystemMenu | #PB_Window_ScreenCentered)
    ListViewGadget(0, 10, 10, 250, 120)
    For a = 1 To 12
      AddGadgetItem (0, -1, "Item " + Str(a) + " of the Listview")   ; definieren des Listview-Inhalts
    Next
    SetGadgetState(0, 9)    ; wir setzen (beginnend bei 0) den zehnten Eintrag als aktiven
    Repeat : Until WaitWindowEvent() = #PB_Event_CloseWindow
  EndIf

Unterstützte OS

Alle