PLAYLIST-Element

[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 PLAYLIST-Element bietet eine Möglichkeit zum Organisieren von Medienelementen in einer Liste zur einfachen Bearbeitung mit den folgenden Attributen und Methoden. Zur Vereinfachung werden auch vordefinierte PLAYLIST-Elemente bereitgestellt. Benutzerdefinierte Spalten können für eine Wiedergabeliste angegeben werden, indem COLUMN-Elemente als untergeordnete Elemente des PLAYLIST-Elements eingeschlossen werden.

Das PLAYLIST-Element unterstützt die folgenden Attribute.

attribute BESCHREIBUNG
allowColumnSorting Gibt einen Wert an oder ruft einen Wert ab, der angibt, ob die Sortierung nach Spaltenüberschriften zulässig ist.
allowItemEditing Gibt einen Wert an oder ruft einen Wert ab, der angibt, ob Elemente in einer Wiedergabeliste die direkte Bearbeitung unterstützen.
Backgroundcolor Gibt die Hintergrundfarbe an oder ruft sie ab.
Backgroundimage Gibt das Hintergrundbild an oder ruft es ab.
checkboxesVisible Gibt einen Wert an oder ruft einen Wert ab, der angibt, ob Kontrollkästchen sichtbar sind.
columnCount Ruft die Anzahl der angezeigten Spalten ab.
columnOrder Gibt die Reihenfolge der Wiedergabelistenspalten an oder ruft sie ab.
columns Definiert die Spalten, die im PLAYLIST-Element angezeigt werden.
columnsVisible Gibt einen Wert an oder ruft einen Wert ab, der angibt, ob Spalten angezeigt werden.
Kopieren Ruft einen Wert ab, der angibt, ob sich das PLAYLIST-Element im Kopiervorgang befindet.
disabledItemColor Gibt an oder ruft die Farbe einer deaktivierten CD-Spur oder von Onlineinhalten ab, wenn sie offline sind.
dropDownBackgroundImage Gibt den Namen des Bilds an, das im Hintergrund der Dropdownliste angezeigt wird, oder ruft diesen ab.
dropDownImage Gibt den Namen des Bilds an, das für die Dropdownlistenschaltfläche verwendet wird, die am rechten Rand der Dropdownliste angezeigt wird, oder ruft diesen ab.
Dropdownlist Gibt einen Wert an oder ruft einen Wert ab, der angibt, welche Elemente in der Dropdownliste für eine bestimmte instance des PLAYLIST-Elements angezeigt werden.
dropDownToolTip Gibt die QuickInfo an, die angezeigt wird, wenn der Benutzer über das Dropdownmenü des PLAYLIST-Elements bewegt wird, oder ruft sie ab.
dropDownVisible Gibt einen Wert an oder ruft einen Wert ab, der angibt, ob die Dropdownauswahl des PLAYLIST-Elements sichtbar ist.
editButtonVisible Gibt einen Wert an oder ruft einen Wert ab, der angibt, ob die Bearbeitungsschaltfläche des PLAYLIST-Elements sichtbar ist.
foregroundColor Gibt die Vordergrundfarbe an oder ruft sie ab.
hueShift Gibt an oder ruft den Betrag ab, um den der Farbton der Dropdownbilder verschoben wird.
itemCount Ruft die Anzahl der Elemente ab, die derzeit im PLAYLIST-Element angezeigt werden.
itemErrorColor Gibt die Hervorhebungsfarbe an, die ein Wiedergabelistenelement angibt, das eine Fehlerbedingung aufweist, oder ruft sie ab.
itemMedia Ruft das Media-Objekt ab, das dem angegebenen Index im PLAYLIST-Element entspricht.
itemPlayingBackgroundColor Gibt die Hintergrundfarbe des aktuell wiedergegebenen Wiedergabelistenelements an oder ruft sie ab.
itemPlayingColor Gibt die Hervorhebungsfarbe an, die das aktuell wiedergegebene Element in der Wiedergabeliste angibt, oder ruft sie ab.
itemPlaylist Ruft die Wiedergabeliste für das Medienelement ab, das am angegebenen Index im PLAYLIST-Element angezeigt wird.
itemSelectedBackgroundColor Gibt einen Wert an, der die Hintergrundfarbe eines ausgewählten Elements in der Wiedergabeliste angibt, oder ruft diesen ab.
itemSelectedBackgroundFocusLostColor Gibt einen Wert an, der die Textfarbe eines ausgewählten Elements in der Wiedergabeliste angibt, oder ruft diesen ab.
itemSelectedColor Gibt einen Wert an, der die Textfarbe eines ausgewählten Elements in der Wiedergabeliste angibt, oder ruft diesen ab.
itemSelectedFocusLostColor Gibt einen Wert an, der die Textfarbe eines ausgewählten Elements in der Wiedergabeliste angibt, wenn die Wiedergabeliste den Fokus verliert, oder ruft diesen ab.
leftStatus Gibt den status Text an, der links und unten im PLAYLIST-Element angezeigt wird, oder ruft diesen ab.
Playlist Gibt das Playlist-Objekt an, für das das PLAYLIST-Element eine Schnittstelle bereitstellt, oder ruft es ab.
playlistItemsVisible Gibt einen Wert an oder ruft einen Wert ab, der angibt, ob Elemente in der Wiedergabeliste sichtbar sind.
rightStatus Gibt den status Text an, der rechts und unten im PLAYLIST-Element angezeigt wird, oder ruft diesen ab.
Sättigung Gibt den Sättigungswert der Dropdownbilder an oder ruft den Sättigungswert ab.
statusColor Gibt die Farbe der status Zeile im PLAYLIST-Element an oder ruft sie ab.
statusTextColor Gibt einen Wert an oder ruft einen Wert ab, der die Farbe des status Texts angibt.
toolbarVisible Gibt einen Wert an oder ruft einen Wert ab, der angibt, ob die Wiedergabelistensymbolleiste angezeigt wird.

 

Das PLAYLIST-Element unterstützt die folgenden Methoden.

Methode BESCHREIBUNG
abortCopy Bricht einen Kopiervorgang ab.
addSelectedToPlaylist Fügt das ausgewählte Element der Wiedergabeliste hinzu.
copy Startet einen Kopiervorgang von der CD.
deleteSelected Löscht das ausgewählte Element aus der Wiedergabeliste.
deleteSelectedFromLibrary Löscht das ausgewählte Element aus der Wiedergabeliste und aus der Bibliothek.
getNextCheckedItem Ruft den Index des nächsten aktivierten Elements in der Wiedergabeliste ab, das dem angegebenen Index folgt.
getNextCheckedItem2 Ruft den Index des nächsten aktivierten Elements in der Wiedergabeliste ab, das dem angegebenen Index folgt. Funktioniert mit geschachtelten Wiedergabelisten.
getNextSelectedItem Ruft den Index des nächsten ausgewählten Elements in der Wiedergabeliste ab, das dem angegebenen Index folgt.
getNextSelectedItem2 Ruft den Index des nächsten ausgewählten Elements in der Wiedergabeliste ab, das dem angegebenen Index folgt. Funktioniert mit geschachtelten Wiedergabelisten.
moveSelectedDown Verschiebt das ausgewählte Element um eine Position in der Liste nach unten.
moveSelectedUp Verschiebt das ausgewählte Element um eine Position in der Liste nach oben.
setCheckedState Gibt an, dass das indizierte Element in der Wiedergabeliste aktiviert ist.
setCheckedState2 Legt den überprüften Zustand des Elements mit dem angegebenen Index im PLAYLIST-Element fest. Funktioniert mit geschachtelten Wiedergabelisten.
setColumnResizeMode Gibt an, wie sich die indizierte Spalte selbst ausbreitet.
setColumnWidth Gibt die Spaltenbreite an und ändert den Größenänderungsmodus der Spalte in "wmpcrmFixed".
setSelectedState Gibt an, dass das indizierte Element in der Wiedergabeliste ausgewählt ist.
setSelectedState2 Legt den ausgewählten Zustand des Elements mit dem angegebenen Index im PLAYLIST-Element fest. Funktioniert mit geschachtelten Wiedergabelisten.
sortColumn Sortiert die Daten in der angegebenen Spalte.

 

Das PLAYLIST-Element unterstützt die Ambient-Attribute und kann die Ambient-Ereignishandler implementieren, sofern nicht angegeben. Weitere Informationen finden Sie unter Ambient-Attribute und Ambient-Ereignishandler.

Vordefinierte Wiedergabelisten sind normale PLAYLIST-Elemente mit verschiedenen gängigen Attributeinstellungen, die standardmäßig angegeben sind. Die folgenden vordefinierten Wiedergabelisten sind verfügbar.

Vordefinierte WIEDERGABELISTE BESCHREIBUNG
DROPDOWNPLAYLIST Ein Dropdown-PLAYLIST , in dem keine Elemente sichtbar sind.
ITEMSPLAYLIST Ein Dropdown-PLAYLIST , in dem keine Elemente oder Spaltenüberschriften sichtbar sind.

 

Skin-Programmierreferenz