TEXT-Element

  • Artikel

[Das dieser Seite zugeordnete Feature Windows Medienwiedergabe SDK ist ein Legacyfeature. Es wurde von MediaPlayer abgelöst. MediaPlayer wurde für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, mediaPlayer anstelle von Windows Medienwiedergabe SDK für neuen Code zu verwenden. Microsoft schlägt vor, dass vorhandener Code, der die Legacy-APIs verwendet, so umgeschrieben wird, dass nach Möglichkeit die neuen APIs verwendet werden.]

Das TEXT-Element bietet eine Möglichkeit zum Erstellen und Steuern der Darstellung von Text in einem Skin mithilfe der folgenden Attribute. Zur Vereinfachung werden auch vordefinierte TEXT-Elemente bereitgestellt.

Das TEXT-Element unterstützt die folgenden Attribute.

attribute Beschreibung
Backgroundcolor Gibt die Hintergrundfarbe für das Text-Steuerelement an oder ruft sie ab.
Cursor Gibt einen Wert an oder ruft einen Wert ab, der angibt, welcher Cursor angezeigt wird, wenn sich die Maus über dem Text-Steuerelement befindet.
disabledBackgroundColor Gibt die Für das Text-Steuerelement verwendete Hintergrundfarbe an oder ruft sie ab, wenn es deaktiviert ist.
disabledFontStyle Gibt an oder ruft die Schriftart ab, die für das Text-Steuerelement verwendet wird, wenn es deaktiviert ist.
disabledForegroundColor Gibt die Textfarbe an, die verwendet wird, wenn das Text-Steuerelement deaktiviert ist, oder ruft sie ab.
fontFace Gibt die Schriftart für das Text-Steuerelement an oder ruft sie ab.
Fontsize Gibt den Schriftgrad für das Text-Steuerelement an oder ruft sie ab.
fontSmoothing Gibt einen Wert an oder ruft einen Wert ab, der angibt, ob die Schriftartglättung aktiviert ist.
Fontstyle Gibt die Schriftart für das Text-Steuerelement an oder ruft sie ab.
foregroundColor Gibt die Textfarbe für das Text-Steuerelement an oder ruft sie ab.
hoverBackgroundColor Gibt die Hintergrundfarbe an, die für das Text-Steuerelement verwendet wird, wenn der Mauszeiger darauf bewegt wird, oder ruft sie ab.
hoverFontStyle Gibt die Schriftart an, die für das Text-Steuerelement verwendet wird, wenn der Mauszeiger darauf bewegt wird, oder ruft sie ab.
hoverForegroundColor Gibt die für das Text-Steuerelement verwendete Textfarbe an oder ruft sie ab, wenn der Mauszeiger darauf bewegt wird.
Rechtfertigung Gibt die Ausrichtung des Texts im Text-Steuerelement an oder ruft sie ab.
Scrollen Gibt einen Wert an oder ruft einen Wert ab, der angibt, ob der Text scrollt.
scrollingAmount Gibt die Anzahl der Pixel an, die der Text während jeder Bildlaufbewegung bewegt, oder ruft sie ab.
scrollingDelay Gibt die Zeitverzögerung zwischen Scrollbewegungen an oder ruft sie ab.
scrollingDirection Gibt die Richtung des bildlaufenden Texts an oder ruft sie ab.
Textwidth Ruft die Breite der Zeichenfolge in Pixel ab, die im value-Attribut enthalten ist.
Quickinfo Gibt den QuickInfo-Text für das Textsteuerelement an oder ruft sie ab.
value Gibt den Text an, der im Text-Steuerelement angezeigt wird, oder ruft diesen ab.
Wordwrap Gibt einen Wert an oder ruft einen Wert ab, der angibt, ob der Wortumbruch aktiviert oder deaktiviert ist.

 

Das TEXT-Element unterstützt die Ambient-Attribute und kann die Ambient-Ereignishandler implementieren. Weitere Informationen finden Sie unter Ambient-Attribute und Ambient-Ereignishandler.

Vordefinierte Textelemente sind normale TEXT-Elemente mit verschiedenen allgemeinen Attributeinstellungen, die standardmäßig angegeben sind. Die folgenden vordefinierten Textelemente sind verfügbar.

Vordefinierter TEXT Beschreibung
CURRENTPOSITIONTEXT Ein TEXT-Element mit einem integrierten Listener für player.controls.currentPositionString.
DURATIONTEXT Ein TEXT-Element mit einem integrierten Listener für player.currentMedia.DurationString.
STATUSTEXT Ein TEXT-Element mit einem integrierten Listener für player.status.
TRACKNAMETEXT Ein TEXT-Element mit integriertem Listener für player.currentMedia.name.

 

Skin-Programmierreferenz