Partager via


RadioButtonGroup, contrôle

Le contrôle RadioButtonGroup est un groupe de cases d’option. Il permet à l’utilisateur de sélectionner une chaîne ou une valeur entière pour une propriété dans une liste prédéterminée de valeurs. Vous pouvez associer ce contrôle à une propriété en entrant le nom de la propriété dans la colonne Propriété de la table de contrôle . Spécifiez les valeurs possibles pour la sélection dans la colonne Valeur de la table RadioButton. Notez que la chaîne affichée n’est pas nécessairement la même que la valeur que l’utilisateur choisit.

Chaque contrôle RadioButtonGroup est associé à une propriété. La valeur par défaut de cette propriété doit être initialisée dans la table Property. Dans chaque RadioButtonGroup spécifié dans la table RadioButton, il peut y avoir une case d’option qui a une valeur dans le champ Valeur qui correspond à la valeur par défaut de cette propriété. Il s’agit du bouton par défaut du contrôle RadioButtonGroup. Le bouton par défaut s’affiche initialement comme sélectionné dans le contrôle.

Notez que le focus sur une boîte de dialogue ne peut pas se déplacer vers un contrôle RadioButtonGroup tant que l’un des boutons du groupe n’a pas été sélectionné. Pour déplacer le focus vers ce groupe de boutons, spécifiez l’un des boutons comme bouton par défaut pour le groupe.

Les contrôles RadioButtonGroup définissent uniquement les valeurs de propriété et ne peuvent pas être utilisés pour envoyer un ControlEvent.

L’implémentation traite l’ensemble du groupe comme un seul contrôle. Il n’est donc pas possible de masquer ou de désactiver des boutons individuels au sein du groupe. De même, tous les boutons doivent être du même style, autrement dit, tous ont du texte ou tous ont des bitmaps (ou d’autres fonctionnalités similaires). La position des boutons est créée par rapport au groupe. Ainsi, l’ensemble du groupe peut être déplacé en modifiant uniquement les coordonnées du groupe sans modifier les boutons individuels. Lors de la création, le contrôle vérifie que les boutons individuels ne s’étendent pas au-delà des limites du groupe.

Attributs de contrôle

Vous pouvez utiliser les attributs suivants avec ce contrôle. Pour modifier la valeur d’un attribut à l’aide d’un événement, abonnez-vous au contrôle à un ControlEvent dans la table EventMapping et répertoriez l’identificateur de l’attribut dans la colonne Attribut. Entrez l’identificateur de ControlEvent dans la colonne Événement.

Identificateur d’attribut Bit hexadécimal Description
indirectPropertyName Il s’agit du nom d’une propriété indirecte associée au contrôle. Si le bit d’attribut indirect est défini, le contrôle affiche ou modifie la valeur de la propriété portant ce nom. Si le bit d’attribut indirect est défini, ce nom est également la valeur de la propriété répertoriée dans la colonne Propriété de la table de contrôle .
position Position du contrôle dans la boîte de dialogue. Entrez la largeur, la hauteur et les coordonnées du contrôle dans les colonnes Width, Height, X et Y de la table contrôle . Utilisez unités d’installation pour la longueur et la distance.
PropertyName   Il s’agit du nom de la propriété associée à ce contrôle. Si le bit d’attribut indirect n’est pas défini, le contrôle affiche ou modifie la valeur de la propriété portant ce nom. Cet attribut est spécifié dans la colonne Propriété de la table de contrôle .
PropertyValue Valeur actuelle de la propriété affichée ou modifiée par ce contrôle. Si le bit d’attribut indirect n’est pas défini, il s’agit de la valeur de PropertyName. Si le bit d’attribut indirect est défini, il s’agit de la valeur indirectPropertyName. Si l’attribut change, le contrôle reflète la nouvelle valeur.
texte Cet attribut de contrôle peut spécifier le texte affiché par le contrôle, une image stockée dans la table binaire ou une image définie au moment de l’exécution. Pour spécifier du texte, entrez la chaîne de texte dans la colonne Texte de la table de contrôle . Pour définir la police et le style de police de ce texte, préfixez la chaîne de caractères affichés avec {\style} ou {&style}. Où le style est un identificateur répertorié dans la colonne TextStyle de la table TextStyle . Si aucun de ces éléments n’est présent, mais que la propriété DefaultUIFont est définie comme un style de texte valide, cette police sera utilisée.
Pour spécifier une icône ou une image bitmap stockée dans la table binaire entrez la clé primaire de l’enregistrement de l’image à partir de la colonne Name de la table Binaire dans la colonne Texte de la table de contrôle 'enregistrement du contrôle.
visible 0x00000000 0x00000001
Contrôle masqué. Contrôle visible.
Incluez ce bit dans le mot de bits de la colonne Attributs de la table de contrôle pour rendre le contrôle visible ou masqué lors de sa création.
Vous pouvez également masquer ou afficher un contrôle à l’aide de la table ControlCondition.
activé 0x00000000 0x00000002
Contrôle dans un état désactivé. Contrôle dans un état activé.
Incluez ce bit dans la colonne Attributs de l'Control pour activer le contrôle lors de la création.
Vous pouvez également activer ou désactiver un contrôle à l’aide de la table ControlCondition.
Sunken 0x00000000 0x00000004
Affiche le style visuel par défaut. Affiche le contrôle avec une apparence 3D enfoncée.
Incluez ces bits dans le mot de bits dans la colonne Attributs de la table de contrôle .
indirect 0x00000000 0x00000008
Le contrôle affiche ou modifie la valeur de la propriété dans la colonne Propriété de la table de contrôle . Le contrôle affiche ou modifie la valeur de la propriété qui a l’identificateur répertorié dans la colonne Propriété de la table De contrôle.
Détermine si la propriété associée à ce contrôle est référencée indirectement.
entier 0x00000000 0x00000010
La propriété associée au contrôle est une valeur de chaîne. La propriété associée au contrôle est une valeur entière.
Incluez ce bit dans le mot bit de la colonne Attributs de la table de contrôle pour définir cet attribut lors de la création du contrôle.
RTLRO 0x00000000 0x00000020
Le texte du contrôle s’affiche dans l’ordre de lecture de gauche à droite. Le texte du contrôle s’affiche dans l’ordre de lecture de droite à gauche.
aligné à droite 0x00000000 0x00000040
Le texte du contrôle est aligné à gauche. Le texte du contrôle est aligné à droite.
PushLike 0x00000000 0x00020000
Le contrôle est dessiné avec son apparence habituelle. Le contrôle a le style BS_PUSHLIKE et est dessiné pour apparaître sous la forme d’un bouton push.
Incluez ce bit dans le mot bit de la colonne Attributs de la table de contrôle pour définir cet attribut lors de la création du contrôle.
bitmap 0x00000000 0x00040000
Le texte du contrôle est spécifié dans la colonne Texte de la table de contrôle . Le contrôle a le style BS_BITMAP, le texte du contrôle est remplacé par une image bitmap. La colonne Texte de la table de contrôle est utilisée comme clé étrangère pour la table binaire .
Incluez ce bit dans le mot de bits dans la colonne Attributs de la table de contrôle .
Ne définissez pas simultanément les bits de style Icône et Bitmap. Le bouton ne peut pas contenir à la fois une image bitmap et du texte.
Pour définir la police et le style de police d’une chaîne de texte, préfixez la chaîne de caractères affichés avec {\style} ou {&style}. Où le style est un identificateur répertorié dans la colonne TextStyle de la table TextStyle . Si aucun de ces éléments n’est présent, mais que la propriété DefaultUIFont est définie comme un style de texte valide, cette police sera utilisée.
icône 0x00000000 0x00080000
Le texte du contrôle est spécifié dans la colonne Texte de la table de contrôle . Le contrôle a le style BS_ICON, le texte du contrôle est remplacé par une image d’icône. La colonne Texte de la table de contrôle est utilisée comme clé étrangère pour la table binaire .
Incluez ce bit dans le mot de bits dans la colonne Attributs de la table de contrôle .
Ne définissez pas simultanément les bits Icon et Bitmap. Le bouton ne peut pas contenir à la fois une image d’icône et du texte.
Pour définir la police et le style de police d’une chaîne de texte, préfixez la chaîne de caractères affichés avec {\style} ou {&style}. Où le style est un identificateur répertorié dans la colonne TextStyle de la table TextStyle . Si aucun de ces éléments n’est présent, mais que la propriété DefaultUIFont est définie comme un style de texte valide, cette police sera utilisée.
fixedSize 0x00000000 0x00100000
Étirez l’image d’icône pour ajuster le contrôle. Rognez ou centrez l’image d’icône dans le contrôle.
Incluez ce bit dans le mot de bits de la colonne Attributs de la table de contrôle .
IconSize 0x00000000 0x00200000
0x00400000
0x00600000
Charge la première image. Charge la première image 16 x 16.
Charge la première image 32 x 32.
Charge la première image 48 x 48.
Un fichier d’icône peut contenir différentes images de taille de la même icône. Incluez la valeur du mot de bits approprié dans la colonne Attributs de la table de contrôle
Si ces bits ne sont pas définis, le programme d’installation ignore l’attribut FixedSize et l’image est étirée pour s’adapter au rectangle de contrôle. Si les bits IconSize et Les bits FixedSize sont définis, une image plus petite que le contrôle est centrée et une image est plus grande que le contrôle qu’il est réduit à ajuster.
hasBorder non défini 0x01000000
Aucune bordure et aucun texte. Affiche la bordure et le texte.
Incluez 16777216 dans le mot bit dans la colonne Attributs de la Control pour afficher une bordure et un texte.

 

Remarques

En raison de la façon dont Windows dessine le cadre, il existe un écart entre la fenêtre du contrôle et le cadre visible, même s’il n’y a pas de légende.

Ce contrôle peut être créé à partir de la classe BUTTON à l’aide de la fonction CreateWindowEx. Si le bit HasBorder est défini, il a le style BS_GROUPBOX, sinon il a le style BS_OWNERDRAW.

Le contrôle RadioButtonGroup ne doit pas chevaucher d’autres contrôles et d’autres contrôles ne doivent pas chevaucher un RadioButtonGroup. Le chevauchement de ce contrôle et d’une autre peut entraîner la fonction ou l’affichage incorrect des contrôles. Pour fournir des programmes de lecteur d’écran avec du texte descriptif supplémentaire sur un contrôle RadioButtonGroup, suivez l’exemple fourni dans Ajout de texte supplémentaire aux cases d’option.