탭(Windows 컨트롤)

이 섹션에는 탭 컨트롤과 함께 사용되는 프로그래밍 요소에 대한 정보가 포함되어 있습니다.

개요

항목	콘텐츠
탭 컨트롤 정보	탭 컨트롤은 노트북의 구분선 또는 파일 캐비닛의 레이블과 유사합니다. 애플리케이션은 탭 컨트롤을 사용하여 창 또는 대화 상자의 동일한 영역에 대해 여러 페이지를 정의할 수 있습니다.
탭 컨트롤 사용	이 항목에는 탭 컨트롤을 사용하는 두 가지 예가 포함되어 있습니다.

매크로

항목	콘텐츠
TabCtrl_AdjustRect	창 사각형이 지정된 탭 컨트롤의 표시 영역을 계산하거나 지정된 표시 영역에 해당하는 창 사각형을 계산합니다. 이 매크로를 사용하거나 TCM_ADJUSTRECT 메시지를 명시적으로 보낼 수 있습니다.
TabCtrl_DeleteAllItems	탭 컨트롤에서 모든 항목을 제거합니다. 이 매크로를 사용하거나 TCM_DELETEALLITEMS 메시지를 명시적으로 보낼 수 있습니다.
TabCtrl_DeleteItem	탭 컨트롤에서 항목을 제거합니다. 이 매크로를 사용하거나 TCM_DELETEITEM 메시지를 명시적으로 보낼 수 있습니다.
TabCtrl_DeselectAll	탭 컨트롤의 항목을 초기화하여 TCIS_BUTTONPRESSED 상태로 설정된 모든 항목을 지웁니다. 이 매크로를 사용하거나 TCM_DESELECTALL 메시지를 명시적으로 보낼 수 있습니다.
TabCtrl_GetCurFocus	탭 컨트롤에 포커스가 있는 항목의 인덱스를 반환합니다. 이 매크로를 사용하거나 TCM_GETCURFOCUS 메시지를 명시적으로 보낼 수 있습니다.
TabCtrl_GetCurSel	탭 컨트롤에서 현재 선택된 탭을 결정합니다. 이 매크로를 사용하거나 TCM_GETCURSEL 메시지를 명시적으로 보낼 수 있습니다.
TabCtrl_GetExtendedStyle	현재 탭 컨트롤에 사용 중인 확장 스타일을 검색합니다. 이 매크로를 사용하거나 TCM_GETEXTENDEDSTYLE 메시지를 명시적으로 보낼 수 있습니다.
TabCtrl_GetImageList	탭 컨트롤과 연결된 이미지 목록을 검색합니다. 이 매크로를 사용하거나 TCM_GETIMAGELIST 메시지를 명시적으로 보낼 수 있습니다.
TabCtrl_GetItem	탭 컨트롤의 탭에 대한 정보를 검색합니다. 이 매크로를 사용하거나 TCM_GETITEM 메시지를 명시적으로 보낼 수 있습니다.
TabCtrl_GetItemCount	탭 컨트롤에서 탭 수를 검색합니다. 이 매크로를 사용하거나 TCM_GETITEMCOUNT 메시지를 명시적으로 보낼 수 있습니다.
TabCtrl_GetItemRect	탭 컨트롤의 탭에 대한 경계 사각형을 검색합니다. 이 매크로를 사용하거나 TCM_GETIMRECT 메시지를 명시적으로 보낼 수 있습니다.
TabCtrl_GetRowCount	탭 컨트롤에서 탭의 현재 행 수를 검색합니다. 이 매크로를 사용하거나 TCM_GETROWCOUNT 메시지를 명시적으로 보낼 수 있습니다.
TabCtrl_GetToolTips	탭 컨트롤과 연결된 도구 설명 컨트롤에 대한 핸들을 검색합니다. 이 매크로를 사용하거나 TCM_GETTOOLTIPS 메시지를 명시적으로 보낼 수 있습니다.
TabCtrl_GetUnicodeFormat	컨트롤의 유니코드 문자 형식 플래그를 검색합니다. 이 매크로를 사용하거나 TCM_GETUNICODEFORMAT 메시지를 명시적으로 보낼 수 있습니다.
TabCtrl_HighlightItem	탭 항목의 강조 표시 상태를 설정합니다. 이 매크로를 사용하거나 TCM_HIGHLIGHTITEM 메시지를 명시적으로 보낼 수 있습니다.
TabCtrl_HitTest	지정된 화면 위치에 있는 탭(있는 경우)을 결정합니다. 이 매크로를 사용하거나 TCM_HITTEST 메시지를 명시적으로 보낼 수 있습니다.
TabCtrl_InsertItem	탭 컨트롤에 새 탭을 삽입합니다. 이 매크로를 사용하거나 TCM_INSERTITEM 메시지를 명시적으로 보낼 수 있습니다.
TabCtrl_RemoveImage	탭 컨트롤의 이미지 목록에서 이미지를 제거합니다. 이 매크로를 사용하거나 TCM_REMOVEIMAGE 메시지를 명시적으로 보낼 수 있습니다.
TabCtrl_SetCurFocus	탭 컨트롤의 지정된 탭에 포커스를 설정합니다. 이 매크로를 사용하거나 TCM_SETCURFOCUS 메시지를 명시적으로 보낼 수 있습니다.
TabCtrl_SetCurSel	탭 컨트롤에서 탭을 선택합니다. 이 매크로를 사용하거나 TCM_SETCURSEL 메시지를 명시적으로 보낼 수 있습니다.
TabCtrl_SetExtendedStyle	탭 컨트롤이 사용할 확장 스타일을 설정합니다. 이 매크로를 사용하거나 TCM_SETEXTENDEDSTYLE 메시지를 명시적으로 보낼 수 있습니다.
TabCtrl_SetImageList	탭 컨트롤에 이미지 목록을 할당합니다. 이 매크로를 사용하거나 TCM_SETIMAGELIST 메시지를 명시적으로 보낼 수 있습니다.
TabCtrl_SetItem	탭 특성의 일부 또는 전부를 설정합니다. 이 매크로를 사용하거나 TCM_SETITEM 메시지를 명시적으로 보낼 수 있습니다.
TabCtrl_SetItemExtra	탭 컨트롤에서 애플리케이션 정의 데이터용으로 예약된 탭당 바이트 수를 설정합니다. 이 매크로를 사용하거나 TCM_SETITEMEXTRA 메시지를 명시적으로 보낼 수 있습니다.
TabCtrl_SetItemSize	고정 너비 또는 소유자가 그린 탭 컨트롤에서 탭의 너비와 높이를 설정합니다. 이 매크로를 사용하거나 TCM_SETITEMSIZE 메시지를 명시적으로 보낼 수 있습니다.
TabCtrl_SetMinTabWidth	탭 컨트롤에서 항목의 최소 너비를 설정합니다. 이 매크로를 사용하거나 TCM_SETMINTABWIDTH 메시지를 명시적으로 보낼 수 있습니다.
TabCtrl_SetPadding	탭 컨트롤에서 각 탭의 아이콘과 레이블 주변의 공간(패딩)을 설정합니다. 이 매크로를 사용하거나 TCM_SETPADDING 메시지를 명시적으로 보낼 수 있습니다.
TabCtrl_SetToolTips	탭 컨트롤에 도구 설명 컨트롤을 할당합니다. 이 매크로를 사용하거나 TCM_SETTOOLTIPS 메시지를 명시적으로 보낼 수 있습니다.
TabCtrl_SetUnicodeFormat	컨트롤의 유니코드 문자 형식 플래그를 설정합니다. 이 메시지를 통해 컨트롤을 다시 만들지 않고도 런타임에 컨트롤에서 사용하는 문자 집합을 변경할 수 있습니다. 이 매크로를 사용하거나 TCM_SETUNICODEFORMAT 메시지를 명시적으로 보낼 수 있습니다.

메시지

항목	콘텐츠
TCM_ADJUSTRECT	창 사각형이 지정된 탭 컨트롤의 표시 영역을 계산하거나 지정된 표시 영역에 해당하는 창 사각형을 계산합니다. 이 메시지를 명시적으로 보내거나 TabCtrl_AdjustRect 매크로를 사용하여 보낼 수 있습니다.
TCM_DELETEALLITEMS	탭 컨트롤에서 모든 항목을 제거합니다. 이 메시지를 명시적으로 보내거나 TabCtrl_DeleteAllItems 매크로를 사용하여 보낼 수 있습니다.
TCM_DELETEITEM	탭 컨트롤에서 항목을 제거합니다. 이 메시지를 명시적으로 보내거나 TabCtrl_DeleteItem 매크로를 사용하여 보낼 수 있습니다.
TCM_DESELECTALL	탭 컨트롤의 항목을 초기화하여 TCIS_BUTTONPRESSED 상태로 설정된 모든 항목을 지웁니다. 이 메시지를 명시적으로 보내거나 TabCtrl_DeselectAll 매크로를 사용하여 보낼 수 있습니다.
TCM_GETCURFOCUS	탭 컨트롤에 포커스가 있는 항목의 인덱스를 반환합니다. 이 메시지를 명시적으로 보내거나 TabCtrl_GetCurFocus 매크로를 사용하여 보낼 수 있습니다.
TCM_GETCURSEL	탭 컨트롤에서 현재 선택된 탭을 결정합니다. 이 메시지를 명시적으로 보내거나 TabCtrl_GetCurSel 매크로를 사용하여 보낼 수 있습니다.
TCM_GETEXTENDEDSTYLE	현재 탭 컨트롤에 사용 중인 확장 스타일을 검색합니다. 이 메시지를 명시적으로 보내거나 TabCtrl_GetExtendedStyle 매크로를 사용하여 보낼 수 있습니다.
TCM_GETIMAGELIST	탭 컨트롤과 연결된 이미지 목록을 검색합니다. 이 메시지를 명시적으로 보내거나 TabCtrl_GetImageList 매크로를 사용하여 보낼 수 있습니다.
TCM_GETITEM	탭 컨트롤의 탭에 대한 정보를 검색합니다. 이 메시지를 명시적으로 보내거나 TabCtrl_GetItem 매크로를 사용하여 보낼 수 있습니다.
TCM_GETITEMCOUNT	탭 컨트롤에서 탭 수를 검색합니다. 명시적으로 또는 TabCtrl_GetItemCount 매크로를 사용하여 이 메시지를 보낼 수 있습니다.
TCM_GETITEMRECT	탭 컨트롤의 탭에 대한 경계 사각형을 검색합니다. 이 메시지를 명시적으로 보내거나 TabCtrl_GetItemRect 매크로를 사용하여 보낼 수 있습니다.
TCM_GETROWCOUNT	탭 컨트롤에서 탭의 현재 행 수를 검색합니다. 이 메시지를 명시적으로 보내거나 TabCtrl_GetRowCount 매크로를 사용하여 보낼 수 있습니다.
TCM_GETTOOLTIPS	탭 컨트롤과 연결된 도구 설명 컨트롤에 대한 핸들을 검색합니다. 이 메시지를 명시적으로 보내거나 TabCtrl_GetToolTips 매크로를 사용하여 보낼 수 있습니다.
TCM_GETUNICODEFORMAT	컨트롤의 유니코드 문자 형식 플래그를 검색합니다. 이 메시지를 명시적으로 보내거나 TabCtrl_GetUnicodeFormat 매크로를 사용할 수 있습니다.
TCM_HIGHLIGHTITEM	탭 항목의 강조 표시 상태를 설정합니다. 이 메시지를 명시적으로 보내거나 TabCtrl_HighlightItem 매크로를 사용하여 보낼 수 있습니다.
TCM_HITTEST	지정된 화면 위치에 있는 탭(있는 경우)을 결정합니다. 이 메시지를 명시적으로 보내거나 TabCtrl_HitTest 매크로를 사용하여 보낼 수 있습니다.
TCM_INSERTITEM	탭 컨트롤에 새 탭을 삽입합니다. 이 메시지를 명시적으로 보내거나 TabCtrl_InsertItem 매크로를 사용하여 보낼 수 있습니다.
TCM_REMOVEIMAGE	탭 컨트롤의 이미지 목록에서 이미지를 제거합니다. 이 메시지를 명시적으로 보내거나 TabCtrl_RemoveImage 매크로를 사용하여 보낼 수 있습니다.
TCM_SETCURFOCUS	탭 컨트롤의 지정된 탭에 포커스를 설정합니다. 이 메시지를 명시적으로 보내거나 TabCtrl_SetCurFocus 매크로를 사용하여 보낼 수 있습니다.
TCM_SETCURSEL	탭 컨트롤에서 탭을 선택합니다. 이 메시지를 명시적으로 보내거나 TabCtrl_SetCurSel 매크로를 사용하여 보낼 수 있습니다.
TCM_SETEXTENDEDSTYLE	탭 컨트롤이 사용할 확장 스타일을 설정합니다. 이 메시지를 명시적으로 보내거나 TabCtrl_SetExtendedStyle 매크로를 사용하여 보낼 수 있습니다.
TCM_SETIMAGELIST	탭 컨트롤에 이미지 목록을 할당합니다. 명시적으로 또는 TabCtrl_SetImageList 매크로를 사용하여 이 메시지를 보낼 수 있습니다.
TCM_SETITEM	탭 특성의 일부 또는 전부를 설정합니다. 이 메시지를 명시적으로 보내거나 TabCtrl_SetItem 매크로를 사용하여 보낼 수 있습니다.
TCM_SETITEMEXTRA	탭 컨트롤에서 애플리케이션 정의 데이터용으로 예약된 탭당 바이트 수를 설정합니다. 이 메시지를 명시적으로 보내거나 TabCtrl_SetItemExtra 매크로를 사용하여 보낼 수 있습니다.
TCM_SETITEMSIZE	고정 너비 또는 소유자가 그린 탭 컨트롤에서 탭의 너비와 높이를 설정합니다. 이 메시지를 명시적으로 보내거나 TabCtrl_SetItemSize 매크로를 사용하여 보낼 수 있습니다.
TCM_SETMINTABWIDTH	탭 컨트롤에서 항목의 최소 너비를 설정합니다. 이 메시지를 명시적으로 보내거나 TabCtrl_SetMinTabWidth 매크로를 사용하여 보낼 수 있습니다.
TCM_SETPADDING	탭 컨트롤에서 각 탭의 아이콘과 레이블 주변의 공간(패딩)을 설정합니다. 이 메시지를 명시적으로 보내거나 TabCtrl_SetPadding 매크로를 사용하여 보낼 수 있습니다.
TCM_SETTOOLTIPS	탭 컨트롤에 도구 설명 컨트롤을 할당합니다. 이 메시지를 명시적으로 보내거나 TabCtrl_SetToolTips 매크로를 사용하여 보낼 수 있습니다.
TCM_SETUNICODEFORMAT	컨트롤의 유니코드 문자 형식 플래그를 설정합니다. 이 메시지를 통해 컨트롤을 다시 만들지 않고도 런타임에 컨트롤에서 사용하는 문자 집합을 변경할 수 있습니다. 이 메시지를 명시적으로 보내거나 TabCtrl_SetUnicodeFormat 매크로를 사용할 수 있습니다.

알림

항목	콘텐츠
NM_CLICK(탭)	사용자가 컨트롤 내에서 마우스 왼쪽 단추를 클릭했음을 탭 컨트롤의 부모 창에 알립니다. 이 알림 코드는 WM_NOTIFY 메시지 형식으로 전송됩니다.
NM_DBLCLK(탭)	사용자가 컨트롤 내에서 마우스 왼쪽 단추를 두 번 클릭했음을 탭 컨트롤의 부모 창에 알립니다. 이 알림은 WM_NOTIFY 메시지 형식으로 전송됩니다.
NM_RCLICK(탭)	사용자가 컨트롤 내에서 마우스 오른쪽 단추를 클릭했음을 탭 컨트롤의 부모 창에 알립니다. 이 알림 코드는 WM_NOTIFY 메시지 형식으로 전송됩니다.
NM_RDBLCLK(탭)	사용자가 컨트롤 내에서 마우스 오른쪽 단추를 두 번 클릭했음을 탭 컨트롤의 부모 창에 알립니다. 이 알림 코드는 WM_NOTIFY 메시지 형식으로 전송됩니다.
NM_RELEASEDCAPTURE(탭)	컨트롤이 마우스 캡처를 해제하고 있음을 탭 컨트롤의 부모 창에 알립니다. 이 알림 코드는 WM_NOTIFY 메시지 형식으로 전송됩니다.
TCN_FOCUSCHANGE	단추 포커스가 변경되었음을 탭 컨트롤의 부모 창에 알립니다. 이 알림 코드는 WM_NOTIFY 메시지 형식으로 전송됩니다.
TCN_GETOBJECT	TCS_EX_REGISTERDROP 확장 스타일이 있고 개체가 컨트롤의 탭 항목 위로 끌 때 탭 컨트롤에서 보냅니다. 이 알림 코드는 WM_NOTIFY 메시지 형식으로 전송됩니다.
TCN_KEYDOWN	키를 눌렀음을 탭 컨트롤의 부모 창에 알립니다. 이 알림 코드는 WM_NOTIFY 메시지 형식으로 전송됩니다.
TCN_SELCHANGE	현재 선택된 탭이 변경되었음을 탭 컨트롤의 부모 창에 알립니다. 이 알림 코드는 WM_NOTIFY 메시지 형식으로 전송됩니다.
TCN_SELCHANGING	현재 선택된 탭이 변경되려고 한다는 것을 탭 컨트롤의 부모 창에 알립니다. 이 알림 코드는 WM_NOTIFY 메시지 형식으로 전송됩니다.

구조체

항목	콘텐츠
NMTCKEYDOWN	탭 컨트롤의 키 누름에 대한 정보를 포함합니다. TCN_KEYDOWN 알림 코드와 함께 사용됩니다. 이 구조체는 TC_KEYDOWN 구조체를 대체합니다.
TCHITTESTINFO	적중 테스트에 대한 정보를 포함합니다. 이 구조체는 TC_HITTESTINFO 구조체를 대체합니다.
TCITEM	탭 항목의 특성을 지정하거나 받습니다. TCM_INSERTITEM, TCM_GETITEM 및 TCM_SETITEM 메시지와 함께 사용됩니다. 이 구조체는 TC_ITEM 구조체를 대체합니다.
TCITEMHEADER	탭의 특성을 지정하거나 수신합니다. TCM_INSERTITEM, TCM_GETITEM 및 TCM_SETITEM 메시지와 함께 사용됩니다. 이 구조체는 TC_ITEMHEADER 구조체를 대체합니다.

상수

항목	콘텐츠
탭 컨트롤 확장 스타일	이제 탭 컨트롤이 확장 스타일을 지원합니다. 이러한 스타일은 TCM_GETEXTENDEDSTYLE 및 TCM_SETEXTENDEDSTYLE 메시지를 사용하여 조작되며 CreateWindowEx에 전달되는 확장 창 스타일과 혼동해서는 안 됩니다.
탭 컨트롤 항목 상태	탭 컨트롤 항목은 이제 TCM_DESELECTALL 메시지를 지원하는 항목 상태를 지원합니다. 또한 TCITEM 구조체는 항목 상태 값을 지원합니다.
탭 컨트롤 스타일	이 섹션에는 지원되는 탭 컨트롤 스타일이 나열되어 있습니다.