다음을 통해 공유


목록 상자

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

개요

주제 목차
목록 상자 정보 목록 상자 기능에 대해 설명합니다.
목록 상자 사용하여 목록 상자와 연결된 작업을 수행하는 방법을 설명합니다.

함수

주제 목차
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_HASSTRINGS 스타일로 만들어지지 않고 LBS_NODATA 스타일로 만든 목록 상자의 항목 수를 설정합니다.
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 매개 변수로 전달됩니다.

상수

주제 목차
목록 상자 스타일 목록 상자 컨트롤을 정의하는 창 스타일을 설명합니다.