Partager via


Table RadioButton

Les cases d’option ne sont pas traitées comme des contrôles individuels, mais elles font partie d’un groupe de cases d’option qui fonctionne comme un contrôle RadioButtonGroup. La table RadioButton répertorie les cases de tous les groupes.

La table RadioButton a les colonnes suivantes :

Colonne Type Clé Nullable
Propriété Identificateur O N
JSON Integer O N
Valeur Formatted N N
X Integer N N
O Integer N N
Largeur Integer N N
Hauteur Integer N N
Texte Formatted N O
Aide Texte N O

 

Colonnes

Propriété

Une propriété nommée à attacher à cette case d’option. Toutes les cases liées à la même propriété font partie du même groupe.

Ordre

Un entier positif utilisé pour déterminer l’ordre des éléments au sein d’une liste. Les entiers n’ont pas besoin d’être consécutifs.

Valeur

La chaîne de valeur associée à cette case. La sélection de la case définit la propriété associée à cette valeur.

X

La coordonnée horizontale dans le groupe du coin supérieur gauche du rectangle englobant de la case d’option. Il doit s’agir d’un nombre non négatif.

Y

La coordonnée verticale dans le groupe du coin supérieur gauche du rectangle englobant de la case d’option. Il doit s’agir d’un nombre non négatif.

Largeur

Largeur du bouton. Il doit s’agir d’un nombre non négatif.

Hauteur

Hauteur du bouton. Il doit s’agir d’un nombre non négatif.

Texte

Le titre visible localisable à affecter à la case d’option. Si le texte est trop long pour être ajusté sur le contrôle, il est tronqué. Si la case affiche une icône ou une bitmap, cette colonne contient le nom de l’image, qui est une clé dans la table Binary. Il n’existe aucun moyen d’afficher à la fois une image et du texte sur une case.

Aide

Les chaînes d’aide utilisées avec la case. Le texte est facultatif et localisable. La chaîne est divisée en deux parties séparées par un caractère (|). La première partie de la chaîne est utilisée comme texte d’info-bulle. Ce texte est affiché par les lecteurs d’écran pour les contrôles qui contiennent une image. La deuxième partie est utilisée pour l’aide contextuelle, bien qu’elle n’ait pas encore été implémentée. Le caractère séparateur est requis même si un seul des deux types de texte est présent.

Notes

Les valeurs entières de x, y, width et height sont exprimées en unités du programme d’installation, et non en unités de boîte de dialogue. Une unité de programme d’installation est égale à un douzième de la hauteur de la taille de police MS Sans Serif à 10 points. Les coordonnées des contrôles sont relatives au panneau d’affichage.

Les coordonnées des cases sont fournies par rapport au groupe. Si les coordonnées du groupe sont modifiées, les cases au sein du groupe restent à la même position relative les unes par rapport aux autres.

Le contenu des champs Valeur et Texte est mis en forme par la fonction MsiFormatRecord lors de la création du contrôle. Ils peuvent donc contenir n’importe quelle expression que la fonction MsiFormatRecord peut interpréter. La mise en forme se produit uniquement lorsque le contrôle est créé et elle n’est pas mise à jour si une propriété impliquée dans l’expression est modifiée pendant la durée de vie du contrôle.

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 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 Valeur qui correspond à la valeur par défaut de cette propriété. Il s’agit de la case par défaut du contrôle RadioButtonGroup. La case par défaut est initialement affichée comme sélectionnée dans le contrôle.

Notez que l’utilisateur ne peut pas modifier le focus dans une boîte de dialogue en appuyant sur la touche TAB pour accéder à un contrôle RadioButtonGroup tant que l’une des cases du groupe n’a pas été sélectionnée. Pour que le focus se déplace vers ce groupe de cases en appuyant sur la touche TAB, spécifiez l’une des cases comme case par défaut pour le groupe.

Validation

ICE03
ICE06
ICE17
ICE34
ICE46