Text Control

Le contrôle Texte affiche du texte statique, qui peut utiliser un style prédéfini.

La méthode recommandée pour afficher du texte avec des sauts de ligne spécifiés consiste à utiliser plusieurs contrôles de texte d’une ligne situés l’un sous l’autre. Les séquences de caractères \n, \r\n ou \n\r dans le champ de texte du contrôle ne sont pas affichées sous forme de saut de ligne. Ces séquences de caractères sont affichées littéralement par le contrôle.

Attributs de contrôle

Vous pouvez utiliser les attributs suivants avec le contrôle Text. Pour modifier la valeur d’un attribut à l’aide d’un événement, abonnez le contrôle à un ControlEvent dans la table EventMapping, et répertoriez l’identificateur de l’attribut dans la colonne Attribut. Entrez l’identificateur de ControlEvent dans la colonne Event.

Identificateur d’attribut	Bit hexadécimal	Description
Position		Position du contrôle dans la boîte de dialogue. Entrez la largeur, la hauteur et les coordonnées du contrôle dans le coin gauche du contrôle dans les colonnes Width, Height, X et Y de la table Control ou BBControl. Utilisez les unités du programme d’installation pour la longueur et la distance.
Texte		Texte affiché par le contrôle. Pour définir la police et le style de police d’une chaîne de texte, préfixez la chaîne des caractères affichés avec {\style} ou {&style}. Où style est un identificateur répertorié dans la colonne TextStyle de la table TextStyle. Si aucun de ces éléments n’est présent, mais que la propriété DefaultUIFont est définie comme un style de texte valide, cette police est utilisée.
TimeRemaining		Cet attribut permet à un contrôle Text d’afficher le nombre approximatif restant de minutes et de secondes pour une installation. Abonnez le contrôle Text à l’événement ControlEvent TimeRemaining dans la table EventMapping et entrez TimeRemaining dans la colonne Attribut. Le programme d’installation publie un enregistrement contenant un entier représentant le nombre de secondes restantes dans l’installation. Incluez une ligne dans la table UIText avec TimeRemaining dans la colonne Key. Entrez une chaîne de texte mise en forme dans la colonne Text créée pour afficher les minutes et les secondes. Mettez cette chaîne en forme comme décrit pour MsiFormatRecord.
Visible	0x00000000 0x00000001	Contrôle masqué. Contrôle visible. Ajoutez ce bit dans le mot bit de la colonne Attributes de la table Control ou la table BBControl pour que le contrôle soit visible ou masqué pendant sa création. Vous pouvez également masquer ou afficher un contrôle à l’aide de la table ControlCondition.
Activé	0x00000000 0x00000002	Contrôle dans un état désactivé. Contrôle dans un état activé. Incluez ce bit dans le mot de bits dans la colonne Attributes des tables Control ou BBControl pour activer le contrôle lors de la création. Vous pouvez également activer ou désactiver un contrôle à l’aide de la table ControlCondition.
Sunken	0x00000000 0x00000004	Affiche le style visuel par défaut. Affiche le contrôle avec un aspect 3D enfoncé. Incluez ces bits dans le mot bit dans la colonne Attributes de la table Control.
RTLRO	0x00000000 0x00000020	Le texte du contrôle s’affiche dans l’ordre de lecture de gauche à droite. Le texte du contrôle s’affiche dans l’ordre de lecture de droite à gauche.
RightAligned	0x00000000 0x00000040	Le texte du contrôle est aligné à gauche. Le texte du contrôle est aligné à droite.
Mode transparent	0x00000000 0x00010000	Contrôle opaque. L’arrière-plan s’affiche via le contrôle. Le contrôle a le style WS_EX_TRANSPARENT. Incluez ce bit dans la colonne Attributes des tables Control ou BBControl.
NoPrefix	0x00000000 0x00020000	Utilisez & dans une chaîne de texte pour afficher le caractère suivant comme souligné. Le caractère & d’une chaîne s’affiche lui-même. Incluez ce bit dans le mot de bits dans la colonne Attributes des tables Control ou BBControl.
NoWrap	0x00000000 0x00040000	Habillages de texte. Le texte s’affiche sur une seule ligne. Si le texte s’étend au-delà des marges du contrôle, il est coupé et une sélection (« ... ») est insérée. Incluez ce bit dans le mot de bits dans la colonne Attributes des tables Control ou BBControl.
UsersLanguage	0x00000000 0x00100000	Polices créées dans la page de codes de la base de données. Polices créées dans la page de code de l’interface utilisateur par défaut de l’utilisateur.
Attribut de contrôle FormatSize	0x00000000 0x00080000	Mis en forme en tant que texte. Si ce bit est défini, le contrôle tente de mettre en forme le texte affiché sous la forme d’un nombre représentant un nombre d’octets. Pour une mise en forme correcte, le texte du contrôle doit être défini sur une chaîne représentant un nombre exprimé en unités de 512 octets. La valeur affichée est ensuite mise en forme en kilo-octets (Ko), mégaoctets (Mo) ou gigaoctets (Go) et affichée avec la chaîne appropriée représentant les unités.

 

Notes

Ce contrôle peut être créé à partir de la classe STATIC à l’aide de la fonction CreateWindowEx. Il a les styles SS_LEFT, WS_CHILD et WS_GROUP.

Ne placez pas de contrôles texte transparents au-dessus des bitmaps colorées. Le texte peut ne pas être visible si l’utilisateur modifie le jeu de couleurs d’affichage. Par exemple, le texte peut devenir invisible si l’utilisateur définit le paramètre de contraste élevé pour des raisons d’accessibilité.