Functions > GUI > GUICtrlCreate >


GUICtrlCreateGroup

Crée un contrôle -Group- pour regrouper des contrôles dans une GUI.

GUICtrlCreateGroup ( "text", left, top [, width [, height [, style = -1 [, exStyle = -1]]]] )

Paramètres

text Le texte du contrôle.
left Coordonnée X du coin supérieur gauche du contrôle. Si vous utilisez -1, X sera calculée en accord avec GUICoordMode.
top Coordonnée Y du coin supérieur gauche du contrôle. Si vous utilisez -1, Y sera calculée en accord avec GUICoordMode.
width [optionnel] Largeur du contrôle (par défaut, la largeur utilisée précédemment).
height [optionnel] Hauteur du contrôle (par défaut, la hauteur utilisée précédemment).
style [optionnel] Définit les styles du contrôle. Consultez l'Annexe des styles de contrôle GUI.
    Par défaut (-1) : aucun.
    Styles forcés : $WS_GROUP, $BS_GROUPBOX.
exStyle [optionnel] Définit les styles étendus du contrôle. Consultez la Table des styles étendus.

Valeur de retour

Succès: Retourne l'identifiant (ID du contrôle) du nouveau contrôle.
Échec: Retourne 0.

Remarques

Un groupe de contrôle est la ligne fine que vous voyez autour des contrôles (généralement des boutons Radio uniquement) qui les regroupe de manière visuelle. Un seul bouton Radio dans un groupe peut être sélectionné à la fois.
Si vous voulez avoir plusieurs groupes sans la ligne visible, alors vous devez utiliser GUIStartGroup() pour regrouper vos boutons Radio.

Pour utiliser les valeurs indiquées ci-dessus, vous devez inclure <ButtonConstants.au3> dans votre script.

Le redimensionnement par défaut est $GUI_DOCKAUTO, la taille et la position seront modifiées.

En relation

GUICoordMode (Option), GUIStartGroup

Exemple

#include <GUIConstantsEx.au3>

Example()

Func Example()
    GUICreate("My GUI group") ; Crée une GUI centrée.

    GUICtrlCreateGroup("Group 1", 190, 60, 90, 140)
    GUICtrlCreateRadio("Radio 1", 210, 90, 50, 20)
    GUICtrlCreateRadio("Radio 2", 210, 110, 60, 50)
    GUICtrlCreateGroup("", -99, -99, 1, 1) ; Ferme le groupe

    GUISetState(@SW_SHOW)

    ; Boucle jusqu'à ce que l'utilisateur quitte.
    Do
    Until GUIGetMsg() = $GUI_EVENT_CLOSE
EndFunc   ;==>Example