Wenn #PB_Any als '#Gadget' Parameter verwendet wird, dann wird der Identifier des neuen Gadgets als 'Ergebnis' zurückgegeben. '#Gadget' ist die Nummer, die (später) von der EventGadgetID() Funktion zurückgegeben wird.
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
- ClearGadgetItemList(): entfernt alle Einträge
- CountGadgetItems(): ermittelt die Anzahl der aktuellen Einträge im #Gadget.
- GetGadgetState(): ermittelt den Index vom ausgewählten Eintrag oder -1, wenn kein Eintrag selektiert ist.
- GetGadgetItemText(): ermittelt den Inhalt des angegebenen Eintrags.
- GetGadgetText() ermittelt den Textinhaltes vom ausgewählten Eintrag.
- SetGadgetState() ändert den ausgewählten Eintrag. Wird -1 angegeben, dann wird die Markierung entfernt.
Das Auftreten der folgenden Ereignisse kann mittels EventType() abgefragt werden:
#PB_EventType_LeftClick #PB_EventType_LeftDoubleClick
Beispiel:
If OpenWindow(0,0,0,270,140,#PB_Window_SystemMenu|#PB_Window_ScreenCentered,"ListViewGadget") And CreateGadgetList(WindowID(0))
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
