다음을 통해 공유


콤보 상자(Windows 컨트롤)

이 섹션에는 콤보 상자와 함께 사용되는 프로그래밍 요소에 대한 정보가 포함되어 있습니다. 콤보 상자는 목록 상자와 편집 컨트롤의 많은 기능을 결합한 COMBOBOX 클래스에 의해 정의된 고유한 형식의 컨트롤입니다.

개요

항목 콘텐츠
콤보 상자 정보 이 섹션에서는 다양한 종류의 콤보 상자에 대해 설명합니다.
콤보 상자 기능 이 문서에서는 콤보 상자의 기능에 대해 설명합니다.
콤보 상자 사용 이 섹션의 코드 예는 콤보 상자와 관련된 작업을 수행하는 방법을 보여 줍니다.

Functions

항목 콘텐츠
DlgDirListComboBox 콤보 상자의 콘텐츠를 지정된 디렉터리의 하위 디렉터리 및 파일 이름으로 바꿉니다. 파일 특성 집합을 지정하여 이름 목록을 필터링할 수 있습니다. 이름 목록에는 매핑된 드라이브 문자가 포함될 수 있습니다.
DlgDirSelectComboBoxEx DlgDirListComboBox 함수를 사용하여 채워진 콤보 상자에서 현재 선택 항목을 검색합니다. 선택 항목은 드라이브 문자, 파일 또는 디렉터리 이름으로 해석됩니다.
GetComboBoxInfo 지정된 콤보 상자에 대한 정보를 검색합니다.

매크로

항목 콘텐츠
ComboBox_AddItemData 지정된 위치에 있는 콤보 상자의 목록에 항목 데이터를 추가합니다. 이 매크로를 사용하거나 CB_ADDSTRING 메시지를 명시적으로 보낼 수 있습니다.
ComboBox_AddString 콤보 상자의 목록에 문자열을 추가합니다. 콤보 상자에 CBS_SORT 스타일이 없으면 문자열이 목록 끝에 추가됩니다. 그렇지 않으면 문자열이 목록에 삽입되고 목록이 정렬됩니다. 이 매크로를 사용하거나 CB_ADDSTRING 메시지를 명시적으로 보낼 수 있습니다.
ComboBox_DeleteString 콤보 상자의 목록에서 지정된 위치에 있는 항목을 삭제합니다. 이 매크로를 사용하거나 CB_DELETESTRING 메시지를 명시적으로 보낼 수 있습니다.
ComboBox_Dir 콤보 상자에 표시된 목록에 이름을 추가합니다. 매크로는 지정된 문자열 및 파일 특성 집합과 일치하는 디렉터리 및 파일의 이름을 추가합니다. 콤보 상자의 목록에 매핑된 드라이브 문자를 추가할 수도 있습니다. 이 매크로를 사용하거나 CB_DIR 메시지를 명시적으로 보낼 수 있습니다.
ComboBox_Enable 콤보 상자 컨트롤을 사용하거나 사용하지 않도록 설정합니다.
ComboBox_FindItemData 지정된 항목 데이터가 있는 콤보 상자 목록에서 첫 번째 항목을 찾습니다. 이 매크로를 사용하거나 CB_FINDSTRING 메시지를 명시적으로 보낼 수 있습니다.
ComboBox_FindString 지정된 문자열로 시작하는 콤보 상자 목록에서 첫 번째 문자열을 찾습니다. 이 매크로를 사용하거나 CB_FINDSTRING 메시지를 명시적으로 보낼 수 있습니다.
ComboBox_FindStringExact 대/소문자를 구분하지 않는다는 점을 제외하고 지정된 문자열과 정확히 일치하는 콤보 상자 목록의 첫 번째 문자열을 찾습니다. 이 매크로를 사용하거나 CB_FINDSTRINGEXACT 메시지를 명시적으로 보낼 수 있습니다.
ComboBox_GetCount 콤보 상자의 목록 상자에 있는 항목 수를 가져옵니다. 이 매크로를 사용하거나 CB_GETCOUNT 메시지를 명시적으로 보낼 수 있습니다.
ComboBox_GetCueBannerText 콤보 상자의 편집 컨트롤에 표시되는 큐 배너 텍스트를 가져옵니다. 이 매크로를 사용하거나 CB_GETCUEBANNER 메시지를 명시적으로 보냅니다.
ComboBox_GetCurSel 콤보 상자에서 현재 선택된 항목의 인덱스를 가져옵니다. 이 매크로를 사용하거나 CB_GETCURSEL 메시지를 명시적으로 보낼 수 있습니다.
ComboBox_GetDroppedControlRect 드롭다운 상태에서 콤보 상자의 화면 좌표를 검색합니다. 이 매크로를 사용하거나 CB_GETDROPPEDCONTROLRECT 메시지를 명시적으로 보낼 수 있습니다.
ComboBox_GetDroppedState 콤보 상자 컨트롤의 드롭 목록이 표시되는지 여부를 확인합니다. 이 매크로를 사용하거나 CB_GETDROPPEDSTATE 메시지를 명시적으로 보낼 수 있습니다.
ComboBox_GetExtendedUI 콤보 상자가 기본 UI(사용자 인터페이스)를 사용하는지 또는 확장 UI를 사용하는지 확인합니다. 이 매크로를 사용하거나 CB_GETEXTENDEDUI 메시지를 명시적으로 보낼 수 있습니다.
ComboBox_GetItemData 콤보 상자의 지정된 목록 항목과 연결된 애플리케이션 정의 값을 가져옵니다. 이 매크로를 사용하거나 CB_GETITEMDATA 메시지를 명시적으로 보낼 수 있습니다.
ComboBox_GetItemHeight 콤보 상자에서 목록 항목의 높이를 검색합니다. 이 매크로를 사용하거나 CB_GETITEMHEIGHT 메시지를 명시적으로 보낼 수 있습니다.
ComboBox_GetLBText 콤보 상자의 목록에서 문자열을 가져옵니다. 이 매크로를 사용하거나 CB_GETLBTEXT 메시지를 명시적으로 보낼 수 있습니다.
ComboBox_GetLBTextLen 콤보 상자의 목록에서 문자열의 길이를 가져옵니다. 이 매크로를 사용하거나 CB_GETLBTEXTLEN 메시지를 명시적으로 보낼 수 있습니다.
ComboBox_GetMinVisible 콤보 상자의 드롭다운 목록에 표시되는 항목의 최소 수를 가져옵니다.
ComboBox_GetText 콤보 상자 컨트롤에서 텍스트를 검색합니다.
ComboBox_GetTextLength 콤보 상자의 텍스트에서 문자 수를 가져옵니다.
ComboBox_InsertItemData 콤보 상자의 지정된 위치에 목록의 항목 데이터를 삽입합니다. 이 매크로를 사용하거나 CB_INSERTSTRING 메시지를 명시적으로 보낼 수 있습니다.
ComboBox_InsertString 지정된 위치에 있는 콤보 상자의 목록에 문자열을 추가합니다. 이 매크로를 사용하거나 CB_INSERTSTRING 메시지를 명시적으로 보낼 수 있습니다.
ComboBox_LimitText 사용자가 콤보 상자의 편집 컨트롤에 입력할 수 있는 텍스트의 길이를 제한합니다. 이 매크로를 사용하거나 CB_LIMITTEXT 메시지를 명시적으로 보낼 수 있습니다.
ComboBox_ResetContent 콤보 상자의 목록 상자 및 편집 컨트롤에서 모든 항목을 제거합니다. 이 매크로를 사용하거나 CB_RESETCONTENT 메시지를 명시적으로 보낼 수 있습니다.
ComboBox_SelectItemData 지정된 항목 데이터가 있는 항목에 대한 콤보 상자의 목록을 검색합니다. 일치하는 항목이 발견되면 해당 항목이 선택됩니다. 이 매크로를 사용하거나 CB_SELECTSTRING 메시지를 명시적으로 보낼 수 있습니다.
ComboBox_SelectString 지정된 문자열의 문자로 시작하는 항목에 대한 콤보 상자의 목록을 검색합니다. 일치하는 항목이 발견되면 해당 항목이 선택됩니다. 이 매크로를 사용하거나 CB_SELECTSTRING 메시지를 명시적으로 보낼 수 있습니다.
ComboBox_SetCueBannerText 콤보 상자의 편집 컨트롤에 대해 표시되는 큐 배너 텍스트를 설정합니다.
ComboBox_SetCurSel 콤보 상자에서 현재 선택된 항목을 설정합니다. 이 매크로를 사용하거나 CB_SETCURSEL 메시지를 명시적으로 보낼 수 있습니다.
ComboBox_SetExtendedUI 기본 UI(사용자 인터페이스) 또는 CBS_DROPDOWN 또는 CBS_DROPDOWNLIST 스타일이 있는 콤보 상자의 확장 UI를 선택합니다. 이 매크로를 사용하거나 CB_SETEXTENDEDUI 메시지를 명시적으로 보낼 수 있습니다.
ComboBox_SetItemData 콤보 상자에서 지정된 목록 항목과 연결된 애플리케이션 정의 값을 설정합니다. 이 매크로를 사용하거나 CB_SETITEMDATA 메시지를 명시적으로 보낼 수 있습니다.
ComboBox_SetItemHeight 콤보 상자에서 목록 항목 또는 선택 필드의 높이를 설정합니다. 이 매크로를 사용하거나 CB_SETITEMHEIGHT 메시지를 명시적으로 보낼 수 있습니다.
ComboBox_SetMinVisible 콤보 상자의 드롭다운 목록에 표시되는 항목의 최소 수를 설정합니다.
ComboBox_SetText 콤보 상자의 텍스트를 설정합니다.
ComboBox_ShowDropdown 콤보 상자에서 목록을 표시하거나 숨깁니다. 이 매크로를 사용하거나 CB_SHOWDROPDOWN 메시지를 명시적으로 보낼 수 있습니다.

메시지

항목 콘텐츠
CB_ADDSTRING 콤보 상자의 목록 상자에 문자열을 추가합니다. 콤보 상자에 CBS_SORT 스타일이 없으면 문자열이 목록 끝에 추가됩니다. 그렇지 않으면 문자열이 목록에 삽입되고 목록이 정렬됩니다.
CB_DELETESTRING 콤보 상자의 목록 상자에서 문자열을 삭제합니다.
CB_DIR 콤보 상자에 표시되는 목록에 이름을 추가합니다. 메시지는 지정된 문자열 및 파일 특성 집합과 일치하는 디렉터리 및 파일의 이름을 추가합니다. CB_DIR은 매핑된 드라이브 문자를 목록에 추가할 수도 있습니다.
CB_FINDSTRING 콤보 상자의 목록 상자에서 지정된 문자열의 문자로 시작하는 항목을 검색합니다.
CB_FINDSTRINGEXACT 콤보 상자에서 lParam 매개 변수에 지정된 문자열과 일치하는 첫 번째 목록 상자 문자열을 찾습니다.
CB_GETCOMBOBOXINFO 지정된 콤보 상자에 대한 정보를 가져옵니다.
CB_GETCOUNT 콤보 상자의 목록 상자에 있는 항목 수를 가져옵니다.
CB_GETCUEBANNER 콤보 상자의 편집 컨트롤에 표시되는 큐 배너 텍스트를 가져옵니다. 이 메시지를 명시적으로 보내거나 ComboBox_GetCueBannerText 매크로를 사용하여 보냅니다.
CB_GETCURSEL 애플리케이션은 CB_GETCURSEL 메시지를 전송하여 콤보 상자의 목록 상자에서 현재 선택된 항목의 인덱스(있는 경우)을 검색합니다.
CB_GETDROPPEDCONTROLRECT 애플리케이션은 CB_GETDROPPEDCONTROLRECT 메시지를 전송하여 드롭다운 상태에서 콤보 상자의 화면 좌표를 검색합니다.
CB_GETDROPPEDSTATE 콤보 상자의 목록 상자를 드롭다운할지 여부를 결정합니다.
CB_GETDROPPEDWIDTH CBS_DROPDOWN 또는 CBS_DROPDOWNLIST 스타일이 있는 콤보 상자 목록 상자의 최소 허용 너비(픽셀)를 가져옵니다.
CB_GETEDITSEL 콤보 상자의 편집 컨트롤에서 현재 선택 항목의 시작 및 끝 문자 위치를 가져옵니다.
CB_GETEXTENDEDUI 콤보 상자에 기본 사용자 인터페이스 또는 확장된 사용자 인터페이스가 있는지 여부를 결정합니다.
CB_GETHORIZONTALEXTENT 목록 상자를 가로로 스크롤할 수 있는 너비(스크롤 가능한 너비)를 가져옵니다. 목록 상자에 가로 스크롤 막대가 있는 경우에만 적용됩니다.
CB_GETITEMDATA 애플리케이션은 CB_GETITEMDATA 메시지를 콤보 상자에 전송하여 콤보 상자의 지정된 항목과 연결된 애플리케이션 제공 값을 검색합니다.
CB_GETITEMHEIGHT 목록 항목의 높이 또는 콤보 상자의 선택 필드를 결정합니다.
CB_GETLBTEXT 콤보 상자 목록에서 문자열을 가져옵니다.
CB_GETLBTEXTLEN 콤보 상자 목록에 있는 문자열의 길이(문자)를 가져옵니다.
CB_GETLOCALE 콤보 상자의 현재 로캘을 가져옵니다. 로캘은 CBS_SORT 스타일과 텍스트가 CB_ADDSTRING 메시지를 사용하여 추가된 콤보 상자에 대해 표시된 텍스트의 올바른 정렬 순서를 결정하는 데 사용됩니다.
CB_GETMINVISIBLE 콤보 상자의 드롭다운 목록에 표시되는 항목의 최소 수를 가져옵니다.
CB_GETTOPINDEX 애플리케이션은 CB_GETTOPINDEX 메시지를 전송하여 콤보 상자의 목록 상자 부분에 있는 첫 번째 표시 항목의 인덱스(0부터 시작)를 검색합니다. 처음에는 인덱스가 0인 항목이 목록 상자의 맨 위에 있지만 목록 상자 콘텐츠가 스크롤된 경우 다른 항목이 맨 위에 있을 수 있습니다.
CB_INITSTORAGE 애플리케이션은 콤보 상자의 목록 상자 부분에 많은 수의 항목을 추가하기 전에 CB_INITSTORAGE 메시지를 보냅니다. 이 메시지는 목록 상자 항목을 저장하기 위한 메모리를 할당합니다.
CB_INSERTSTRING 콤보 상자 목록에 문자열 또는 항목 데이터를 삽입합니다. CB_ADDSTRING 메시지와 달리 CB_INSERTSTRING 메시지는 CBS_SORT 스타일이 있는 목록을 정렬하지 않습니다.
CB_LIMITTEXT 사용자가 콤보 상자의 편집 컨트롤에 입력할 수 있는 텍스트의 길이를 제한합니다.
CB_RESETCONTENT 콤보 상자의 목록 상자 및 편집 컨트롤에서 모든 항목을 제거합니다.
CB_SELECTSTRING 지정된 문자열의 문자로 시작하는 항목에 대한 콤보 상자 목록을 검색합니다. 일치하는 항목이 발견되면 선택되어 편집 컨트롤에 복사됩니다.
CB_SETCUEBANNER 콤보 상자의 편집 컨트롤에 대해 표시되는 큐 배너 텍스트를 설정합니다.
CB_SETCURSEL 애플리케이션은 콤보 상자 목록에서 문자열을 선택하기 위해 CB_SETCURSEL 메시지를 보냅니다. 필요한 경우 목록에서 문자열을 보기로 스크롤합니다. 콤보 상자의 편집 컨트롤에 있는 텍스트는 새 선택을 반영하도록 변경되고 목록의 이전 선택은 제거됩니다.
CB_SETDROPPEDWIDTH 애플리케이션은 CB_SETDROPPEDWIDTH 메시지를 전송하여 CBS_DROPDOWN 또는 CBS_DROPDOWNLIST 스타일로 콤보 상자 목록 상자의 최대 허용 너비(픽셀)를 설정합니다.
CB_SETEDITSEL 애플리케이션은 콤보 상자의 편집 컨트롤에서 문자를 선택하기 위해 CB_SETEDITSEL 메시지를 보냅니다.
CB_SETEXTENDEDUI 애플리케이션이 CB_SETEXTENDEDUI 메시지를 전송하여 CBS_DROPDOWN 또는 CBS_DROPDOWNLIST 스타일이 있는 콤보 상자의 기본 UI 또는 확장 UI를 선택합니다.
CB_SETHORIZONTALEXTENT 애플리케이션은 CB_SETHORIZONTALEXTENT 메시지를 전송하여 목록 상자를 가로로 스크롤할 수 있는 너비(스크롤 가능한 너비)를 픽셀 단위로 설정합니다. 목록 상자의 너비가 이 값보다 작으면 가로 스크롤 막대가 목록 상자의 항목을 가로로 스크롤합니다. 목록 상자의 너비가 이 값보다 크거나 같으면 가로 스크롤 막대가 숨겨지며, 콤보 상자에 CBS_DISABLENOSCROLL 스타일이 있으면 사용하지 않도록 설정됩니다.
CB_SETITEMDATA 애플리케이션은 CB_SETITEMDATA 메시지를 전송하여 콤보 상자의 지정된 항목과 연결된 값을 설정합니다.
CB_SETITEMHEIGHT 애플리케이션은 목록 항목의 높이 또는 콤보 상자의 선택 필드를 설정하기 위해 CB_SETITEMHEIGHT 메시지를 보냅니다.
CB_SETLOCALE 애플리케이션은 CB_SETLOCALE 메시지를 전송하여 콤보 상자의 현재 로캘을 설정합니다. 콤보 상자에 CBS_SORT 스타일이 있고 문자열이 CB_ADDSTRING을 사용하여 추가된 경우 콤보 상자의 로캘은 목록 항목이 정렬되는 방식에 영향을 줍니다.
CB_SETMINVISIBLE 애플리케이션은 CB_SETMINVISIBLE 메시지를 전송하여 콤보 상자의 드롭다운 목록에 표시되는 항목의 최소 수를 설정합니다.
CB_SETTOPINDEX 애플리케이션은 특정 항목이 콤보 상자의 목록 상자에 표시되도록 CB_SETTOPINDEX 메시지를 보냅니다. 시스템은 지정된 항목이 목록 상자의 맨 위에 나타나거나 최대 스크롤 범위에 도달하도록 목록 상자 콘텐츠를 스크롤합니다.
CB_SHOWDROPDOWN 애플리케이션이 CB_SHOWDROPDOWN 메시지를 전송하여 CBS_DROPDOWN 또는 CBS_DROPDOWNLIST 스타일이 있는 콤보 상자의 목록 상자를 표시하거나 숨깁니다.

알림

항목 콘텐츠
CBN_CLOSEUP 콤보 상자의 목록 상자가 닫히면 CBN_CLOSEUP 알림 코드가 전송됩니다. 콤보 상자의 부모 창은 WM_COMMAND 메시지를 통해 이 알림 코드를 수신합니다.
CBN_DBLCLK 사용자가 콤보 상자의 목록 상자에서 문자열을 두 번 클릭하면 CBN_DBLCLK 알림 코드가 전송됩니다. 콤보 상자의 부모 창은 WM_COMMAND 메시지를 통해 이 알림 코드를 수신합니다.
CBN_DROPDOWN CBN_DROPDOWN 알림 코드는 콤보 상자의 목록 상자가 표시되려고 할 때 전송됩니다. 콤보 상자의 부모 창은 WM_COMMAND 메시지를 통해 이 알림 코드를 수신합니다.
CBN_EDITCHANGE CBN_EDITCHANGE 알림 코드는 사용자가 콤보 상자의 편집 컨트롤 부분에 있는 텍스트를 변경했을 수 있는 작업을 수행한 후에 전송됩니다. CBN_EDITUPDATE 알림 코드와 달리 이 알림 코드는 시스템이 화면을 업데이트한 후에 전송됩니다. 콤보 상자의 부모 창은 WM_COMMAND 메시지를 통해 이 알림 코드를 수신합니다.
CBN_EDITUPDATE CBN_EDITUPDATE 알림 코드는 콤보 상자의 편집 컨트롤 부분이 변경된 텍스트를 표시하려고 할 때 전송됩니다. 이 알림 코드는 컨트롤이 텍스트 서식을 지정한 후 텍스트를 표시하기 전에 전송됩니다. 콤보 상자의 부모 창은 WM_COMMAND 메시지를 통해 이 알림 코드를 수신합니다.
CBN_ERRSPACE CBN_ERRSPACE 알림 코드는 콤보 상자가 특정 요청을 충족하기에 충분한 메모리를 할당할 수 없을 때 전송됩니다. 콤보 상자의 부모 창은 WM_COMMAND 메시지를 통해 이 알림 코드를 수신합니다.
CBN_KILLFOCUS CBN_KILLFOCUS 알림 코드는 콤보 상자가 키보드 포커스를 잃으면 전송됩니다. 콤보 상자의 부모 창은 WM_COMMAND 메시지를 통해 이 알림 코드를 수신합니다.
CBN_SELCHANGE 사용자가 콤보 상자의 목록 상자에서 현재 선택 항목을 변경하면 CBN_SELCHANGE 알림 코드가 전송됩니다. 사용자는 목록 상자를 클릭하거나 화살표 키를 사용하여 선택을 변경할 수 있습니다. 콤보 상자의 부모 창은 wParam 매개 변수의 부모 단어에 CBN_SELCHANGE가 있는 WM_COMMAND 메시지 형식으로 이 알림을 받습니다.
CBN_SELENDCANCEL CBN_SELENDCANCEL 알림 코드는 사용자가 항목을 선택한 다음 다른 컨트롤을 선택하거나 대화 상자를 닫을 때 전송됩니다. 사용자의 초기 선택이 무시됨을 나타냅니다. 콤보 상자의 부모 창은 WM_COMMAND 메시지를 통해 이 알림 코드를 수신합니다.
CBN_SELENDOK CBN_SELENDOK 알림 코드는 사용자가 목록 항목을 선택하거나 항목을 선택한 다음 목록을 닫을 때 전송됩니다. 사용자의 선택이 처리됨을 나타냅니다. 콤보 상자의 부모 창은 WM_COMMAND 메시지를 통해 이 알림 코드를 수신합니다.
CBN_SETFOCUS 콤보 상자가 키보드 포커스를 받으면 CBN_SETFOCUS 알림 코드가 전송됩니다. 콤보 상자의 부모 창은 WM_COMMAND 메시지를 통해 이 알림 코드를 수신합니다.
WM_COMPAREITEM 시스템은 WM_COMPAREITEM 메시지를 전송하여 소유자가 그린 콤보 상자 또는 목록 상자의 정렬된 목록에서 새 항목의 상대적 위치를 결정합니다. 애플리케이션이 새 항목을 추가할 때마다 시스템은 이 메시지를 CBS_SORT 또는 LBS_SORT 스타일로 만들어진 콤보 상자 또는 목록 상자의 소유자에게 보냅니다.
WM_DRAWITEM WM_DRAWITEM 메시지는 단추, 콤보 상자, 목록 상자 또는 메뉴의 시각적 측면이 변경된 경우 소유자가 그린 단추, 콤보 상자, 목록 상자 또는 메뉴의 부모 창으로 전송됩니다.
WM_MEASUREITEM WM_MEASUREITEM 메시지는 컨트롤이나 메뉴가 만들어질 때 콤보 상자, 목록 상자, 목록 뷰 컨트롤 또는 메뉴 항목의 소유자 창으로 전송됩니다.

구조체

항목 콘텐츠
COMBOBOXINFO 콤보 상자 상태 정보를 포함합니다.
COMPAREITEMSTRUCT 소유자가 그린 정렬된 목록 상자 또는 콤보 상자에서 두 항목에 대한 식별자 및 애플리케이션 제공 데이터를 제공합니다.
DRAWITEMSTRUCT 소유자가 그린 컨트롤 또는 메뉴 항목을 그리는 방법을 결정하기 위해 소유자 창에 필요한 정보를 제공합니다. 소유자가 그린 컨트롤 또는 메뉴 항목의 소유자 창은 이 구조체에 대한 포인터를 WM_DRAWITEM 메시지의 lParam 매개 변수로 받습니다.
MEASUREITEMSTRUCT 소유자가 그린 컨트롤 또는 메뉴 항목의 차원을 시스템에 알립니다. 이렇게 하면 시스템이 컨트롤과 사용자의 상호 작용을 올바르게 처리할 수 있습니다.

상수

항목 콘텐츠
콤보 상자 스타일 CreateWindow 또는 CreateWindowEx 함수를 사용하여 콤보 상자를 만들려면 COMBOBOX 클래스, 적절한 창 스타일 상수 및 다음 콤보 상자 스타일의 조합을 지정합니다.