ListViewGadget()

Syntax

Ergebnis = ListViewGadget(#Gadget, x, y, Breite, Höhe [, Flags])

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

Parameter

#Gadget	Eine Nummer, um das neue Gadget zu identifizieren. #PB_Any kann verwendet werden, um diese Nummer automatisch zu generieren.
x, y, Breite, Höhe	Die Position und die Abmessungen des neuen Gadgets.
Flags (optional)	Flags zum Verändern des Gadget-Verhaltens. Dies kann eine Kombination (verknüpft mit dem bitweisen '|' OR-Operator) der folgenden Konstanten sein: #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. (auf OS X das gleiche Verhalten wie #PB_ListView_Multiselect)

Rückgabewert

Gibt bei Erfolg einen Wert ungleich Null zurück, oder Null bei einem Fehler. Wenn #PB_Any als #Gadget Parameter verwendet wurde, dann beinhaltet der Rückgabewert bei Erfolg die automatisch generierte Gadget-Nummer.

Anmerkungen

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 Listeninhalt zuzugreifen:

- AddGadgetItem(): fügt einen Eintrag hinzu. Ein ListViewGadget() ist auf 65536 Einträge begrenzt.
- RemoveGadgetItem(): entfernt einen Eintrag.
- ClearGadgetItems(): entfernt alle Einträge.
- CountGadgetItems(): ermittelt die Anzahl der aktuell im Gadget enthaltenen Einträge.

- 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 gesamte Auswahl entfernt (nichts ist mehr selektiert).
- 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 (wird auch ausgelöst, wenn sich die Auswahl ändert)
  #PB_EventType_LeftDoubleClick
  #PB_EventType_RightClick

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

Siehe auch

AddGadgetItem(), RemoveGadgetItem(), ClearGadgetItems(), CountGadgetItems(), GetGadgetState(), SetGadgetState(), GetGadgetText(), SetGadgetText(), GetGadgetItemState(), SetGadgetItemState(), GetGadgetItemText(), SetGadgetItemText(), GetGadgetItemData(), SetGadgetItemData(), GetGadgetColor(), SetGadgetColor(), ListIconGadget()

Unterstützte OS

Alle