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é.