다음을 통해 공유


목록 상자

이 섹션에는 목록 상자와 함께 사용되는 프로그래밍 요소에 대한 정보가 포함되어 있습니다. 목록 상자는 사용자가 선택할 수 있는 항목의 일반 목록이 포함된 컨트롤 창입니다. 더 복잡한 목록을 보려면 대신 목록 보기를 사용합니다.

개요

항목 콘텐츠
목록 상자 정보 목록 상자의 기능을 설명합니다.
목록 상자 사용 목록 상자와 관련된 작업을 수행하는 방법에 대해 설명합니다.

Functions

항목 콘텐츠
DlgDirList 콤보 상자의 콘텐츠를 지정된 디렉터리의 하위 디렉터리 및 파일 이름으로 바꿉니다.
DlgDirSelectEx 단일 선택 목록 상자에서 현재 선택 영역을 검색합니다.
DrawInsert 지정한 끌기 목록 상자의 부모 창에 삽입 아이콘을 그립니다.
GetListBoxInfo 지정된 목록 상자에 대한 정보를 검색합니다.
LBItemFromPt 목록 상자에 지정된 지점에서 항목의 인덱스를 검색합니다.
MakeDragList 지정된 단일 선택 목록 상자를 끌기 목록 상자로 변경합니다.

메시지

항목 콘텐츠
LB_ADDFILE 디렉터리 목록이 포함된 목록 상자에 지정된 파일 이름을 추가합니다.
LB_ADDSTRING 목록 상자에 문자열을 추가합니다.
LB_DELETESTRING 목록 상자에서 문자열을 삭제합니다.
LB_DIR 목록 상자에 표시된 목록에 이름을 추가합니다.
LB_FINDSTRING 지정된 문자열로 시작하는 목록 상자에서 첫 번째 문자열을 찾습니다.
LB_FINDSTRINGEXACT 대/소문자를 구분하지 않는 검색 결과를 제외하고 지정된 문자열과 정확히 일치하는 첫 번째 목록 상자 문자열을 찾습니다.
LB_GETANCHORINDEX 앵커 항목, 즉 다중 선택이 시작되는 항목의 인덱스를 가져옵니다.
LB_GETCARETINDEX 다중 선택 목록 상자에 포커스 사각형이 있는 항목의 인덱스를 검색합니다. 항목을 선택할 수도, 선택하지 않을 수도 있습니다.
LB_GETCOUNT 목록 상자의 항목 수를 가져옵니다.
LB_GETCURSEL 단일 선택 목록 상자에서 현재 선택한 항목의 인덱스(있는 경우)를 가져옵니다.
LB_GETHORIZONTALEXTENT 목록 상자에 가로 스크롤 막대가 있는 경우 목록 상자를 가로로 스크롤할 수 있는 너비(스크롤 가능한 너비)를 픽셀 단위로 가져옵니다.
LB_GETITEMDATA 지정된 목록 상자 항목과 연결된 애플리케이션 정의 값을 가져옵니다.
LB_GETITEMHEIGHT 목록 상자에서 항목의 높이를 가져옵니다.
LB_GETITEMRECT 현재 목록 상자에 표시되는 목록 상자 항목의 경계를 이루는 사각형의 크기를 가져옵니다.
LB_GETLISTBOXINFO 지정된 목록 상자에서 열당 항목 수를 가져옵니다.
LB_GETLOCALE 목록 상자의 현재 로캘을 가져옵니다.
LB_GETSEL 항목의 선택 상태를 가져옵니다.
LB_GETSELCOUNT 다중 선택 목록 상자에서 선택한 항목의 총수를 가져옵니다.
LB_GETSELITEMS 다중 선택 목록 상자에서 선택한 항목의 항목 번호를 지정하는 정수 배열로 버퍼를 채웁니다.
LB_GETTEXT 목록 상자에서 문자열을 가져옵니다.
LB_GETTEXTLEN 목록 상자에서 문자열의 길이를 가져옵니다.
LB_GETTOPINDEX 목록 상자에서 가장 먼저 표시되는 항목의 인덱스를 가져옵니다.
LB_INITSTORAGE 목록 상자 항목을 저장하기 위한 메모리를 할당합니다. 이 메시지는 애플리케이션이 목록 상자에 많은 수의 항목을 추가하기 전에 사용됩니다.
LB_INSERTSTRING 목록 상자에 문자열 또는 항목 데이터를 삽입합니다. LB_ADDSTRING 메시지와 달리 LB_INSERTSTRING 메시지는 LBS_SORT 스타일이 있는 목록을 정렬하지 않습니다.
LB_ITEMFROMPOINT 목록 상자에 지정된 지점에서 가장 가까운 항목의 인덱스(0부터 시작)를 가져옵니다.
LB_RESETCONTENT 목록 상자에서 모든 항목을 제거합니다.
LB_SELECTSTRING 목록 상자에서 지정된 문자열의 문자로 시작하는 항목을 검색합니다.
LB_SELITEMRANGE 다중 선택 목록 상자에서 하나 이상의 연속 항목을 선택하거나 선택 취소합니다.
LB_SELITEMRANGEEX 다중 선택 목록 상자에서 하나 이상의 연속 항목을 선택합니다.
LB_SETANCHORINDEX 앵커 항목, 즉 다중 선택이 시작되는 항목을 설정합니다. 다중 선택은 앵커 항목에서 캐럿 항목까지, 모든 항목에 걸쳐 있습니다.
LB_SETCARETINDEX 포커스 사각형을 다중 선택 목록 상자에 지정된 인덱스 항목으로 설정합니다. 항목이 표시되지 않으면 보기로 스크롤됩니다.
LB_SETCOLUMNWIDTH 다중 열 목록 상자에 있는 모든 열의 너비를 픽셀 단위로 설정합니다.
LB_SETCOUNT LBS_NODATA 스타일로 만들어지고 LBS_HASSTRINGS 스타일로 만들어지지 않은 목록 상자의 항목 수를 설정합니다.
LB_SETCURSEL 문자열을 선택하고 필요한 경우 보기로 스크롤합니다.
LB_SETHORIZONTALEXTENT 목록 상자를 가로로 스크롤할 수 있는 너비(스크롤 가능한 너비)를 픽셀 단위로 설정합니다.
LB_SETITEMDATA 목록 상자에 지정된 항목과 연결된 값을 설정합니다.
LB_SETITEMHEIGHT 목록 상자의 항목 높이를 픽셀 단위로 설정합니다.
LB_SETLOCALE 목록 상자의 현재 로캘을 설정합니다.
LB_SETSEL 다중 선택 목록 상자에서 문자열을 선택합니다.
LB_SETTABSTOPS 목록 상자에서 탭 중지 위치를 설정합니다.
LB_SETTOPINDEX 목록 상자에 지정된 항목이 표시되는지 확인합니다.

알림

항목 콘텐츠
LBN_DBLCLK 사용자가 목록 상자에서 항목을 두 번 클릭했음을 애플리케이션에 알립니다.
LBN_ERRSPACE 목록 상자가 특정 요청을 충족시키기에 충분한 메모리를 할당할 수 없음을 애플리케이션에 알립니다.
LBN_KILLFOCUS 목록 상자에서 키보드 포커스를 손실했음을 애플리케이션에 알립니다.
LBN_SELCANCEL 사용자가 목록 상자에서 선택 영역을 취소했음을 애플리케이션에 알립니다.
LBN_SELCHANGE 목록 상자의 선택 항목이 변경되었음을 애플리케이션에 알립니다.
LBN_SETFOCUS 목록 상자에서 키보드 포커스를 받았음을 애플리케이션에 알립니다.
WM_CHARTOITEM WM_CHAR 메시지에 대한 응답으로 LBS_WANTKEYBOARDINPUT 스타일이 있는 목록 상자에서 소유자에게 보냅니다.
WM_CTLCOLORLISTBOX 시스템에서 목록 상자를 그리기 전에 목록 상자의 부모 창으로 보냅니다. 부모 창은 이 메시지에 응답하여 지정된 디스플레이 디바이스 컨텍스트 핸들을 사용해 목록 상자의 텍스트와 배경색을 설정할 수 있습니다.
WM_DELETEITEM 목록 상자 또는 콤보 상자가 제거되거나 항목이 LB_DELETESTRING, LB_RESETCONTENT, CB_DELETESTRING 또는 CB_RESETCONTENT 메시지에 의해 제거되면 목록 상자 또는 콤보 상자의 소유자에게 보냅니다.
WM_VKEYTOITEM WM_KEYDOWN 메시지에 대한 응답으로 LBS_WANTKEYBOARDINPUT 스타일이 있는 목록 상자에서 소유자에게 보냅니다.
DL_BEGINDRAG 사용자가 항목을 마우스 왼쪽 단추로 클릭했음을 끌기 목록 상자의 부모 창에 알립니다.
DL_CANCELDRAG 사용자가 마우스 오른쪽 단추를 클릭하거나 ESC 키를 눌러 끌기 작업을 취소했음을 알립니다.
DL_DRAGGING 항목을 드래그하는 동안 사용자가 마우스를 이동했음을 알립니다.
DL_DROPPED 사용자가 마우스 왼쪽 단추를 놓아 끌기 작업을 완료했음을 알립니다.

구조체

항목 콘텐츠
DELETEITEMSTRUCT 삭제된 목록 상자 또는 콤보 상자 항목에 대한 정보를 포함합니다.
DRAGLISTINFO 끌기 이벤트에 대한 정보를 포함합니다. DRAGLISTINFO를 가리키는 포인터는 끌기 목록 메시지의 lParam 매개 변수로 전달됩니다.

상수

항목 콘텐츠
목록 상자 스타일 목록 상자 컨트롤을 정의하는 창 스타일을 설명합니다.