Windows Media Player 11 SDK PLAYLIST Element 

Previous

Next

PLAYLIST Element

The PLAYLIST element provides a way to organize media items in a list for easy manipulation using the following attributes and methods. Predefined PLAYLIST elements are also provided for convenience. Customized columns can be specified for a playlist by including COLUMN elements as children of the PLAYLIST element.

The PLAYLIST element supports the following attributes.

Attribute	Description
allowColumnSorting	Specifies or retrieves a value indicating whether sorting on column headers is allowed.
allowItemEditing	Specifies or retrieves a value indicating whether items in a playlist support in-place editing.
backgroundColor	Specifies or retrieves the background color.
backgroundImage	Specifies or retrieves the background image.
checkboxesVisible	Specifies or retrieves a value indicating whether checkboxes are visible.
columnCount	Retrieves the number of columns shown.
columnOrder	Specifies or retrieves the order of the playlist columns.
columns	Defines the columns that appear in the PLAYLIST element.
columnsVisible	Specifies or retrieves a value indicating whether columns are shown.
copying	Retrieves a value indicating whether the PLAYLIST element is in the act of copying.
disabledItemColor	Specifies or retrieves the color of a disabled CD track or of online content when offline.
dropDownBackgroundImage	Specifies or retrieves the name of the image that displays in the background of the drop-down list.
dropDownImage	Specifies or retrieves the name of the image used for the drop-down list button that is displayed at the right edge of the drop-down list.
dropDownList	Specifies or retrieves a value indicating which elements show up in the drop-down list for a given instance of the PLAYLIST element.
dropDownToolTip	Specifies or retrieves the ToolTip shown when the user hovers over the PLAYLIST element drop-down menu.
dropDownVisible	Specifies or retrieves a value indicating whether the PLAYLIST element drop-down selector is visible.
editButtonVisible	Specifies or retrieves a value indicating whether the PLAYLIST element edit button is visible.
foregroundColor	Specifies or retrieves the foreground color.
hueShift	Specifies or retrieves the amount by which the hue of the drop-down images is shifted.
itemCount	Retrieves the number of items currently displayed in the PLAYLIST element.
itemErrorColor	Specifies or retrieves the highlight color that indicates a playlist item that has an error condition.
itemMedia	Retrieves the Media object corresponding to the given index in the PLAYLIST element.
itemPlayingBackgroundColor	Specifies or retrieves the background color of the currently playing playlist item.
itemPlayingColor	Specifies or retrieves the highlight color that indicates the currently playing item in the playlist.
itemPlaylist	Retrieves the playlist for the media item that is displayed at the given index in the PLAYLIST element.
itemSelectedBackgroundColor	Specifies or retrieves a value indicating the background color of a selected item in the playlist.
itemSelectedBackgroundFocusLostColor	Specifies or retrieves a value indicating the text color of a selected item in the playlist.
itemSelectedColor	Specifies or retrieves a value indicating the text color of a selected item in the playlist.
itemSelectedFocusLostColor	Specifies or retrieves a value indicating the text color of a selected item in the playlist when the playlist loses focus.
leftStatus	Specifies or retrieves the status text that is displayed on the left side and bottom of the PLAYLIST element.
playlist	Specifies or retrieves the Playlist object to which the PLAYLIST element provides an interface.
playlistItemsVisible	Specifies or retrieves a value indicating whether items in the playlist are visible.
rightStatus	Specifies or retrieves the status text that is displayed on the right side and bottom of the PLAYLIST element.
saturation	Specifies or retrieves the saturation value of the drop-down images.
statusColor	Specifies or retrieves the color of the status line in the PLAYLIST element.
statusTextColor	Specifies or retrieves a value indicating the color of the status text.
toolbarVisible	Specifies or retrieves a value indicating whether the playlist toolbar displays.

The PLAYLIST element supports the following methods.

Method	Description
abortCopy	Cancels a copy operation.
addSelectedToPlaylist	Adds the selected item to the playlist.
copy	Begins a copy operation from the CD.
deleteSelected	Deletes the selected item from the playlist.
deleteSelectedFromLibrary	Deletes the selected item from the playlist and from the library.
getNextCheckedItem	Retrieves the index of the next checked item in the playlist following the specified index.
getNextCheckedItem2	Retrieves the index of the next checked item in the playlist following the specified index. Works with nested playlists.
getNextSelectedItem	Retrieves the index of the next selected item in the playlist following the specified index.
getNextSelectedItem2	Retrieves the index of the next selected item in the playlist following the specified index. Works with nested playlists.
moveSelectedDown	Moves the selected item down one position in the list.
moveSelectedUp	Moves the selected item up one position in the list.
setCheckedState	Specifies that the indexed item in the playlist is checked.
setCheckedState2	Sets the checked state of the item with the specified index in the PLAYLIST element. Works with nested playlists.
setColumnResizeMode	Specifies how the indexed column sizes itself.
setColumnWidth	Specifies the column width and changes the resize mode of the column to "wmpcrmFixed".
setSelectedState	Specifies that the indexed item in the playlist is selected.
setSelectedState2	Sets the selected state of the item with the specified index in the PLAYLIST element. Works with nested playlists.
sortColumn	Sorts the data in the specified column.

The PLAYLIST element supports the ambient attributes and can implement the ambient event handlers, except where noted. For more information, see Ambient Attributes and Ambient Event Handlers.

Predefined playlists are normal PLAYLIST elements with various common attribute settings specified by default. The following predefined playlists are available.

Predefined PLAYLIST	Description
DROPDOWNPLAYLIST	A drop-down PLAYLIST with no items visible.
ITEMSPLAYLIST	A drop-down PLAYLIST with no items or column headers visible.

See Also

• Skin Programming Reference

Previous

Next