CheckBoxGadget()

Syntaxe

Resultat = CheckBoxGadget(#Gadget, X, Y, Largeur, Hauteur, Texte$ [, Options])
Description
Crée un gadget case à cocher 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.
Texte$ Le texte à afficher à côté de la case, il est placé à sa droite.
Options (optionnel) Peut être une combinaison de: 
  #PB_CheckBox_Right     : Aligne le texte de la case à cocher à droite.
  #PB_CheckBox_Center    : Centre le texte de la case à cocher.
  #PB_CheckBox_ThreeState: Crée une case à cocher qui peut avoir trois états (dont un état intermédiaire).
L'option #PB_CheckBox_ThreeState permet à une case à cocher de représenter l'état de plusieurs éléments. L'état indéterminé (ni coché, ni décoché) indique alors que certains éléments sont dans un état différent des autres. En cliquant sur la case à cocher, l'utilisateur peut alors les remettre tous dans le même état, soit coché, soit décoché. L'état indéterminé peut donc uniquement être activé à l'aide de SetGadgetState().

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.

  - GetGadgetState() est utilisé pour récupérer l'état du gadget. 
  - SetGadgetState() est utilisé pour changer l'état du gadget.

Exemple

  If OpenWindow(0, 0, 0, 270, 160, "CheckBoxGadget", #PB_Window_SystemMenu | #PB_Window_ScreenCentered) 
    CheckBoxGadget(0, 10,  10, 250, 20, "Case à cocher standard")
    CheckBoxGadget(1, 10,  40, 250, 20, "Case à cocher (cochée)") : SetGadgetState(1, #PB_Checkbox_Checked)
    CheckBoxGadget(2, 10,  70, 250, 20, "Case à cocher à trois états", #PB_CheckBox_ThreeState) : SetGadgetState(2, #PB_Checkbox_Inbetween)
    CheckBoxGadget(3, 10, 100, 250, 20, "Case à cocher (texte aligné à droite)", #PB_CheckBox_Right)
    CheckBoxGadget(4, 10, 130, 250, 20, "Case à cocher (texte centré)", #PB_CheckBox_Center)
    Repeat : Until WaitWindowEvent() = #PB_Event_CloseWindow
  EndIf

Voir aussi

GetGadgetState(), SetGadgetState(), OptionGadget()

OS Supportés

Tous

<- CanvasVectorOutput() - Gadget Index - ClearGadgetItems() ->