Table de contrôles
La table Contrôle définit les contrôles qui s’affichent dans chaque boîte de dialogue.
La table Control contient les colonnes suivantes.
| Colonne | Type | Clé | Nullable |
|---|---|---|---|
| Dialog_ | Identificateur | O | N |
| Control | Identificateur | O | N |
| Type | Identificateur | N | N |
| X | Integer | N | N |
| O | Integer | N | N |
| Largeur | Integer | N | N |
| Height | Integer | N | N |
| Attributs | DoubleInteger | N | O |
| Propriété | Identificateur | N | O |
| Texte | Formaté | N | O |
| Control_Next | Identificateur | N | O |
| Aide | Text | N | O |
Colonnes
-
Dialog_
-
Clé externe à la première colonne de la table dialogue, nom de la boîte de dialogue.
-
Contrôle
-
Nom du contrôle. Ce nom doit être unique dans une boîte de dialogue, mais peut être répété dans différentes boîtes de dialogue. La colonne Control combinée à la colonne Dialog_ forme la clé primaire de cette table.
-
Type
-
Type du contrôle. Pour obtenir la liste des types de contrôles, consultez Contrôles.
-
X
-
Coordonnée horizontale du coin supérieur gauche de la limite rectangulaire du contrôle. Il doit s’agir d’un nombre non négatif. Voir l’attribut De contrôle position.
-
Y
-
Coordonnée verticale du coin supérieur gauche de la limite rectangulaire du contrôle. Il doit s’agir d’un nombre non négatif. Voir l’attribut De contrôle position.
-
Largeur
-
Largeur de la limite rectangulaire du contrôle. Il doit s’agir d’un nombre non négatif. Voir l’attribut De contrôle position.
-
Hauteur
-
Hauteur de la limite rectangulaire du contrôle. Il doit s’agir d’un nombre non négatif. Voir l’attribut De contrôle position.
-
Attributs
-
Mot 32 bits qui spécifie les indicateurs de bits à appliquer à ce contrôle. Il doit s’agir d’un nombre non négatif, et les valeurs autorisées dépendent du type de contrôle. Pour obtenir la liste de tous les attributs de contrôle et la valeur à entrer dans ce champ, consultez Attributs de contrôle.
-
Propriété
-
Nom d’une propriété définie à lier à ce contrôle. Les valeurs de case d’option, de zone de liste et de zone de liste modifiable sont liées à un groupe en étant liées à la même propriété. Cette colonne est requise pour les contrôles actifs.
-
Texte
-
Chaîne localisable utilisée pour définir le texte initial contenu dans un contrôle. La chaîne peut également contenir des propriétés incorporées. Pour connaître la syntaxe d’une chaîne mise en forme contenant des propriétés, consultez la fonction MsiFormatRecord . Spécifiez la taille, la police et la couleur du texte en préfixant la chaîne de texte avec {\style}, où le style est un style de texte créé dans la colonne TextStyle du tableau TextStyle. La chaîne de texte est tronquée si elle est trop longue pour tenir sur le contrôle. La chaîne de texte peut être vide.
La création spéciale de la chaîne de texte mise en forme dans ce champ est requise si le texte doit être affiché par un contrôle de texte situé dans une boîte de dialogue ayant l’attribut TrackDiskpace. Il s’agit du cas spécifié par le bit de style de dialogue TrackDiskSpace qui apparaît dans les attributs de la table dialogue. Dans ce cas, si la chaîne mise en forme dans la colonne Texte de la table contrôle commence par « [ » et se termine par « ] », vous devez ajouter un espace à la fin de la chaîne. Par exemple, si DlgTextFont est une propriété définie sur « {\DlgFontBold} », la chaîne mise en forme « [DlgTextFont]MyText[ProductName] » nécessite l’espace à la fin après le crochet fermant. Cet espace supplémentaire est requis par le programme d’installation pour afficher correctement le texte dans le contrôle Texte.
Vous pouvez entrer une courte chaîne de texte descriptif pour les contrôles VolumeCostList, ListView, DirectoryList et SelectionTree. Ce texte n’est pas visible par l’utilisateur, mais il peut être lu par les lecteurs d’écran comme description du contrôle.
Voir aussi Accessibilité.
-
Control_Next
-
Nom d’un autre contrôle dans la même boîte de dialogue et une clé externe à la deuxième colonne de la table Contrôle. Si le focus dans la boîte de dialogue se trouve sur le contrôle de la colonne Contrôle, appuyez sur la touche Tab pour déplacer le focus sur le contrôle répertorié dans la colonne Control_Next. Par conséquent, cette colonne est utilisée pour spécifier l’ordre de tabulation des contrôles dans la boîte de dialogue. Les liens entre les contrôles doivent former un cycle fermé. Certains contrôles, tels que les contrôles de texte statique, peuvent être laissés hors du cycle. Dans ce cas, ce champ peut être vide.
Voir aussi Accessibilité.
-
Aide
-
Chaînes de texte localisables facultatives utilisées avec le bouton Aide. La chaîne est divisée en deux parties par un caractère de séparation (|). La première partie de la chaîne est utilisée comme texte d’info-bulle. Ce texte est utilisé par les lecteurs d’écran pour les contrôles qui contiennent une image. La deuxième partie de la chaîne est réservée à une utilisation ultérieure. Le caractère de séparation est requis même si l’un des deux types de texte est présent.
Notes
Les valeurs entières pour x, y, width et height se trouvent dans les unités du programme d’installation, et non dans les unités de boîte de dialogue. Une unité d’installation est égale à une douzième hauteur de la taille de police MS Sans Serif de 10 points. Les coordonnées des contrôles sont relatives au panneau d’affichage.
Validation