ListViewGadget()

Syntax

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

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

Parameter

#Gadget	Gibt eine Nummer an, um das neue Gadget zu identifizieren. #PB_Any kann verwendet werden, um diese Nummer automatisch zu generieren.
x, y, Breite, Höhe	Geben die Position und die Abmessungen des neuen Gadgets an.
Flags (optional)	Gibt optionale Flags an, um das Gadget-Verhalten zu verändern. Diese können 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.

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.
- 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 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

Siehe auch

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

Unterstützte OS

Alle