Contrôle RadioButtonGroup

Le contrôle RadioButtonGroup est un groupe de cases d’option. Elle permet à l’utilisateur de sélectionner une valeur de chaîne ou d’entier pour une propriété à partir d’une liste prédéfinie 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 des propriétés. Dans chaque RadioButtonGroup spécifié dans la table RadioButton, il peut y avoir une case d’option qui a une valeur dans le champ de valeur qui correspond à la valeur par défaut de cette propriété. Il s’agit du bouton par défaut pour le contrôle RadioButtonGroup. Le bouton par défaut est initialement affiché comme sélectionné dans le contrôle.

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

Les contrôles RadioButtonGroup ne peuvent définir que des 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. par conséquent, il n’est pas possible de masquer ou de désactiver des boutons individuels au sein du groupe. De même, tous les boutons doivent avoir le même style, c’est-à-dire qu’ils ont tous un texte ou tous ont des bitmaps (ou d’autres fonctionnalités similaires). La position des boutons est créée par rapport au groupe. De cette façon, le groupe entier 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 du 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 le contrôle à un ControlEvent, dans la table EventMapping et répertoriez l’identificateur de l’attribut dans la colonne d’attribut. Entrez l’identificateur du ControlEvent, dans la colonne d’é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é figurant 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 la largeur, la hauteur, le X et les colonnes Y de la table de contrôle. Utilisez les 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 de IndirectPropertyName. Si l’attribut change, le contrôle reflète la nouvelle valeur.
Text 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 de 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ù style est un identificateur figurant dans la colonne TextStyle de la table TextStyle. Si aucun de ces deux 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 text de l’enregistrement de la table de contrôle du contrôle.
Visible 0x00000000 0x00000001
Contrôle masqué. Contrôle visible.
Incluez ce bit dans le mot de bits de la colonne d’attributs dans 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 du contrôle 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 enfoncée, 3D et un look.
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 figurant 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.
Integer 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 de bits de la colonne d’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 est affiché dans l’ordre de lecture de gauche à droite. Le texte du contrôle est affiché dans l’ordre de lecture de droite à gauche.
RightAligned 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 s’afficher sous la forme d’un bouton de commande.
Incluez ce bit dans le mot de bits de la colonne d’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 text de la table Control. Le contrôle a le _ style de bitmap BS, le texte du contrôle est remplacé par une image bitmap. La colonne de texte dans 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 d’icône et de style 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, ajoutez le préfixe { \ style} ou {&style} à la chaîne de caractères affichés. Où style est un identificateur figurant dans la colonne TextStyle de la table TextStyle. Si aucun de ces deux 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 text de la table Control. Le contrôle a le _ style d’icône BS, le texte du contrôle est remplacé par une image icône. La colonne de texte dans 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 l’icône et les bits de l’image 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, ajoutez le préfixe { \ style} ou {&style} à la chaîne de caractères affichés. Où style est un identificateur figurant dans la colonne TextStyle de la table TextStyle. Si aucun de ces deux 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 l’ajuster au 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 d’attributs de la table de contrôle.
Icône de 0x00000000 0x00200000
0x00400000
0x00600000
Charge la première image. Charge la première image de 16x16.
Charge la première image 32 x 32.
Charge la première image 48.
Un fichier 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’ajuster au rectangle de contrôle. Si les bits d’icône et les bits FixedSize sont tous les deux définis, une image plus petite que le contrôle est centrée et une image est plus grande que le contrôle qu’elle doit ajuster.
HasBorder ne pas définir 0x01000000
Aucune bordure ni aucun texte. Affiche la bordure et le texte.
Incluez 16777216 dans le mot de bits de la colonne attributs du contrôle pour afficher une bordure et du texte.

Notes

en raison de la façon dont Windows dessine le frame, il y a un écart entre le haut de 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 de groupe de la série BS, 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 un autre peut entraîner la fonction ou l’affichage incorrect des contrôles. Pour fournir aux programmes de lecture d’écran un texte descriptif supplémentaire sur un contrôle RadioButtonGroup, suivez l’exemple fourni dans Ajout de texte supplémentaire aux cases d’option.