ListViewGadget()

Syntaxe

Resultat = ListViewGadget(#Gadget, X, Y, Largeur, Hauteur [, Options])
Description
Crée une boîte à listes (ListView) dans la GadgetList en cours.

Arguments

#Gadget Le numéro d'identification du nouveau gadget.

#PB_Any peut être utilisé pour générer automatiquement ce numéro.
X, Y, Largeur, Hauteur La position et les dimensions du nouveau gadget.
Options (optionnel) Peut être une combinaison de: 
  #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 
                            (sous OS X, même comportement que #PB_ListView_Multiselect).

Valeur de retour

Renvoie une valeur non nulle en cas de succès, zéro sinon.

Si #PB_Any a été utilisé pour le paramètre #Gadget, alors la valeur de retour est le numéro d'identification du gadget, généré automatiquement.

Remarques

  - GadgetToolTip() permet d'ajouter une 'mini aide' à ce gadget. 
 
  Les fonctions suivantes peuvent être utilisées pour agir sur le contenu de cette liste:
  - AddGadgetItem()     : Ajoute un élément. Limité à 65 536 éléments.
  - CountGadgetItems()  : Renvoie le nombre de lignes contenues dans le gadget.
  - RemoveGadgetItem()  : Supprime un élément
  - ClearGadgetItems()  : 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 sélectionné/désélectionné de l'élément spécifié et avec -1 tous les éléments sont désélectionnés.
  - 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.

  - SetGadgetColor() et GetGadgetColor() avec les valeurs 'TypeCouleur' suivantes:
    #PB_Gadget_BackColor : Couleur de fond
    #PB_Gadget_FrontColor: Couleur du texte

  Note: SetGadgetColor() n'est pas pris en charge sur la plate-forme MacOS X.
Les évènements suivants sont supportés par EventType(): 
  #PB_EventType_LeftClick (Également déclenché lors d'un changement de sélection)
  #PB_EventType_LeftDoubleClick
  #PB_EventType_RightClick

Exemple

  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,"Elément "+Str(a)+" de la boîte à 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

Voir aussi

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

OS Supportés

Tous

<- ListIconGadget() - Gadget Index - MDIGadget() ->