다음을 통해 공유

탭(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 구조체는 항목 상태 값을 지원합니다.
탭 컨트롤 스타일 이 섹션에는 지원되는 탭 컨트롤 스타일이 나열되어 있습니다.