`CTabCtrl` 수업

아티클
10/12/2023

Windows의 공용 탭 컨트롤의 기능을 제공합니다.

구문

class CTabCtrl : public CWnd

멤버

Public 생성자

속성	설명
`CTabCtrl::CTabCtrl`	`CTabCtrl` 개체를 생성합니다.

공용 메서드

이름	설명
`CTabCtrl::AdjustRect`	창 사각형이 지정된 탭 컨트롤의 표시 영역을 계산하거나 지정된 표시 영역에 해당하는 창 사각형을 계산합니다.
`CTabCtrl::Create`	탭 컨트롤을 만들어 개체 인스턴스 `TabCtrl` 에 연결합니다.
`CTabCtrl::CreateEx`	지정된 Windows 확장 스타일을 사용하여 탭 컨트롤을 만들고 개체 인스턴스 `CTabCtrl` 에 연결합니다.
`CTabCtrl::DeleteAllItems`	탭 컨트롤에서 모든 항목을 제거합니다.
`CTabCtrl::DeleteItem`	탭 컨트롤에서 항목을 제거합니다.
`CTabCtrl::DeselectAll`	탭 컨트롤의 항목을 다시 설정하여 누른 항목을 지웁니다.
`CTabCtrl::DrawItem`	탭 컨트롤의 지정된 항목을 그립니다.
`CTabCtrl::GetCurFocus`	탭 컨트롤의 현재 포커스가 있는 탭을 검색합니다.
`CTabCtrl::GetCurSel`	탭 컨트롤에서 현재 선택된 탭을 결정합니다.
`CTabCtrl::GetExtendedStyle`	현재 탭 컨트롤에 사용 중인 확장 스타일을 검색합니다.
`CTabCtrl::GetImageList`	탭 컨트롤과 연결된 이미지 목록을 검색합니다.
`CTabCtrl::GetItem`	탭 컨트롤의 탭에 대한 정보를 검색합니다.
`CTabCtrl::GetItemCount`	탭 컨트롤에서 탭 수를 검색합니다.
`CTabCtrl::GetItemRect`	탭 컨트롤의 탭에 대한 경계 사각형을 검색합니다.
`CTabCtrl::GetItemState`	표시된 탭 컨트롤 항목의 상태를 검색합니다.
`CTabCtrl::GetRowCount`	탭 컨트롤에서 탭의 현재 행 수를 검색합니다.
`CTabCtrl::GetToolTips`	탭 컨트롤과 연결된 도구 설명 컨트롤의 핸들을 검색합니다.
`CTabCtrl::HighlightItem`	탭 항목의 강조 표시 상태를 설정합니다.
`CTabCtrl::HitTest`	지정된 화면 위치에 있는 탭(있는 경우)을 결정합니다.
`CTabCtrl::InsertItem`	탭 컨트롤에 새 탭을 삽입합니다.
`CTabCtrl::RemoveImage`	탭 컨트롤의 이미지 목록에서 이미지를 제거합니다.
`CTabCtrl::SetCurFocus`	탭 컨트롤의 지정된 탭에 포커스를 설정합니다.
`CTabCtrl::SetCurSel`	탭 컨트롤에서 탭을 선택합니다.
`CTabCtrl::SetExtendedStyle`	탭 컨트롤의 확장 스타일을 설정합니다.
`CTabCtrl::SetImageList`	탭 컨트롤에 이미지 목록을 할당합니다.
`CTabCtrl::SetItem`	탭 특성의 일부 또는 전부를 설정합니다.
`CTabCtrl::SetItemExtra`	탭 컨트롤에서 애플리케이션 정의 데이터용으로 예약된 탭당 바이트 수를 설정합니다.
`CTabCtrl::SetItemSize`	항목의 너비와 높이를 설정합니다.
`CTabCtrl::SetItemState`	표시된 탭 컨트롤 항목의 상태를 설정합니다.
`CTabCtrl::SetMinTabWidth`	탭 컨트롤에서 항목의 최소 너비를 설정합니다.
`CTabCtrl::SetPadding`	탭 컨트롤의 각 탭 아이콘과 레이블 주위에 공백(안쪽 여백)을 설정합니다.
`CTabCtrl::SetToolTips`	도구 설명 컨트롤을 탭 컨트롤에 할당합니다.

설명

"탭 컨트롤"은 Notebook의 구분선 또는 파일 캐비닛의 레이블과 유사합니다. 애플리케이션은 탭 컨트롤을 사용하여 창 또는 대화 상자의 동일한 영역에 대해 여러 페이지를 정의할 수 있습니다. 각 페이지는 사용자가 해당 탭을 선택할 때 애플리케이션이 표시하는 정보 집합 또는 컨트롤 그룹으로 구성됩니다. 특수한 유형의 탭 컨트롤은 단추처럼 보이는 탭을 표시합니다. 단추를 클릭하면 페이지를 표시하는 대신 명령이 즉시 수행됩니다.

이 컨트롤(따라서 CTabCtrl 클래스)은 Windows 95/98 및 Windows NT 버전 3.51 이상에서 실행되는 프로그램에서만 사용할 수 있습니다.

자세한 CTabCtrl내용은 컨트롤 및 사용을 CTabCtrl참조하세요.

상속 계층

CObject
CCmdTarget
CWnd

CTabCtrl

요구 사항

머리글: afxcmn.h

`CTabCtrl::AdjustRect`

창 사각형이 지정된 탭 컨트롤의 표시 영역을 계산하거나 지정된 표시 영역에 해당하는 창 사각형을 계산합니다.

void AdjustRect(BOOL bLarger,   LPRECT lpRect);

매개 변수

bLarger
수행할 작업을 나타냅니다. 이 매개 변수인 TRUElpRect 경우 표시 사각형을 지정하고 해당 창 사각형을 받습니다. 이 매개 변수인 FALSElpRect 경우 창 사각형을 지정하고 해당 표시 사각형을 받습니다.

lpRect
지정된 사각형을 RECT 지정하고 계산된 사각형을 받는 구조체에 대한 포인터입니다.

예시

void CTabDlg::OnSize(UINT nType, int cx, int cy)
{
   CDialog::OnSize(nType, cx, cy);

   if (m_TabCtrl.m_hWnd == NULL)
      return; // Return if window is not created yet.

   RECT rect;

   // Get size of dialog window.
   GetClientRect(&rect);

   // Adjust the rectangle to fit the tab control into the
   // dialog's client rectangle.
   m_TabCtrl.AdjustRect(FALSE, &rect);

   // Move the tab control to the new position and size.
   m_TabCtrl.MoveWindow(&rect, TRUE);
}

`CTabCtrl::Create`

탭 컨트롤을 만들어 개체 인스턴스 CTabCtrl 에 연결합니다.

virtual BOOL Create(
    DWORD dwStyle,
    const RECT& rect,
    CWnd* pParentWnd,
    UINT nID);

매개 변수

dwStyle
탭 컨트롤의 스타일을 지정합니다. Windows SDK에 설명된 탭 컨트롤 스타일의 조합을 적용합니다. 컨트롤에도 적용할 수 있는 창 스타일 목록은 비고를 참조하세요.

rect
탭 컨트롤의 크기와 위치를 지정합니다. 개체 또는 RECT 구조체 CRect 일 수 있습니다.

pParentWnd
탭 컨트롤의 부모 창(일반적으로 .)을 CDialog지정합니다. 해서는 안 됩니다 NULL.

nID
탭 컨트롤의 ID를 지정합니다.

Return Value

TRUE 개체 초기화에 성공하면 FALSE.

설명

두 단계로 개체를 CTabCtrl 생성합니다. 먼저 생성자를 호출한 다음 Create호출합니다. 그러면 탭 컨트롤이 만들어지고 개체에 CTabCtrl 연결됩니다.

탭 컨트롤 스타일 외에도 탭 컨트롤에 다음 창 스타일을 적용할 수 있습니다.

WS_CHILD: 탭 컨트롤을 나타내는 자식 창을 만듭니다. WS_POPUP 스타일과 함께 사용할 수 없습니다.
WS_VISIBLE: 처음에 표시되는 탭 컨트롤을 만듭니다.
WS_DISABLED: 처음에 사용하지 않도록 설정된 창을 만듭니다.
WS_GROUP: 사용자가 화살표 키를 사용하여 한 컨트롤에서 다음 컨트롤로 이동할 수 있는 컨트롤 그룹의 첫 번째 컨트롤을 지정합니다. 첫 번째 컨트롤 뒤의 스타일로 WS_GROUP정의된 모든 컨트롤은 동일한 그룹에 속합니다. 스타일이 있는 WS_GROUP다음 컨트롤은 스타일 그룹을 종료하고 다음 그룹(즉, 다음 그룹이 시작되는 위치에서 한 그룹이 종료됨)을 시작합니다.
WS_TABSTOP: TAB 키를 사용하여 사용자가 이동할 수 있는 컨트롤 수 중 하나를 지정합니다. TAB 키를 누르면 사용자가 스타일에 지정된 다음 컨트롤로 WS_TABSTOP이동합니다.

확장 창 스타일을 사용하여 탭 컨트롤을 만들려면 대신 호출 CTabCtrl::CreateEx 합니다 Create.

예시

// Assuming you have a member variable m_TabCtrl, that is a CTabCtrl
// object, you can use the following to create a tab control.

m_TabCtrl.Create(TCS_TABS | TCS_FIXEDWIDTH | WS_CHILD | WS_VISIBLE,
                 rect, this, IDC_MYTAB);

// This creates a tab control with the given styles, and with
// an ID of IDC_MYTAB.

`CTabCtrl::CreateEx`

컨트롤(자식 창)을 만들어 개체와 연결 CTabCtrl 합니다.

virtual BOOL CreateEx(
    DWORD dwExStyle,
    DWORD dwStyle,
    const RECT& rect,
    CWnd* pParentWnd,
    UINT nID);

매개 변수

dwExStyle
만들 컨트롤의 확장 스타일을 지정합니다. 확장된 Windows 스타일 목록은 Windows SDK의 매개 변수 CreateWindowEx 를 참조 dwExStyle 하세요.

dwStyle
탭 컨트롤의 스타일을 지정합니다. Windows SDK에 설명된 탭 컨트롤 스타일의 조합을 적용합니다. 컨트롤에도 Create 적용할 수 있는 창 스타일 목록은 주의 내용을 참조하세요.

rect
생성할 RECT 창의 크기와 위치를 설명하는 구조체에 대한 참조로, 클라이언트 좌표로 pParentWnd표시됩니다.

pParentWnd
컨트롤의 부모 창에 대한 포인터입니다.

nID
컨트롤의 자식 창 ID입니다.

Return Value

성공하면 0이 아닌 경우 0입니다.

설명

Windows 확장 스타일 서문WS_EX_으로 지정된 확장 Windows 스타일을 적용하는 대신 Create 사용합니다CreateEx.

CreateEx 에서 지정한 확장된 Windows 스타일을 사용하여 컨트롤을 dwExStyle만듭니다. 를 사용하여 SetExtendedStyle컨트롤에 특정한 확장 스타일을 설정합니다. 예를 들어 이러한 스타일을 설정하는 데는 사용 CreateEx 하지만 다음과 같은 WS_EX_CONTEXTHELPTCS_EX_FLATSEPARATORS스타일을 설정하는 데 사용합니다SetExtendedStyle. 자세한 내용은 Windows SDK의 Tab Control 확장 스타일에 설명된 스타일을 참조하세요.

`CTabCtrl::CTabCtrl`

CTabCtrl 개체를 생성합니다.

CTabCtrl();

`CTabCtrl::DeleteAllItems`

탭 컨트롤에서 모든 항목을 제거합니다.

BOOL DeleteAllItems();

Return Value

성공하면 0이 아니고, 그렇지 않으면 0입니다.

`CTabCtrl::DeleteItem`

탭 컨트롤에서 지정된 항목을 제거합니다.

BOOL DeleteItem(int nItem);

매개 변수

nItem
삭제할 항목의 0부터 시작하는 값입니다.

Return Value

성공하면 0이 아니고, 그렇지 않으면 0입니다.

예시

// This example assumes that there is a CTabCtrl member of the
// CTabDlg class named m_TabCtrl.  On a button handler
// called OnDeleteItem of the dialog box the tab control will
// delete the 0 indexed item.

void CTabDlg::OnDeleteItem()
{
   // Delete the first item in the tab control.
   m_TabCtrl.DeleteItem(0);
}

`CTabCtrl::DeselectAll`

탭 컨트롤의 항목을 다시 설정하여 누른 항목을 지웁니다.

void DeselectAll(BOOL fExcludeFocus);

매개 변수

fExcludeFocus
항목 선택 취소의 범위를 지정하는 플래그입니다. 이 매개 변수를 FALSE설정하면 모든 탭 단추가 다시 설정됩니다. 설정 TRUE되면 현재 선택된 탭 항목을 제외한 모든 탭 항목이 다시 설정됩니다.

설명

이 멤버 함수는 Windows SDK에 설명된 대로 Win32 메시지 TCM_DESELECTALL의 동작을 구현합니다.

`CTabCtrl::DrawItem`

소유자 그리기 탭 컨트롤의 시각적 측면이 변경되면 프레임워크에서 호출됩니다.

virtual void DrawItem(LPDRAWITEMSTRUCT lpDrawItemStruct);

매개 변수

lpDrawItemStruct
그릴 항목을 설명하는 구조체에 대한 포인터 DRAWITEMSTRUCT 입니다.

설명

구조체의 DRAWITEMSTRUCT 멤버는 itemAction 수행할 그리기 동작을 정의합니다.

기본적으로 이 멤버 함수는 아무 작업도 수행하지 않습니다. 소유자 그리 CTabCtrl 기 개체에 대한 그리기를 구현하려면 이 멤버 함수를 재정의합니다.

애플리케이션은 이 멤버 함수가 종료되기 전에 제공 lpDrawItemStruct 된 표시 컨텍스트에 대해 선택한 모든 GDI(그래픽 디바이스 인터페이스) 개체를 복원해야 합니다.

`CTabCtrl::GetCurFocus`

현재 포커스가 있는 탭의 인덱스를 검색합니다.

int GetCurFocus() const;

Return Value

현재 포커스가 있는 탭의 인덱스(0부터 시작하는 인덱스)입니다.

`CTabCtrl::GetCurSel`

탭 컨트롤에서 현재 선택한 탭을 검색합니다.

int GetCurSel() const;

Return Value

성공한 경우 선택한 탭의 인덱스(0부터 시작하는 인덱스) 또는 탭이 선택되지 않은 경우 -1입니다.

`CTabCtrl::GetExtendedStyle`

현재 탭 컨트롤에 사용 중인 확장 스타일을 검색합니다.

DWORD GetExtendedStyle();

Return Value

탭 컨트롤에 현재 사용 중인 확장 스타일을 나타냅니다. 이 값은 Windows SDK에 설명된 대로 탭 컨트롤 확장 스타일의 조합입니다.

설명

이 멤버 함수는 Windows SDK에 설명된 대로 Win32 메시지 TCM_GETEXTENDEDSTYLE의 동작을 구현합니다.

`CTabCtrl::GetImageList`

탭 컨트롤에 연관된 이미지 목록을 검색합니다.

CImageList* GetImageList() const;

Return Value

성공하면 탭 컨트롤의 이미지 목록에 대한 포인터입니다. 그렇지 않으면 . NULL

`CTabCtrl::GetItem`

탭 컨트롤의 탭에 대한 정보를 검색합니다.

BOOL GetItem(int nItem,   TCITEM* pTabCtrlItem) const;

매개 변수

nItem
탭의 인덱스(0부터 시작하는 인덱스)입니다.

pTabCtrlItem
검색할 TCITEM 정보를 지정하는 데 사용되는 구조체에 대한 포인터입니다. 탭에 대한 정보를 받는 데도 사용됩니다. 이 구조체는 , GetItem및 멤버 함수와 SetItem 함께 InsertItem사용됩니다.

Return Value

성공하면 반환하고, FALSE 그렇지 않으면 반환합니다TRUE.

설명

메시지가 전송되면 멤버는 mask 반환할 특성을 지정합니다. 멤버가 mask 값을 지정하는 TCIF_TEXT 경우 멤버는 pszText 항목 텍스트를 받는 버퍼의 주소를 포함해야 하며 멤버는 cchTextMax 버퍼의 크기를 지정해야 합니다.

mask

검색하거나 설정할 구조체 멤버를 지정하는 TCITEM 값입니다. 이 멤버는 0이거나 다음 값의 조합일 수 있습니다.
- TCIF_TEXT: 멤버가 pszText 유효합니다.
- TCIF_IMAGE: 멤버가 iImage 유효합니다.
- TCIF_PARAM: 멤버가 lParam 유효합니다.
- TCIF_RTLREADING: 텍스트는 pszText 히브리어 또는 아랍어 시스템에서 오른쪽에서 왼쪽으로 읽기 순서를 사용하여 표시됩니다.
- TCIF_STATE: 멤버가 dwState 유효합니다.
pszText

구조에 탭에 대한 정보가 포함된 경우 탭 텍스트가 포함된 null로 끝나는 문자열에 대한 포인터입니다. 구조체가 정보를 수신하는 경우 이 멤버는 탭 텍스트를 받는 버퍼의 주소를 지정합니다.
cchTextMax

로 가리키는 pszText버퍼의 크기입니다. 구조체에서 정보를 받지 못하는 경우 이 멤버는 무시됩니다.
iImage 탭 컨트롤의 이미지 목록에 인덱싱하거나 탭에 대한 이미지가 없으면 -1입니다.
lParam

탭과 연결된 애플리케이션 정의 데이터입니다. 탭당 4바이트 이상의 애플리케이션 정의 데이터가 있는 경우 애플리케이션은 구조를 정의하고 구조 대신 TCITEM 사용해야 합니다. 애플리케이션 정의 구조체의 첫 번째 멤버는 구조체여야 TCITEMHEADER합니다. 구조체 TCITEMHEADER 는 구조체와 TCITEM 동일하지만 멤버는 lParam 없습니다. 구조체의 크기와 구조체의 TCITEMHEADER 크기 간의 차이는 탭당 추가 바이트 수와 같아야 합니다.

예시

// In this example a CTabCtrl data member, m_TabCtrl, changes the
// text of the tabs in the tab control.  A call to GetItem is used
// to get the current text, and then the text is changed.  A call
// to SetItem is used to update the tab with the new text.

void CTabDlg::OnChangeItem()
{
   TCITEM tcItem;
   CString pszString;

   //  Get text for the tab item.
   GetDlgItemText(IDC_ITEM_TEXT, pszString);

   //  Get the current tab item text.
   TCHAR buffer[256] = {0};
   tcItem.pszText = buffer;
   tcItem.cchTextMax = 256;
   tcItem.mask = TCIF_TEXT;
   m_TabCtrl.GetItem(0, &tcItem);
   TRACE(_T("Changing item text from %s to %s..."), tcItem.pszText, pszString);

   //  Set the new text for the item.
   tcItem.pszText = pszString.LockBuffer();

   //  Set the item in the tab control.
   m_TabCtrl.SetItem(0, &tcItem);

   pszString.UnlockBuffer();
}

`CTabCtrl::GetItemCount`

탭 컨트롤에서 탭 수를 검색합니다.

int GetItemCount() const;

Return Value

탭 컨트롤의 항목 수입니다.

예시

CPropertySheet::GetTabControl에 대한 예를 참조하세요.

`CTabCtrl::GetItemRect`

탭 컨트롤에서 지정된 탭의 경계 사각형을 검색합니다.

BOOL GetItemRect(int nItem,   LPRECT lpRect) const;

매개 변수

nItem
탭 항목의 인덱스(0부터 시작하는 인덱스)입니다.

lpRect
탭의 RECT 경계 사각형을 받는 구조체에 대한 포인터입니다. 이러한 좌표는 뷰포트의 현재 매핑 모드를 사용합니다.

Return Value

성공하면 0이 아니고, 그렇지 않으면 0입니다.

예시

CPropertySheet::GetTabControl에 대한 예를 참조하세요.

`CTabCtrl::GetItemState`

로 식별되는 nItem탭 컨트롤 항목의 상태를 검색합니다.

DWORD GetItemState(
    int nItem,
    DWORD dwMask) const;

매개 변수

nItem
상태 정보를 검색할 항목의 인덱스 번호(0부터 시작하는 인덱스)입니다.

dwMask
반환할 항목의 상태 플래그를 지정하는 마스크입니다. 값 목록은 Windows SDK에 설명된 대로 구조체의 TCITEM 마스크 멤버를 참조하세요.

Return Value

상태 정보를 수신하는 DWORD 값에 대한 참조입니다. 다음 값 중 하나일 수 있습니다.

값	설명
`TCIS_BUTTONPRESSED`	탭 컨트롤 항목이 선택된 상태입니다.
`TCIS_HIGHLIGHTED`	탭 컨트롤 항목이 강조 표시되고 현재 강조 색을 사용하여 탭과 텍스트가 그려집니다. 강조 색을 사용하는 경우 디더링된 색이 아닌 실제 보간이 됩니다.

설명

항목의 상태는 구조체의 TCITEM 멤버에 dwState 의해 지정됩니다.

`CTabCtrl::GetRowCount`

탭 컨트롤의 현재 행 수를 검색합니다.

int GetRowCount() const;

Return Value

탭 컨트롤의 탭 행 수입니다.

설명

스타일이 있는 TCS_MULTILINE 탭 컨트롤만 여러 개의 탭 행을 가질 수 있습니다.

`CTabCtrl::GetToolTips`

탭 컨트롤과 연결된 도구 설명 컨트롤의 핸들을 검색합니다.

CToolTipCtrl* GetToolTips() const;

Return Value

성공하면 도구 설명 컨트롤의 핸들입니다. 그렇지 않으면 NULL.

설명

탭 컨트롤은 스타일이 있는 경우 도구 설명 컨트롤을 TCS_TOOLTIPS 만듭니다. 멤버 함수를 사용하여 도구 설명 컨트롤을 탭 컨트롤에 할당할 SetToolTips 수도 있습니다.

`CTabCtrl::HighlightItem`

탭 항목의 강조 표시 상태를 설정합니다.

BOOL HighlightItem(int idItem,  BOOL fHighlight = TRUE);

매개 변수

idItem
탭 컨트롤 항목의 인덱스(0부터 시작하는 인덱스)입니다.

fHighlight
설정할 강조 표시 상태를 지정하는 값입니다. 이 값이 TRUE면 탭이 강조 표시됩니다. 이 경우 FALSE탭이 기본 상태로 설정됩니다.

Return Value

성공하는 경우 0이 아니고, 그렇지 않으면 0입니다.

설명

이 멤버 함수는 Windows SDK에 설명된 대로 Win32 메시지를 TCM_HIGHLIGHTITEM구현합니다.

`CTabCtrl::HitTest`

지정된 화면 위치에 있는 탭(있는 경우)을 결정합니다.

int HitTest(TCHITTESTINFO* pHitTestInfo) const;

매개 변수

pHitTestInfo
테스트할 TCHITTESTINFO 화면 위치를 지정하는 Windows SDK에 설명된 대로 구조체에 대한 포인터입니다.

Return Value

탭의 인덱스(0부터 시작하는 인덱스)를 반환하고, 지정된 위치에 탭이 없으면 -1을 반환합니다.

`CTabCtrl::InsertItem`

기존 탭 컨트롤에 새 탭을 삽입합니다.

LONG InsertItem(
    int nItem,
    TCITEM* pTabCtrlItem);

LONG InsertItem(
    int nItem,
    LPCTSTR lpszItem);

LONG InsertItem(
    int nItem,
    LPCTSTR lpszItem,
    int nImage);

LONG InsertItem(
    UINT nMask,
    int nItem,
    LPCTSTR lpszItem,
    int nImage,
    LPARAM lParam);

LONG InsertItem(
    UINT nMask,
    int nItem,
    LPCTSTR lpszItem,
    int nImage,
    LPARAM lParam,
    DWORD dwState,
    DWORD dwStateMask);

매개 변수

nItem
새 탭의 인덱스(0부터 시작하는 인덱스)입니다.

pTabCtrlItem
탭의 TCITEM 특성을 지정하는 구조체에 대한 포인터입니다.

lpszItem
탭의 텍스트가 포함된 null로 끝나는 문자열의 주소입니다.

nImage
이미지 목록에서 삽입할 이미지의 인덱스(0부터 시작하는 인덱스)입니다.

nMask
설정할 구조 특성을 지정 TCITEM 합니다. 0이거나 다음 값의 조합일 수 있습니다.

TCIF_TEXT: 멤버가 pszText 유효합니다.
TCIF_IMAGE: 멤버가 iImage 유효합니다.
TCIF_PARAM: 멤버가 lParam 유효합니다.
TCIF_RTLREADING: 텍스트는 pszText 히브리어 또는 아랍어 시스템에서 오른쪽에서 왼쪽으로 읽기 순서를 사용하여 표시됩니다.
TCIF_STATE: 멤버가 dwState 유효합니다.

lParam
탭과 연결된 애플리케이션 정의 데이터입니다.

dwState
항목의 상태에 대한 값을 지정합니다. 자세한 내용은 Windows SDK를 참조 TCITEM 하세요.

dwStateMask
설정할 상태를 지정합니다. 자세한 내용은 Windows SDK를 참조 TCITEM 하세요.

Return Value

성공하면 새 탭의 인덱스(0부터 시작하는 인덱스)입니다. 그렇지 않으면 -1입니다.

예시

TCITEM tcItem;
tcItem.mask = TCIF_TEXT;
tcItem.pszText = _T("Tab #1");

m_TabCtrl.InsertItem(0, &tcItem);

`CTabCtrl::RemoveImage`

탭 컨트롤의 이미지 목록에서 지정된 이미지를 제거합니다.

void RemoveImage(int nImage);

매개 변수

nImage
제거할 이미지의 인덱스(0부터 시작하는 인덱스)입니다.

설명

탭 컨트롤은 각 탭이 동일한 이미지와 연결되도록 각 탭의 이미지 인덱스를 업데이트합니다.

`CTabCtrl::SetCurFocus`

탭 컨트롤의 지정된 탭에 포커스를 설정합니다.

void SetCurFocus(int nItem);

매개 변수

nItem
포커스를 가져오는 탭의 인덱스를 지정합니다.

설명

이 멤버 함수는 Windows SDK에 설명된 대로 Win32 메시지 TCM_SETCURFOCUS의 동작을 구현합니다.

`CTabCtrl::SetCurSel`

탭 컨트롤에서 탭을 선택합니다.

int SetCurSel(int nItem);

매개 변수

nItem
선택할 항목의 인덱스(0부터 시작)입니다.

Return Value

성공하면 이전에 선택한 탭의 인덱스(0부터 시작하는 인덱스)이고, 그렇지 않으면 -1입니다.

설명

이 함수를 사용하여 탭을 TCN_SELCHANGING TCN_SELCHANGE 선택하면 탭 컨트롤이 알림 메시지를 보내지 않습니다. 이러한 알림은 사용자가 키보드를 클릭하거나 사용하여 탭을 변경할 때 이를 사용하여 WM_NOTIFY전송됩니다.

`CTabCtrl::SetExtendedStyle`

탭 컨트롤의 확장 스타일을 설정합니다.

DWORD SetExtendedStyle(DWORD dwNewStyle, DWORD dwExMask = 0);

매개 변수

dwNewStyle
탭 컨트롤 확장 스타일의 조합을 지정하는 값입니다.

dwExMask
영향을 받을 스타일을 dwNewStyle 나타내는 DWORD 값입니다. 확장 스타일 dwExMask 만 변경됩니다. 다른 모든 스타일은 그대로 유지됩니다. 이 매개 변수가 0이면 모든 스타일이 영향을 받습니다 dwNewStyle .

Return Value

Windows SDK에 설명된 대로 이전 탭 컨트롤 확장 스타일을 포함하는 DWORD 값입니다.

설명

이 멤버 함수는 Windows SDK에 설명된 대로 Win32 메시지 TCM_SETEXTENDEDSTYLE의 동작을 구현합니다.

`CTabCtrl::SetImageList`

탭 컨트롤에 이미지 목록을 할당합니다.

CImageList* SetImageList(CImageList* pImageList);

매개 변수

pImageList
탭 컨트롤에 할당할 이미지 목록에 대한 포인터입니다.

Return Value

이전 이미지 목록에 대한 포인터를 반환하거나 NULL 이전 이미지 목록이 없는 경우 반환합니다.

`CTabCtrl::SetItem`

탭 특성의 일부 또는 전부를 설정합니다.

BOOL SetItem(int nItem,   TCITEM* pTabCtrlItem);

매개 변수

nItem
항목의 인덱스(0부터 시작하는 인덱스)입니다.

pTabCtrlItem
TCITEM 새 항목 특성을 포함하는 구조체에 대한 포인터입니다. 멤버는 mask 설정할 특성을 지정합니다. 멤버가 mask 값을 pszText 지정 TCIF_TEXT 하는 경우 멤버는 null로 끝나는 문자열의 주소이며 cchTextMax 멤버는 무시됩니다.

Return Value

성공하면 0이 아니고, 그렇지 않으면 0입니다.

예시

GetItem에 대한 예를 참조하세요.

`CTabCtrl::SetItemExtra`

탭 컨트롤에서 애플리케이션 정의 데이터용으로 예약된 탭당 바이트 수를 설정합니다.

BOOL SetItemExtra(int nBytes);

매개 변수

nBytes
설정할 추가 바이트 수입니다.

Return Value

성공하는 경우 0이 아니고, 그렇지 않으면 0입니다.

설명

이 멤버 함수는 Windows SDK에 설명된 대로 Win32 메시지 TCM_SETITEMEXTRA의 동작을 구현합니다.

`CTabCtrl::SetItemSize`

탭 컨트롤 항목의 높이 및 너비를 설정합니다.

CSize SetItemSize(CSize size);

매개 변수

size
탭 제어 항목의 새로운 너비 및 높이입니다(픽셀).

Return Value

탭 제어 항목의 이전 높이 및 너비를 반환합니다.

`CTabCtrl::SetItemState`

로 식별되는 nItem탭 컨트롤 항목의 상태를 설정합니다.

BOOL SetItemState(
    int nItem,
    DWORD dwMask,
    DWORD dwState);

매개 변수

nItem
상태 정보를 설정할 항목의 인덱스 번호(0부터 시작하는 인덱스)입니다.

dwMask
설정할 항목의 상태 플래그를 지정하는 마스크입니다. 값 목록은 Windows SDK에 설명된 대로 구조체의 TCITEM 마스크 멤버를 참조하세요.

dwState
상태 정보를 포함하는 DWORD 값에 대한 참조입니다. 다음 값 중 하나일 수 있습니다.

값	설명
`TCIS_BUTTONPRESSED`	탭 컨트롤 항목이 선택된 상태입니다.
`TCIS_HIGHLIGHTED`	탭 컨트롤 항목이 강조 표시되고 현재 강조 색을 사용하여 탭과 텍스트가 그려집니다. 강조 색을 사용하는 경우 디더링된 색이 아닌 실제 보간이 됩니다.

Return Value

성공하면 0이 아니고, 그렇지 않으면 0입니다.

`CTabCtrl::SetMinTabWidth`

탭 컨트롤에서 항목의 최소 너비를 설정합니다.

int SetMinTabWidth(int cx);

매개 변수

cx
탭 컨트롤 항목에 대해 설정할 최소 너비입니다. 이 매개 변수를 -1로 설정하면 컨트롤은 기본 탭 너비를 사용합니다.

Return Value

이전의 최소 탭 너비입니다.

설명

이 멤버 함수는 Windows SDK에 설명된 대로 Win32 메시지 TCM_SETMINTABWIDTH의 동작을 구현합니다.

`CTabCtrl::SetPadding`

탭 컨트롤에서 각 탭의 아이콘과 레이블 주변의 공간(패딩)을 설정합니다.

void SetPadding(CSize size);

매개 변수

size
탭 컨트롤에서 각 탭의 아이콘과 레이블 주변의 공간(패딩)을 설정합니다.

`CTabCtrl::SetToolTips`

도구 설명 컨트롤을 탭 컨트롤에 할당합니다.

void SetToolTips(CToolTipCtrl* pWndTip);

매개 변수

pWndTip
도구 설명 컨트롤의 핸들입니다.

설명

를 호출하여 탭 컨트롤과 연결된 도구 설명 컨트롤을 가져올 수 있습니다 GetToolTips.

예시

CPropertySheet::GetTabControl에 대한 예를 참조하세요.

참고 항목

CWnd 클래스
CHeaderCtrl 클래스
CListCtrl 클래스
계층 구조 차트

다음을 통해 공유

CTabCtrl 수업

구문

멤버

Public 생성자

공용 메서드

설명

상속 계층

요구 사항

CTabCtrl::AdjustRect

매개 변수

예시

CTabCtrl::Create

매개 변수

Return Value

설명

예시

CTabCtrl::CreateEx

매개 변수

Return Value

설명

CTabCtrl::CTabCtrl

CTabCtrl::DeleteAllItems

Return Value

CTabCtrl::DeleteItem

매개 변수

Return Value

예시

CTabCtrl::DeselectAll

매개 변수

설명

CTabCtrl::DrawItem

매개 변수

설명

CTabCtrl::GetCurFocus

Return Value

CTabCtrl::GetCurSel

Return Value

CTabCtrl::GetExtendedStyle

Return Value

설명

CTabCtrl::GetImageList

Return Value

CTabCtrl::GetItem

매개 변수

Return Value

설명

예시

CTabCtrl::GetItemCount

Return Value

예시

CTabCtrl::GetItemRect

매개 변수

Return Value

예시

CTabCtrl::GetItemState

매개 변수

Return Value

설명

CTabCtrl::GetRowCount

Return Value

설명

CTabCtrl::GetToolTips

Return Value

설명

CTabCtrl::HighlightItem

매개 변수

Return Value

설명

CTabCtrl::HitTest

매개 변수

Return Value

CTabCtrl::InsertItem

매개 변수

Return Value

예시

CTabCtrl::RemoveImage

매개 변수

설명

CTabCtrl::SetCurFocus

`CTabCtrl` 수업

`CTabCtrl::AdjustRect`

`CTabCtrl::Create`

`CTabCtrl::CreateEx`

`CTabCtrl::CTabCtrl`

`CTabCtrl::DeleteAllItems`

`CTabCtrl::DeleteItem`

`CTabCtrl::DeselectAll`

`CTabCtrl::DrawItem`

`CTabCtrl::GetCurFocus`

`CTabCtrl::GetCurSel`

`CTabCtrl::GetExtendedStyle`

`CTabCtrl::GetImageList`

`CTabCtrl::GetItem`

`CTabCtrl::GetItemCount`

`CTabCtrl::GetItemRect`

`CTabCtrl::GetItemState`

`CTabCtrl::GetRowCount`

`CTabCtrl::GetToolTips`

`CTabCtrl::HighlightItem`

`CTabCtrl::HitTest`

`CTabCtrl::InsertItem`

`CTabCtrl::RemoveImage`

`CTabCtrl::SetCurFocus`

`CTabCtrl::SetCurSel`

`CTabCtrl::SetExtendedStyle`

`CTabCtrl::SetImageList`

`CTabCtrl::SetItem`

`CTabCtrl::SetItemExtra`

`CTabCtrl::SetItemSize`

`CTabCtrl::SetItemState`

`CTabCtrl::SetMinTabWidth`

`CTabCtrl::SetPadding`

`CTabCtrl::SetToolTips`