GetGadgetItemState()

Syntaxe

Resultat = GetGadgetItemState(#Gadget, Element)
Description
Renvoie l'état de l'élément d'un gadget.

Arguments

#Gadget Le gadget à utiliser
Element L'élément à tester.

Le premier élément dans le gadget commence à 0.

Valeur de retour

Renvoie l'état de l'élément du gadget ou 0 en cas d'erreur.
Voir ci-dessous pour connaître la signification de cette valeur en fonction du type du gadget.

Remarques

Il s'agit d'une fonction universelle qui fonctionne avec presque tous les gadgets comportant des éléments:
  - CalendarGadget()    : Renvoie #PB_Calendar_Bold quand la date spécifiée est affichée en gras, sinon #PB_Calendar_Normal 
                          est renvoyé. 'Element' doit être une date au format PureBasic.

  - ExplorerListGadget(): Renvoie une combinaison des valeurs suivantes:
    #PB_Explorer_File     : L'élément est un fichier.
    #PB_Explorer_Directory: L'élément est un répertoire (ou un disque).
    #PB_Explorer_Selected : L'élément est sélectionné.

  - ListViewGadget()   : Renvoie 1 si l'élément est sélectionné, 0 sinon.

  - ListIconGadget()   : Renvoie une combinaison des valeurs suivantes:
    #PB_ListIcon_Selected : L'élément est sélectionné
    #PB_ListIcon_Checked  : L'élément a sa case à cocher associée cochée (créé avec l'option #PB_ListIcon_CheckBoxes)
    #PB_ListIcon_Inbetween: L'élément a sa case à cocher associée "indéterminée" (Option #PB_ListIcon_ThreeState).

  - TreeGadget()       : Renvoie une combinaison des valeurs suivantes:
    #PB_Tree_Selected : L'élément est sélectionné.
    #PB_Tree_Expanded : L'élément est déployé (la branche de l'arbre est ouverte).
    #PB_Tree_Collapsed: L'élément est fermé.
    #PB_Tree_Checked  : La case à cocher de l'élément est cochée. (Si l'option #PB_Tree_CheckBoxes est utilisée)
    #PB_Tree_Inbetween: L'élément a sa case à cocher associée "indéterminée" (Option #PB_ListIcon_ThreeState)
Pour vérifier si un état est actif, utiliser l'opérateur '&':
  If Resultat & #PB_Tree_Checked
    ; La 'case à cocher' de l'élément est cochée
  EndIf

Exemple

L'exemple ci-dessous montre comment tester différentes combinaisons pour le gadget ListIconGadget() :
  ; ... Ce code est à placer dans une boucle avec WaitWindowEvent() :
  If GetGadgetItemState(#Listicon, n) & #PB_ListIcon_Checked
    ; L'élément 'n' est coché (indépendamment qu'il soit sélectionné ou non)
  EndIf 
  
  If GetGadgetItemState(#Listicon, n) & #PB_ListIcon_Selected
    ; L'élément 'n' est sélectionné (indépendamment qu'il soit coché ou non)
  EndIf 
  
  If GetGadgetItemState(#Listicon, n) = #PB_ListIcon_Checked | #PB_ListIcon_Selected 
    ; L'élément 'n' est coché et sélectionné
  EndIf 
  
  If GetGadgetItemState(#Listicon, n) & (#PB_ListIcon_Checked | #PB_ListIcon_Selected)
    ; L'élément 'n' est coché ou sélectionné ou les deux
  EndIf

Voir aussi

SetGadgetItemState(), GetGadgetState(), SetGadgetState()

OS Supportés

Tous

<- GetGadgetItemData() - Gadget Index - GetGadgetItemText() ->