PLAYLIST 元素

  • 项目

[与此页面关联的功能（Windows 媒体播放器 SDK）是旧版功能。 它已被 MediaPlayer 取代。 MediaPlayer 已针对Windows 10和Windows 11进行了优化。 如果可能，Microsoft 强烈建议新代码使用 MediaPlayer 而不是 Windows 媒体播放器 SDK。 如果可能，Microsoft 建议重写使用旧 API 的现有代码以使用新 API。]

PLAYLIST 元素提供了一种组织列表中的媒体项的方法，以便使用以下属性和方法轻松操作。 为了方便起见，还提供了预定义 的 PLAYLIST 元素。 可以通过将 COLUMN 元素作为 PLAYLIST 元素的子级来为 播放列表 指定自定义列。

PLAYLIST 元素支持以下属性。

属性 说明
allowColumnSorting 指定或检索一个值，该值指示是否允许对列标题进行排序。
allowItemEditing 指定或检索一个值，该值指示播放列表中的项目是否支持就地编辑。
backgroundColor 指定或检索背景色。
backgroundImage 指定或检索背景图像。
checkboxesVisible 指定或检索一个值，该值指示复选框是否可见。
columnCount 检索显示的列数。
columnOrder 指定或检索播放列表列的顺序。
列 定义 PLAYLIST 元素中显示的 列。
columnsVisible 指定或检索一个值，该值指示是否显示列。
复制 检索一个值，该值指示 PLAYLIST 元素是否处于复制操作中。
disabledItemColor 指定或检索禁用的 CD 曲目或脱机时联机内容的颜色。
dropDownBackgroundImage 指定或检索显示在下拉列表背景中的图像的名称。
dropDownImage 指定或检索用于下拉列表按钮的图像名称，该按钮显示在下拉列表的右边缘。
dropDownList 指定或检索一个值，该值指示哪些元素显示在 PLAYLIST 元素的给定实例的下拉列表中。
dropDownToolTip 指定或检索当用户将鼠标悬停在 PLAYLIST 元素下拉菜单上时显示的工具提示。
dropDownVisible 指定或检索一个值，该值指示 PLAYLIST 元素下拉选择器是否可见。
editButtonVisible 指定或检索一个值，该值指示 PLAYLIST 元素编辑按钮是否可见。
foregroundColor 指定或检索前景色。
hueShift 指定或检索下拉图像色调的移动量。
itemCount 检索当前在 PLAYLIST 元素中显示的项数。
itemErrorColor 指定或检索指示具有错误条件的播放列表项的突出显示颜色。
itemMedia 检索与 PLAYLIST 元素中给定索引对应的 Media 对象。
itemPlayingBackgroundColor 指定或检索当前正在播放的播放列表项的背景色。
itemPlayingColor 指定或检索指示播放列表中当前正在播放的项目的突出显示颜色。
itemPlaylist 检索在 PLAYLIST 元素中给定索引处显示的媒体项的播放列表。
itemSelectedBackgroundColor 指定或检索一个值，该值指示播放列表中选定项的背景色。
itemSelectedBackgroundFocusLostColor 指定或检索一个值，该值指示播放列表中选定项的文本颜色。
itemSelectedColor 指定或检索一个值，该值指示播放列表中选定项的文本颜色。
itemSelectedFocusLostColor 指定或检索一个值，该值指示播放列表中选定项在播放列表失去焦点时的文本颜色。
leftStatus 指定或检索在 PLAYLIST 元素左侧和底部显示的状态文本。
播放列表 指定或检索 PLAYLIST 元素向其提供接口的 Playlist 对象。
playlistItemsVisible 指定或检索一个值，该值指示播放列表中的项目是否可见。
rightStatus 指定或检索在 PLAYLIST 元素右侧和底部显示的状态文本。
saturation 指定或检索下拉图像的饱和度值。
statusColor 指定或检索 PLAYLIST 元素中状态行的颜色。
statusTextColor 指定或检索指示状态文本颜色的值。
toolbarVisible 指定或检索一个值，该值指示是否显示播放列表工具栏。

 

PLAYLIST 元素支持以下方法。

方法 说明
abortCopy 取消复制操作。
addSelectedToPlaylist 将所选项添加到播放列表。
copy 从 CD 开始复制操作。
deleteSelected 从播放列表中删除所选项。
deleteSelectedFromLibrary 从播放列表和库中删除所选项。
getNextCheckedItem 检索播放列表中指定索引后面的下一个选中项的索引。
getNextCheckedItem2 检索播放列表中指定索引后面的下一个选中项的索引。 适用于嵌套播放列表。
getNextSelectedItem 检索播放列表中指定索引后面的下一个选定项的索引。
getNextSelectedItem2 检索播放列表中指定索引后面的下一个选定项的索引。 适用于嵌套播放列表。
moveSelectedDown 将选定项在列表中向下移动一个位置。
moveSelectedUp 将所选项在列表中向上移动一个位置。
setCheckedState 指定选中播放列表中的索引项。
setCheckedState2 使用 PLAYLIST 元素中的指定索引设置项的选中状态。 适用于嵌套播放列表。
setColumnResizeMode 指定索引列本身的大小。
setColumnWidth 指定列宽并将列的大小调整模式更改为“wmpcrmFixed”。
setSelectedState 指定选择播放列表中的索引项。
setSelectedState2 使用 PLAYLIST 元素中的指定索引设置项的选定状态。 适用于嵌套播放列表。
sortColumn 对指定列中的数据进行排序。

 

PLAYLIST 元素支持环境属性，并且可以实现环境事件处理程序，除非另有说明。 有关详细信息，请参阅 环境属性 和环境 事件处理程序。

预定义播放列表是具有默认指定的各种通用属性设置的普通 PLAYLIST 元素。 以下预定义播放列表可用。

预定义播放列表 说明
DROPDOWNPLAYLIST 不显示任何项目的下拉列表 播放列表 。
ITEMSPLAYLIST 不显示任何项目或列标题的下拉列表 播放列表 。

 

皮肤编程参考