ListViewGadget()

Syntaxe

Resultat = ListViewGadget(#Gadget, x, y, Largeur, Hauteur [, Options])

Crée une boîte de listes (ListView) dans la GadgetList en cours. Si #PB_Any est utilisé pour le paramètre '#Gadget', le numéro du nouveau gadget sera renvoyé dans 'Resultat'. #Gadget est le numéro du gadget renvoyé par la fonction EventGadget(). Lorsqu'une boîte de listes est créée, sa liste d'éléments est vide.

Le paramètre facultatif 'Options' peut être une combinaison des valeurs suivantes:

  #PB_ListView_Multiselect: Permet la sélection de plusieurs éléments consécutifs.
  #PB_ListView_ClickSelect: Permet la sélection de plusieurs éléments.Cliquez sur un élément pour le sélectionner ou le désélectionner.

Vous pouvez ajouter une 'mini aide' à ce gadget en utilisant GadgetToolTip().

Les fonctions suivantes peuvent être utilisées pour agir sur le contenu de cette liste:

- AddGadgetItem(): Ajoute un élément
- RemoveGadgetItem(): Supprime un élément
- ClearGadgetItemList(): Supprime tous les éléments
- GetGadgetItemData(): Renvoie la valeur personnalisée associée à cet élément.
- SetGadgetItemData(): Associe une valeur personnalisée à cet élément.
- GetGadgetItemText(): Renvoie le texte de l'élément spécifié.
- SetGadgetItemText(): Change le texte de l'élément spécifié.
- GetGadgetItemState(): Renvoie 0 si l'élément n'est pas séléctionné, sinon une valeur non-nulle.
- SetGadgetItemState(): Sélectionne ou désélectionne l'élément spécifié.
- GetGadgetState(): Renvoie le numéro de l'élément qui est sélectionné, -1 si il n'y a pas de sélection.
- SetGadgetState(): Change l'état de l'élément spécifié.
- GetGadgetText(): Renvoie le texte de l'élément sélectionné.
- SetGadgetText(): Sélectionne l'élément correspondant au texte indiqué. Le texte doit exactement correspondre.

Ce gadget supporte les commandes SetGadgetColor() et GetGadgetColor() avec les valeurs 'TypeCouleur' suivantes:

  #PB_Gadget_BackColor : Couleur de fond
  #PB_Gadget_FrontColor: Couleur du texte

Les évènements suivants sont supportés par EventType():

  #PB_EventType_LeftClick
  #PB_EventType_LeftDoubleClick

Exemple:

  If OpenWindow(0,0,0,270,140,"ListViewGadget",#PB_Window_SystemMenu|#PB_Window_ScreenCentered) And CreateGadgetList(WindowID(0))
    ListViewGadget(0,10,10,250,120)
    For a=1 To 12
      AddGadgetItem (0,-1,"Elément "+Str(a)+" de la boîte de liste")   ; défini le contenu de la boîte de liste
    Next
    SetGadgetState(0,9)    ; sélectionne le dixième élément (la numérotation commmence à 0)
    Repeat : Until WaitWindowEvent()=#PB_Event_CloseWindow
  EndIf

OS Supportés

Tous