BUTTON-Element

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

Das BUTTON-Element bietet eine Möglichkeit, eine Schaltfläche innerhalb einer Skin zu erstellen. Die folgenden Attribute können verwendet werden, um das Verhalten einer Schaltfläche anzupassen, oder eine vordefinierte Schaltfläche kann zur Vereinfachung verwendet werden.

Das BUTTON-Element unterstützt die folgenden Attribute.

attribute Beschreibung
Cursor Gibt den Cursor an, der angezeigt wird, wenn der Mauszeiger über die SCHALTFLÄCHE bewegt wird, oder ruft diesen ab.
disabledImage Gibt das Bild an oder ruft es ab, das angezeigt wird, wenn die SCHALTFLÄCHE deaktiviert ist.
nach unten Gibt einen Wert an oder ruft einen Wert ab, der angibt, ob sich die SCHALTFLÄCHE in der Position nach oben oder unten befindet.
downImage Gibt das Bild an, das den Abwärtszustand der SCHALTFLÄCHE darstellt, oder ruft es ab.
downToolTip Gibt den QuickInfo-Text an oder ruft diesen ab, der angezeigt wird, wenn die Maus über die SCHALTFLÄCHE ist und sich die SCHALTFLÄCHE im abwärts- oder gedrückten Zustand befindet.
hoverDownImage Gibt das angezeigte Bild an oder ruft es ab, wenn sich die SCHALTFLÄCHE im Abwärtszustand befindet und der Benutzer mit dem Mauszeiger darauf bewegt.
hoverImage Gibt das angezeigte Bild an oder ruft es ab, wenn sich die SCHALTFLÄCHE im Status "Up" befindet und der Benutzer mit dem Mauszeiger darauf schwebt.
image Gibt das Standardbild der SCHALTFLÄCHE an oder ruft es ab.
Klebrig Gibt einen Wert an, der angibt, ob es sich bei der SCHALTFLÄCHE um eine Umschaltfläche handelt, d. h. ob es sich um eine Schaltfläche mit zwei oder nur einem Zustand handelt, oder ruft diesen ab.
Gekachelte Gibt einen Wert an, der angibt, ob das BUTTON-Bild gekachelt wird, oder ruft er ab.
transparencyColor Gibt die Farbe an, die im BUTTON-Bild transparent sein soll, oder ruft sie ab.
upToolTip Gibt den QuickInfo-Text an, der angezeigt wird, wenn sich die Maus über die SCHALTFLÄCHE befindet und sich die SCHALTFLÄCHE im Status "Up" befindet.

 

Das BUTTON-Element unterstützt die Umgebungsattribute und kann die Umgebungsereignishandler implementieren. Weitere Informationen finden Sie unter Umgebungsattribute und Umgebungsereignishandler.

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

Vordefinierte SCHALTFLÄCHE Beschreibung
CLOSEBUTTON Eine SCHALTFLÄCHE , die zum Schließen des Players verwendet wird.
FFWDBUTTON Eine SCHALTFLÄCHE mit einem integrierten Aufruf von player.controls.fastForward , wenn darauf geklickt wird.
IMAGEBUTTON Eine SCHALTFLÄCHE , die zum Anzeigen eines Bilds verwendet wird.
MINIMIERENSCHALTFLÄCHE Eine SCHALTFLÄCHE , die verwendet wird, um den Player zu minimieren.
MUTEBUTTON Eine SCHALTFLÄCHE , die zum Stummschalten und Aufheben der Stummschaltung des Audiosignals verwendet wird.
WEITERSCHALTFLÄCHE Eine SCHALTFLÄCHE mit einem integrierten Aufruf von player.controls.next , wenn darauf geklickt wird.
PAUSEBUTTON Eine SCHALTFLÄCHE mit einem integrierten Aufruf von player.controls.pause , wenn darauf geklickt wird.
PLAYBUTTON Eine SCHALTFLÄCHE mit einem integrierten Aufruf von player.controls.play , wenn darauf geklickt wird.
PREVBUTTON Eine SCHALTFLÄCHE mit einem integrierten Aufruf von player.controls.previous , wenn darauf geklickt wird.
REPEATBUTTON Eine SCHALTFLÄCHE , mit der die Option Wiederholen umgeschaltet wird.
RETURNBUTTON Eine SCHALTFLÄCHE, die Windows Medienwiedergabe an das Media Center zurückgibt.
REWBUTTON Eine SCHALTFLÄCHE mit einem integrierten Aufruf von player.controls.fastReverse , wenn darauf geklickt wird.
SHUFFLEBUTTON Eine SCHALTFLÄCHE , die die Option Shuffle umschaltt.
STOPBUTTON Eine SCHALTFLÄCHE mit einem integrierten Aufruf von player.controls.stop , wenn darauf geklickt wird.

 

Referenz zur Skin-Programmierung