Table de Control

  • Article

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

ICE03
ICE06
ICE17
ICE20
ICE23
ICE31
ICE32
ICE34
ICE45
ICE46
ICE95