Freigeben über


Textsteuerelement

Das Text-Steuerelement zeigt statischen Text an, der möglicherweise eine vordefinierte Formatvorlage verwendet.

Die empfohlene Methode zum Anzeigen von Text mit angegebenen Zeilenumbrüchen besteht darin, mehrere einzeilige Textsteuerelemente untereinander zu verwenden. Die Zeichensequenzen \n, \r\noder \n\r im Textfeld für das Steuerelement werden nicht als Zeilenumbruch angezeigt. Diese Zeichensequenzen werden buchstäblich vom Steuerelement angezeigt.

Steuerelementattribute

Sie können die folgenden Attribute mit dem Text-Steuerelement verwenden. Um den Wert eines Attributs mithilfe eines Ereignisses zu ändern, abonnieren Sie das Steuerelement in der EventMapping-Tabelle und listen Sie den Bezeichner des Attributs in der Attributspalte auf. Geben Sie den Bezeichner des ControlEvent in der Spalte "Ereignis" ein.

Attributkennzeichen Hexadezimales Bit Beschreibung
Position Position des Steuerelements im Dialogfeld. Geben Sie die Breite, Höhe und Koordinaten der linken Ecke des Steuerelements in die Spalten "Breite", "Höhe", "X" und "Y" der Steuerelementtabelle oder BBControl-Tabelleein. Verwenden Sie Installationseinheiten für Länge und Entfernung.
Text, der vom Steuerelement angezeigt wird. Um die Schriftart und den Schriftschnitt einer Textzeichenfolge festzulegen, präfixen Sie die Zeichenfolge der angezeigten Zeichen mit {\style} oder {&style}. Dabei handelt es sich bei der Formatvorlage um einen Bezeichner, der in der Spalte "TextStyle" der TextStyle-Tabelleaufgeführt ist. Wenn keine dieser Eigenschaften vorhanden ist, aber die DefaultUIFont--Eigenschaft als gültige Textformatvorlage definiert ist, wird diese Schriftart verwendet.
TimeRemaining- Mit diesem Attribut kann ein Text-Steuerelement die ungefähre Anzahl von Minuten und Sekunden anzeigen, die für eine Installation verbleiben. Abonnieren Sie das Text-Steuerelement für das TimeRemaining ControlEvent- in der Eventmapping-Tabelle und geben Sie "TimeRemaining" in die Spalte "Attribut" ein.
Das Installationsprogramm veröffentlicht einen Datensatz, der eine ganze Zahl enthält, die die In der Installation verbleibende Anzahl von Sekunden darstellt. Fügen Sie eine Zeile in die UIText-Tabelle mit TimeRemaining in die Spalte "Schlüssel" ein. Geben Sie eine formatierte Textzeichenfolge in die Textspalte ein, die erstellt wurde, um Minuten und Sekunden anzuzeigen. Formatieren Sie diese Zeichenfolge wie für MsiFormatRecordbeschrieben.
Sichtbaren 0x00000000 0x00000001
Ausgeblendetes Steuerelement. Sichtbares Steuerelement.
Fügen Sie dieses Bit in das Bitwort der Spalte "Attribute" in die Steuerelementtabelle oder BBControl-Tabelle ein,., um das Steuerelement bei der Erstellung sichtbar oder ausgeblendet zu machen.
Sie können ein Steuerelement auch mithilfe der ControlCondition-Tabelleausblenden oder anzeigen.
Aktivierte 0x00000000 0x00000002
Steuerelement in einem deaktivierten Zustand. Steuerelement in einem aktivierten Zustand.
Fügen Sie dieses Bit in das Bitwort in die Spalte "Attribute" des Steuerelements oder BBControl-Tabellen ein,, um das Steuerelement beim Erstellen zu aktivieren.
Sie können ein Steuerelement auch mithilfe der ControlCondition-Tabelleaktivieren oder deaktivieren.
sunken 0x00000000 0x00000004
Zeigt den standardmäßigen visuellen Stil an. Zeigt das Steuerelement mit einem versonnenen, 3D-Look an.
Fügen Sie diese Bits in das Bitwort in die Spalte "Attribute" der Steuerelementtabelleein.
RTLRO- 0x00000000 0x00000020
Text im Steuerelement wird in leserichtung von links nach rechts angezeigt. Text im Steuerelement wird in leserichtung von rechts nach links angezeigt.
RightAligned- 0x00000000 0x00000040
Text im Steuerelement wird linksbündig ausgerichtet. Text im Steuerelement wird rechtsbündig ausgerichtet.
Transparente 0x00000000 0x00010000
Undurchsichtiges Steuerelement. Der Hintergrund wird durch Steuerelement angezeigt. Das Steuerelement weist die WS_EX_TRANSPARENT Formatvorlage auf.
Schließen Sie dieses Bit in die Spalte "Attribute" der Control oder BBControl-Tabellenein.
NoPrefix- 0x00000000 0x00020000
Verwenden Sie & in einer Textzeichenfolge, um das nächste Zeichen als Unterstrich anzuzeigen. Das Zeichen & in einer Zeichenfolge wird als selbst angezeigt.
Fügen Sie dieses Bit in das Bitwort in die Spalte "Attribute" des Steuerelements oder BBControl-Tabellen.
NoWrap 0x00000000 0x00040000
Textumbruch. Text wird in einer einzelnen Zeile angezeigt. Wenn der Text über die Ränder des Steuerelements hinausgeht, wird er abgeschnitten und eine Auslassungspunkte ("...") eingefügt.
Fügen Sie dieses Bit in das Bitwort in die Spalte "Attribute" des Steuerelements oder BBControl-Tabellen.
UsersLanguage 0x00000000 0x00100000
Schriftarten, die auf der Datenbankcodeseite erstellt wurden. Schriftarten, die auf der Standard-UI-Codeseite des Benutzers erstellt wurden.
FormatSize Control Attribute 0x00000000 0x00080000
Als Text formatiert. Wenn dieses Bit festgelegt ist, versucht das Steuerelement, den angezeigten Text als Zahl zu formatieren, die eine Anzahl von Bytes darstellt. Für die ordnungsgemäße Formatierung muss der Text des Steuerelements auf eine Zeichenfolge festgelegt werden, die eine Zahl darstellt, die in Einheiten von 512 Byte ausgedrückt wird. Der angezeigte Wert wird dann in Bezug auf Kilobyte (KB), Megabyte (MB) oder Gigabyte (GB) formatiert und mit der entsprechenden Zeichenfolge angezeigt, die die Einheiten darstellt.

 

Bemerkungen

Dieses Steuerelement kann mithilfe der CreateWindowEx--Funktion aus der STATIC-Klasse erstellt werden. Es verfügt über die Formatvorlagen SS_LEFT, WS_CHILDund WS_GROUP.

Platzieren Sie transparente Textsteuerelemente nicht auf farbigen Bitmaps. Der Text ist möglicherweise nicht sichtbar, wenn der Benutzer das Anzeigefarbschema ändert. Beispielsweise kann Text unsichtbar werden, wenn der Benutzer den Parameter für hohen Kontrast aus Gründen der Barrierefreiheit festlegt.