Table de Control
La table Control définit les contrôles qui s’affichent dans chaque boîte de dialogue.
La table Control présente 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 |
Hauteur | Integer | N | N |
Attributs | DoubleInteger | N | O |
Propriété | Identificateur | N | O |
Texte | Formatted | N | O |
Control_Next | Identificateur | N | O |
Aide | Texte | N | O |
Colonnes
-
Dialog_
-
Clé externe de la première colonne de la table Dialog, le nom de la boîte de dialogue.
-
Control
-
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_ constitue la clé primaire de cette table.
-
Type
-
Type du contrôle. Pour obtenir la liste des types de contrôles, consultez Controls.
-
X
-
Coordonnée horizontale du coin supérieur gauche de la délimitation rectangulaire du contrôle. Il doit s’agir d’un nombre non négatif. Consultez Attribut de contrôle de position.
-
Y
-
Coordonnée verticale du coin supérieur gauche de la délimitation rectangulaire du contrôle. Il doit s’agir d’un nombre non négatif. Consultez Attribut de contrôle de position.
-
Largeur
-
Largeur de la délimitation rectangulaire du contrôle. Il doit s’agir d’un nombre non négatif. Consultez Attribut de contrôle de position.
-
hauteur
-
Hauteur de la délimitation rectangulaire du contrôle. Il doit s’agir d’un nombre non négatif. Consultez Attribut de contrôle de position.
-
Attributs
-
Un mot de 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 à saisir dans ce champ, consultez Attributs de contrôle.
-
Propriété
-
Nom d’une propriété définie à associer à ce contrôle. Les valeurs de la case d’option, de la zone de liste et de la zone de liste modifiable sont liées à un groupe en étant associées à la même propriété. Cette colonne est requise pour les contrôles actifs.
-
Texte
-
Une 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 obtenir 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 par {\style}, où style est un style de texte créé dans la colonne TextStyle de la table TextStyle. La chaîne de texte est tronquée si elle est trop longue pour tenir dans le contrôle. La chaîne de texte peut être vide.
Une création spéciale de la chaîne de texte mis 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 avec l’attribut TrackDiskpace. C’est le cas spécifié par le bit de style de boîte de dialogue TrackDiskSpace qui apparaît dans les attributs de la table Dialog. Dans ce cas, si la chaîne mise en forme dans la colonne Text de la table Control 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é qui sera 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 de Texte.
Vous pouvez saisir une courte chaîne de texte descriptif pour les contrôles VolumeCostList, ListView, DirectoryList et SelectionTree. Ce texte n’est pas vu par l’utilisateur, mais il peut être lu par les lecteurs d’écran comme la description du contrôle.
Consultez aussi Accessibilité.
-
Control_Next
-
Le nom d’un autre contrôle dans la même boîte de dialogue et une clé externe de la deuxième colonne de la table Control. Si le focus de la boîte de dialogue se trouve sur le contrôle dans la colonne Contrôle, le fait d’appuyer sur la touche tabulation déplace 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 de 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 statiques, peuvent être laissés hors du cycle. Dans ce cas, ce champ peut être laissé vide.
Consultez aussi Accessibilité.
-
Aide
-
Chaînes de texte localisables facultatives qui sont utilisées avec le bouton Aide. La chaîne est divisée en deux parties par un caractère séparateur (|). 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 contenant une image. La deuxième partie de la chaîne est réservée pour une utilisation ultérieure. 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.
Validation