PLAYLIST 요소

  • 아티클

[이 페이지와 연결된 기능인 Windows 미디어 플레이어 SDK는 레거시 기능입니다. MediaPlayer로 대체되었습니다. MediaPlayer는 Windows 10 및 Windows 11 최적화되었습니다. 가능한 경우 새 코드에서 Windows 미디어 플레이어 SDK 대신 MediaPlayer를 사용하는 것이 좋습니다. 가능한 경우 레거시 API를 사용하는 기존 코드를 다시 작성하여 새 API를 사용하도록 제안합니다.]

PLAYLIST 요소는 다음 특성 및 메서드를 사용하여 쉽게 조작할 수 있도록 목록의 미디어 항목을 구성하는 방법을 제공합니다. 편의를 위해 미리 정의된 PLAYLIST 요소도 제공됩니다. PLAYLIST 요소의 자식으로 COLUMN 요소를 포함하여 재생 목록에 대해 사용자 지정된 열을 지정할 수 있습니다.

PLAYLIST 요소는 다음 특성을 지원합니다.

attribute 설명
allowColumnSorting 열 머리글 정렬이 허용되는지 여부를 나타내는 값을 지정하거나 검색합니다.
allowItemEditing 재생 목록의 항목이 현재 위치 편집을 지원하는지 여부를 나타내는 값을 지정하거나 검색합니다.
Backgroundcolor 배경색을 지정하거나 검색합니다.
backgroundImage 배경 이미지를 지정하거나 검색합니다.
checkboxesVisible 확인란이 표시되는지 여부를 나타내는 값을 지정하거나 검색합니다.
columnCount 표시된 열 수를 검색합니다.
columnOrder 재생 목록 열의 순서를 지정하거나 검색합니다.
columns PLAYLIST 요소에 표시되는 열을 정의합니다.
columnsVisible 열이 표시되는지 여부를 나타내는 값을 지정하거나 검색합니다.
복사 PLAYLIST 요소가 복사 작업 중인지 여부를 나타내는 값을 검색합니다.
disabledItemColor 오프라인일 때 비활성화된 CD 트랙 또는 온라인 콘텐츠의 색을 지정하거나 검색합니다.
dropDownBackgroundImage 드롭다운 목록의 배경에 표시되는 이미지의 이름을 지정하거나 검색합니다.
dropDownImage 드롭다운 목록의 오른쪽 가장자리에 표시되는 드롭다운 목록 단추에 사용되는 이미지의 이름을 지정하거나 검색합니다.
Dropdownlist PLAYLIST 요소의 지정된 instance 대한 드롭다운 목록에 표시되는 요소를 나타내는 값을 지정하거나 검색합니다.
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 요소가 인터페이스를 제공하는 Playlist 개체를 지정하거나 검색합니다.
playlistItemsVisible 재생 목록의 항목이 표시되는지 여부를 나타내는 값을 지정하거나 검색합니다.
rightStatus PLAYLIST 요소의 오른쪽과 아래쪽에 표시되는 상태 텍스트를 지정하거나 검색합니다.
채도 드롭다운 이미지의 채도 값을 지정하거나 검색합니다.
statusColor PLAYLIST 요소에서 상태 줄의 색을 지정하거나 검색합니다.
statusTextColor 상태 텍스트의 색을 나타내는 값을 지정하거나 검색합니다.
도구 모음 표시 재생 목록 도구 모음이 표시되는지 여부를 나타내는 값을 지정하거나 검색합니다.

 

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 요소입니다. 다음과 같은 미리 정의된 재생 목록을 사용할 수 있습니다.

미리 정의된 PLAYLIST 설명
DROPDOWNPLAYLIST 항목이 표시되지 않는 드롭다운 재생 목록 입니다.
ITEMSPLAYLIST 항목 또는 열 머리글이 표시되지 않는 드롭다운 PLAYLIST 입니다.

 

스킨 프로그래밍 참조