Table de contrôle

La table de contrôle définit les contrôles qui apparaissent dans chaque boîte de dialogue.

La table de contrôle contient les colonnes suivantes.

Colonne Type Clé Nullable
Dialogue_ 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 Correct N O
Contrôle _ suivant Identificateur N O
Aide Text N O

Colonnes

Dialogue_

Clé externe de la première colonne de la table de boîte de dialogue, nom de la boîte de dialogue.

Régulation

Nom du contrôle. Ce nom doit être unique dans une boîte de dialogue, mais il peut être répété dans différentes boîtes de dialogue. La colonne de contrôle associée à la _ colonne de boîte de dialogue forment la clé primaire de cette table.

Entrer

Type du contrôle. Pour obtenir la liste des types de contrôle, consultez contrôles.

X

Coordonnée horizontale de l’angle supérieur gauche de la limite 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 de l’angle supérieur gauche de la limite 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 limite rectangulaire du contrôle. Il doit s’agir d’un nombre non négatif. Consultez attribut de contrôle de position.

Celle

Hauteur de la limite rectangulaire du contrôle. Il doit s’agir d’un nombre non négatif. Consultez attribut de contrôle de position.

Attributs

Un mot 32 bits qui spécifie les indicateurs binaires à 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 du contrôle.

Propriété

Nom d’une propriété définie à lier à ce contrôle. La case d’option, la zone de liste et les valeurs de zone de liste déroulante sont liées à un groupe en étant liées à la même propriété. Cette colonne est requise pour les contrôles actifs.

Financière

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 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 ajoutant un préfixe à la chaîne de texte { \ 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 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 obligatoire 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 la 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 de 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é qui est définie sur « { \ DlgFontBold} », la chaîne mise en forme « [ DlgTextFont ] mytext [ ProductName ] » requiert 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 entrer une brève chaîne de texte descriptive pour les contrôles VolumeCostList, ListView, DirectoryListet 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é.

Contrôle _ suivant

Nom d’un autre contrôle dans la même boîte de dialogue et une clé externe pour la deuxième colonne de la table de contrôle. Si le focus dans la boîte de dialogue se trouve sur le contrôle dans la colonne de contrôle, le fait d’appuyer sur la touche Tab déplace le focus sur le contrôle figurant dans la _ colonne contrôle suivant. 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 omis du cycle. Dans ce cas, ce champ peut être laissé vide.

Voir aussi accessibilité.

Aide

Chaînes de texte localisables et facultatives qui sont 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 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 un seul des deux genres de texte est présent.

Notes

Les valeurs entières de x, y, Width et Height se trouvent dans les unités d’installation, et non dans les unités de boîte de dialogue. Une unité d’installation est égale à 1 douzième la hauteur de la taille de police MS sans serif à 10 points. Les coordonnées des contrôles sont relatives au panneau.

Validation

ICE03
ICE06
ICE17
ICE20
ICE23
ICE31
ICE32
ICE34
ICE45
ICE46
ICE95