Text Control

Le contrôle de 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 seule ligne situés en dessous. Les séquences de caractères \ n, \ r \ n ou \ n \ r dans le champ de texte du contrôle ne s’affichent pas sous la forme d’un saut de ligne. Ces séquences de caractères sont littéralement affichées par le contrôle.

Attributs du 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 d’attribut. Entrez l’identificateur du ControlEvent, dans la colonne d’événement.

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 la largeur, la hauteur, le X et les colonnes Y de la table de contrôle ou de la table BBControl. Utilisez les unités d’installation pour la longueur et la distance.
Text Texte affiché par le contrôle. Pour définir la police et le style de police d’une chaîne de texte, ajoutez le préfixe { \ style} ou {&style} à la chaîne de caractères affichés. Où style est un identificateur figurant dans la colonne TextStyle de la table TextStyle. Si aucun de ces deux n’est présent, mais que la propriété DefaultUIFont est définie comme un style de texte valide, cette police sera utilisée.
TimeRemaining Cet attribut permet à un contrôle de texte d’afficher le nombre approximatif de minutes et de secondes restantes pour une installation. Abonnez le contrôle de texte au ControlEvent, TimeRemaining dans la table EventMapping et entrez TimeRemaining dans la colonne d’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 clé. Entrez une chaîne de texte mise en forme dans la colonne de texte créée pour afficher les minutes et les secondes. Mettez en forme cette chaîne comme décrit pour MsiFormatRecord.
Visible 0x00000000 0x00000001
Contrôle masqué. Contrôle visible.
Incluez ce bit dans le mot de bits de la colonne d’attributs dans la table de contrôle ou la table BBControl. pour rendre le contrôle visible ou masqué lors de 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 de la colonne attributs 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 une apparence enfoncée, 3D et un look.
Incluez ces bits dans le mot de bits dans la colonne attributs de la table de contrôle.
RTLRO 0x00000000 0x00000020
Le texte du contrôle est affiché dans l’ordre de lecture de gauche à droite. Le texte du contrôle est affiché 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.
Transparente 0x00000000 0x00010000
Contrôle opaque. Arrière-plan montre le contrôle. Le contrôle a le _ _ style transparent WS.
Incluez ce bit dans la colonne attributs des tables Control ou BBControl.
Préfixe 0x00000000 0x00020000
Utilisez & dans une chaîne de texte pour afficher le caractère suivant sous la forme d’un trait de soulignement. Le caractère & dans une chaîne s’affiche comme lui-même.
Incluez ce bit dans le mot de bits dans la colonne attributs des tables Control ou BBControl.
NoWrap 0x00000000 0x00040000
Le texte est renvoyé à la ligne. Le texte est affiché sur une seule ligne. Si le texte s’étend au-delà des marges du contrôle, il est coupé et des points de suspension (« ... ») sont insérés.
Incluez ce bit dans le mot de bits dans la colonne attributs 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 codes de l’interface utilisateur par défaut de l’utilisateur.
Formater l’attribut de contrôle 0x00000000 0x00080000
Mise 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 appropriée, 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 sera 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 statique à l’aide de la fonction CreateWindowEx . Il possède les styles SS _ gauche, WS _ Child et WS _ Group .

Ne placez pas de contrôles de texte transparent par-dessus les bitmaps de couleur. Le texte peut ne pas être visible si l’utilisateur modifie le modèle 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é.