SLIDER-Element

  • Artikel

[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 SLIDER-Element bietet eine Möglichkeit, ein einfaches horizontales oder vertikales Schiebereglersteuerelement zu erstellen und zu bearbeiten. Es unterstützt die folgenden Attribute und Ereignishandler. Vordefinierte SLIDER-Elemente werden ebenfalls zur Vereinfachung bereitgestellt.

Das SLIDER-Element unterstützt die folgenden Attribute.

attribute Beschreibung
Backgroundcolor Gibt die Hintergrundfarbe des Schiebereglersteuerelements an oder ruft sie ab.
backgroundEndColor Gibt die Hintergrundendfarbe des Schiebereglersteuerelements an oder ruft sie ab.
backgroundHoverImage Gibt das Hintergrundbild des Schiebereglers an, das angezeigt wird, wenn sie mit der Maus darauf zeigen.
Backgroundimage Gibt das Standardhintergrundbild des Schiebereglers an oder ruft es ab.
borderSize Gibt die Rahmengröße in Pixel an oder ruft sie ab.
Cursor Gibt einen Wert an, der angibt, welcher Cursortyp angezeigt wird, wenn sich die Maus über dem Schieberegler befindet.
direction Gibt die Richtung an, in der Schiebereglerbilder angeordnet sind, oder ruft sie ab.
disabledColor Gibt die deaktivierte Farbe des Schiebereglersteuerelements an oder ruft sie ab.
disabledImage Gibt das Bild des Schiebereglers an, das angezeigt wird, wenn das Steuerelement deaktiviert ist.
vordergrundColor Gibt die Vordergrundfarbe des Schiebereglersteuerelements an oder ruft sie ab.
foregroundEndColor Gibt die Vordergrundendfarbe des Schiebereglersteuerelements an oder ruft sie ab.
foregroundHoverImage Gibt das Vordergrundbild des Schiebereglers an, das angezeigt wird, wenn sie mit der Maus darauf zeigen.
vordergrundImage Gibt das Standardbild des Vordergrunds des Schiebereglers an oder ruft es ab.
vordergrundProgress Gibt die aktuelle Position der Fortschrittsleiste im Vordergrund als Prozentsatz des Schiebereglerbereichs an oder ruft sie ab.
max Gibt den maximalen Wert des durch das Schiebereglersteuerelement definierten Bereichs an oder ruft diese ab.
min Gibt den Mindestwert des durch das Schiebereglersteuerelement definierten Bereichs an oder ruft diese ab.
Folie Gibt einen Wert an oder ruft einen Wert ab, der angibt, ob das Vordergrundbild über das Hintergrundbild gleitet.
thumbDisabledImage Gibt das deaktivierte Daumenbild des Schiebereglersteuerelements an oder ruft es ab.
thumbDownImage Gibt das Bild an, das den Abwärtszustand des Daumens darstellt, oder ruft es ab.
thumbHoverImage Gibt das Bild des Daumens an, das angezeigt wird, wenn sie mit der Maus darauf zeigen.
thumbImage Gibt das Bild an, das verwendet wird, um die aktuelle Position des Schiebereglers darzustellen, oder ruft es ab.
Gekachelte Gibt einen Wert an, der angibt, ob die Schiebereglerbilder gekachelt werden, oder ruft sie ab.
Quickinfo Gibt den QuickInfo-Text für das Schiebereglersteuerelement an oder ruft diese ab.
transparencyColor Gibt die transparente Farbe der Schiebereglerbilder an oder ruft sie ab.
useForegroundProgress Gibt einen Wert an, der angibt, ob die Fortschrittsanzeige im Vordergrund verwendet wird, oder ruft sie ab.
value Gibt die aktuelle Position des Schiebereglers an und ruft sie ab.

 

Das SLIDER-Element kann die folgenden Ereignishandler implementieren.

Ereignishandler Beschreibung
onDragBegin Behandelt ein Ereignis, das auftritt, wenn der Benutzer klickt, die linke Maustaste nach unten hält und beginnt, die Maus zu ziehen.
onDragEnd Behandelt ein Ereignis, das auftritt, wenn die linke Maustaste nach einem Ziehvorgang losgelassen wird.
onPositionChange Behandelt ein Ereignis, das auftritt, wenn sich die Position des Schiebereglers durch Klicken oder Ziehen des Benutzers ändert.

 

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

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

Vordefinierter SLIDER Beschreibung
BALANCESLIDER Ein SLIDER , der zum Festlegen der Audiobalance verwendet wird.
SEEKSLIDER Ein SLIDER , der verwendet wird, um eine beliebige Position in einer Mediendatei zu suchen.
VOLUMESLIDER Ein SLIDER , der zum Festlegen der Audiolautstärke verwendet wird.

 

Referenz zur Skin-Programmierung