LISTBOX 요소

  • 아티클

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

LISTBOX 요소는 사용자가 목록에서 항목을 선택하는 방법을 제공합니다. 이러한 항목은 ITEM 요소를 LISTBOX 요소의 자식으로 사용하여 지정할 수 있습니다. 필요한 경우에만 표시되는 목록 상자 컨트롤이 필요한 경우 popUp 특성의 기본값을 제외하고 LISTBOX 요소와 동일한 POPUP 요소를 사용하여 표시 동작을 지시합니다.

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

attribute 설명
Backgroundcolor 목록 상자 컨트롤의 배경색을 지정하거나 검색합니다.
테두리 목록 상자 컨트롤에 테두리가 있는지 여부를 나타내는 값을 지정하거나 검색합니다. 디자인 타임에만 설정할 수 있습니다.
firstVisibleItem 목록 상자 컨트롤에서 표시되는 첫 번째 줄의 인덱스를 지정하거나 검색합니다.
focusItem 포커스가 포함된 줄을 지정하거나 검색합니다.
fontFace 목록 상자 컨트롤의 글꼴을 지정하거나 검색합니다.
Fontsize 목록 상자 컨트롤의 글꼴 크기를 지정하거나 검색합니다.
Fontstyle 목록 상자 컨트롤의 글꼴 스타일을 지정하거나 검색합니다.
foregroundColor 목록 상자 컨트롤에서 텍스트 색을 지정하거나 검색합니다.
itemCount 목록 상자 컨트롤의 항목 수를 검색합니다.
Multiselect 사용자가 여러 줄을 선택할 수 있는지 여부를 나타내는 값을 지정하거나 검색합니다. 디자인 타임에만 설정할 수 있습니다.
팝업 요소가 팝업 또는 목록 상자 컨트롤을 나타내는지 여부를 나타내는 값을 지정합니다.
readOnly 텍스트가 읽기 전용인지 아니면 사용자가 텍스트를 선택할 수 있는지 여부를 나타내는 값을 지정하거나 검색합니다.
selectedItem 목록 상자 컨트롤에서 선택한 항목의 인덱스를 지정하거나 검색합니다.
정렬 목록 상자 컨트롤이 사전순으로 정렬되는지 여부를 나타내는 값을 지정하거나 검색합니다.

 

LISTBOX 요소는 다음 메서드를 지원합니다.

메서드 설명
appendItem 목록 상자 컨트롤의 끝에 새 텍스트를 삽입합니다.
deleteAll 목록 상자 컨트롤에서 모든 항목을 삭제합니다.
deleteItem 지정된 인덱스에서 목록 상자 컨트롤 항목을 삭제합니다.
해제 컨트롤을 숨깁니다.
Finditem 지정된 항목 인덱스 다음에 있는 항목으로 시작하는 지정된 문자열을 검색합니다.
Getitem 지정된 인덱스를 사용하여 항목의 텍스트를 검색합니다.
getNextSelectedItem 목록 상자 컨트롤에서 선택한 다음 항목을 지정된 인덱스가 있는 항목 뒤에 있는 항목부터 검색합니다.
Insertitem 목록 상자 컨트롤의 지정된 인덱스에 지정된 텍스트를 삽입합니다.
replaceItem 지정된 인덱스의 텍스트를 지정된 텍스트로 바꿉니다.
setSelectedState 지정된 인덱스를 사용하여 항목을 선택하거나 선택 취소합니다.
show 컨트롤을 표시합니다.

 

참고

이 요소에는 Windows XP 이상용 Windows 미디어 플레이어 필요합니다.

 

POPUP 요소

스킨 프로그래밍 참조