Text Control

Vom Textsteuerelement wird statischer Text angezeigt, für den möglicherweise eine vordefinierte Formatvorlage verwendet wird.

Die empfohlene Methode zum Anzeigen von Text mit angegebenen Zeilenumbrüchen besteht darin, mehrere einzeilige Textsteuerelemente zu verwenden, die sich untereinander befinden. Die Zeichenfolgen \n, \r\n oder \n\r im Textfeld für das Steuerelement werden nicht als Zeilenumbruch angezeigt. Diese Zeichenfolgen werden vom Steuerelement buchstabengetreu angezeigt.

Steuerelementattribute

Sie können bei dem Textsteuerelement die folgenden Attribute verwenden. Abonnieren Sie mit dem Steuerelement ein ControlEvent in der Tabelle EventMapping, und listen Sie den Bezeichner des Attributs in der Spalte „Attribute“ auf, um den Wert eines Attributs mit einem Ereignis zu ändern. Geben Sie den Bezeichner von ControlEvent in die Spalte Ereignis ein.

Attributbezeichner	Hexadezimales Bit	BESCHREIBUNG
Position		Position des Steuerelements im Dialogfeld. Geben Sie Breite, Höhe und Koordinaten der linken Ecke des Steuerelements in die Spalten „Width“, „Height“, „X“ und „Y“ der Tabelle Control oder der Tabelle BBControl ein. Verwenden Sie Installationseinheiten für Länge und Abstand.
Text		Vom Steuerelement angezeigter Text. Stellen Sie zum Festlegen der Schriftart und des Schriftstils einer Textzeichenfolge der Zeichenfolge der angezeigten Zeichen das Präfix {\style} oder {&style} voran. Dabei ist style ein Bezeichner, der in der Spalte TextStyle der Tabelle TextStyle aufgeführt ist. Wenn keines dieser Elemente vorhanden ist, aber die Eigenschaft DefaultUIFont als gültiger Textstil definiert ist, wird diese Schriftart verwendet.
TimeRemaining		Dieses Attribut ermöglicht es einem Textsteuerelement, die ungefähre Anzahl von Minuten und Sekunden anzuzeigen, die für eine Installation übrig bleiben. Abonnieren Sie das Textsteuerelement für das ControlEvent TimeRemaining in der Tabelle „Eventmapping“, und geben Sie TimeRemaining in die Attributspalte ein. Vom Installationsprogramm wird ein Datensatz veröffentlicht, der eine ganze Zahl enthält, die die Anzahl der verbleibenden Sekunden in der Installation darstellt. Fügen Sie eine Zeile in die UIText-Tabelle mit TimeRemaining in die Schlüsselspalte 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 MsiFormatRecord beschrieben.
Visible	0x00000000 0x00000001	Ausgeblendetes Steuerelement. Sichtbares Steuerelement. Um das Steuerelement bei der Erstellung anzuzeigen oder auszublenden, fügen Sie dieses Bit in das Bitwort der Spalte „Attributes“ in der Tabelle Control oder der Tabelle BBControl ein. Sie können ein Steuerelement auch anzeigen oder ausblenden, indem Sie die ControlCondition-Tabelle verwenden.
Aktiviert	0x00000000 0x00000002	Steuerelement in einem deaktivierten Zustand. Steuerelement ist aktiviert. Fügen Sie dieses Bit in das Bitwort in der Spalte „Attributes“ der Tabelle Control oder BBControl ein, um dieses Steuerelement bei der Erstellung zu aktivieren. Sie können ein Steuerelement auch mit der Tabelle „ControlCondition“ aktivieren oder deaktivieren.
Sunken	0x00000000 0x00000004	Zeigt den standardmäßigen visuellen Stil an. Zeigt das Steuerelement mit einem vertieften 3D-Look an. Fügen Sie diese Bits in das Bitwort in die Spalte „Attributes“ der Tabelle „Control“ ein.
RTLRO	0x00000000 0x00000020	Text im Steuerelement wird in der Leserichtung von links nach rechts angezeigt. Text im Steuerelement wird in der Leserichtung von rechts nach links angezeigt.
RightAligned	0x00000000 0x00000040	Text im Steuerelement wird links ausgerichtet. Text im Steuerelement wird rechts ausgerichtet.
Transparent	0x00000000 0x00010000	Nicht transparentes Steuerelement. Hintergrund ist durch das Steuerelement hindurch sichtbar. Das Steuerelement weist den Stil WS_EX_TRANSPARENT auf. Fügen Sie dieses Bit in die Spalte „Attributes“ der Tabelle Control oder BBControl ein.
NoPrefix	0x00000000 0x00020000	Verwenden Sie & in einer Textzeichenfolge, um das nächste Zeichen unterstrichen anzuzeigen. Das Zeichen & in einer Zeichenfolge wird als sich selbst angezeigt. Fügen Sie dieses Bit in das Bitwort in die Spalte „Attributes“ der Tabelle Control oder BBControl ein.
NoWrap	0x00000000 0x00040000	Textumbrüche. Text wird in einer einzelnen Zeile angezeigt. Wenn der Text über die Ränder des Steuerelements hinausgeht, wird er abgeschnitten, und es werden Auslassungspunkte („…“) eingefügt. Fügen Sie dieses Bit in das Bitwort in die Spalte „Attributes“ der Tabelle Control oder BBControl ein.
UsersLanguage	0x00000000 0x00100000	In der Codepage der Datenbank erstellte Schriftarten. In der Codepage der Standardbenutzeroberfläche des Benutzers erstellte Schriftarten.
FormatSize-Steuerelementattribut	0x00000000 0x00080000	Als Text formatiert. Wenn dieses Bit festgelegt ist, wird vom Steuerelement versucht, den angezeigten Text als Zahl zu formatieren, die eine Anzahl von Bytes darstellt. Für eine ordnungsgemäße Formatierung muss der Text des Steuerelements auf eine Zeichenfolge festgelegt werden, die eine Zahl darstellt, die in Einheiten von 512 Bytes ausgedrückt wird. Der angezeigte Wert wird dann in Kilobyte (KB), Megabyte (MB) oder Gigabyte (GB) formatiert und mit der entsprechenden Zeichenfolge angezeigt, die die Einheiten darstellt.

 

Bemerkungen

Dieses Steuerelement kann mit der CreateWindowEx-Funktion aus der STATIC-Klasse erstellt werden. Es verfügt über die Stile SS_LEFT, WS_CHILD und WS_GROUP.

Platzieren Sie keine transparenten Textsteuerelemente auf farbigen Bitmaps. Der Text ist möglicherweise nicht lesbar, wenn der Benutzer das Farbschema der Anzeige ändert. Wenn der Benutzer beispielsweise wegen der Barrierefreiheit den Parameter für hohen Kontrast festlegt, kann der Text praktisch unsichtbar werden.