다음을 통해 공유


CMFCTabCtrl 수업

이 클래스는 CMFCTabCtrl 탭 컨트롤에 대한 기능을 제공합니다. 탭 컨트롤은 맨 위 또는 아래에 평면 또는 3차원 탭이 포함된 도킹 가능한 창을 표시합니다. 탭은 텍스트와 이미지를 표시하고 활성화된 경우 색을 변경할 수 있습니다.

구문

class CMFCTabCtrl : public CMFCBaseTabCtrl

멤버

공용 생성자

속성 설명
CMFCTabCtrl::CMFCTabCtrl 기본 생성자입니다.
CMFCTabCtrl::~CMFCTabCtrl 소멸자

공용 메서드

이름 설명
CMFCTabCtrl::ActivateMDITab 현재 탭 컨트롤의 지정된 탭을 표시하고 해당 탭에 포커스를 설정합니다.
CMFCTabCtrl::AllowDestroyEmptyTabbedPane
CMFCTabCtrl::AutoSizeWindow 탭 컨트롤의 사용자 인터페이스 요소가 변경되면 프레임워크가 모든 탭 컨트롤 창의 클라이언트 영역 크기를 조정할지 여부를 지정합니다.
CMFCTabCtrl::CalcRectEdit 지정된 탭 영역의 크기를 축소합니다. (CMFCBaseTabCtrl::CalcRectEdit재정의)
CMFCTabCtrl::Create 탭 컨트롤을 만들어 개체에 CMFCTabCtrl 연결합니다.
CMFCTabCtrl::CreateObject 프레임워크에서 이 클래스 형식의 동적 인스턴스를 만드는 데 사용합니다.
CMFCTabCtrl::EnableActiveTabCloseButton 활성 탭에서 닫기 단추( X)를 표시하거나 숨깁니다.
CMFCTabCtrl::EnableInPlaceEdit 편집 가능한 탭 레이블을 사용하거나 사용하지 않도록 설정합니다. ( CMFCBaseTabCtrl::EnableInPlaceEdit을 재정의합니다.)
CMFCTabCtrl::EnableTabDocumentsMenu 창 탭을 스크롤하는 두 개의 단추를 탭 창 메뉴를 여는 단추로 바꿉니다.
CMFCTabCtrl::EnsureVisible 탭이 표시되는지 확인합니다.
CMFCTabCtrl::GetDocumentIcon 탭 창의 팝업 메뉴에서 탭과 연결된 기호를 검색합니다.
CMFCTabCtrl::GetFirstVisibleTabNum 현재 탭 컨트롤에 표시되는 첫 번째 탭의 인덱스를 검색합니다.
CMFCTabCtrl::GetResizeMode 현재 탭 컨트롤의 크기를 조정할 수 있는 방법을 지정하는 값을 검색합니다.
CMFCTabCtrl::GetScrollBar 탭 컨트롤과 연결된 스크롤 막대 개체에 대한 포인터를 검색합니다.
CMFCTabCtrl::GetTabArea 탭 컨트롤의 위쪽 또는 아래쪽에 있는 탭 레이블 영역의 경계 사각형을 검색합니다. ( CMFCBaseTabCtrl::GetTabArea을 재정의합니다.)
CMFCTabCtrl::GetTabFromPoint 지정된 지점이 포함된 탭을 검색합니다. ( CMFCBaseTabCtrl::GetTabFromPoint을 재정의합니다.)
CMFCTabCtrl::GetTabMaxWidth 탭의 최대 너비를 검색합니다.
CMFCTabCtrl::GetTabsHeight 현재 탭 컨트롤의 탭 영역 높이를 검색합니다.
CMFCTabCtrl::GetTabsRect 현재 탭 컨트롤의 탭 영역을 경계로 하는 사각형을 검색합니다. ( CMFCBaseTabCtrl::GetTabsRect을 재정의합니다.)
CMFCTabCtrl::GetThisClass 프레임워크에서 이 클래스 형식과 연결된 개체에 CRuntimeClass 대한 포인터를 가져오는 데 사용됩니다.
CMFCTabCtrl::GetWndArea 현재 탭 컨트롤의 클라이언트 영역 경계를 검색합니다.
CMFCTabCtrl::HideActiveWindowHorzScrollBar 현재 창의 가로 스크롤 막대(있는 경우)를 숨깁니다.
CMFCTabCtrl::HideInactiveWindow 프레임워크가 비활성 탭 컨트롤 창을 표시할지 여부를 지정합니다.
CMFCTabCtrl::HideNoTabs 표시되는 탭이 없는 경우 탭 영역 그리기를 사용하거나 사용하지 않도록 설정합니다.
CMFCTabCtrl::HideSingleTab 단일 탭 창이 있는 경우 탭 그리기를 사용하거나 사용하지 않도록 설정합니다. ( CMFCBaseTabCtrl::HideSingleTab을 재정의합니다.)
CMFCTabCtrl::IsActiveInMDITabGroup 탭 컨트롤의 현재 탭이 여러 문서 인터페이스 탭 그룹의 활성 탭인지 여부를 나타냅니다.
CMFCTabCtrl::IsActiveTabBoldFont 굵은 글꼴을 사용하여 현재 탭의 텍스트가 표시되는지 여부를 나타냅니다.
CMFCTabCtrl::IsActiveTabCloseButton 닫기 단추( X)가 활성 탭에 표시되는지 또는 탭 영역의 오른쪽 위 모서리에 표시되는지 여부를 나타냅니다.
CMFCTabCtrl::IsDrawFrame 탭 창이 포함된 창 주위에 프레임 사각형을 그릴지 여부를 나타냅니다.
CMFCTabCtrl::IsFlatFrame 탭 영역 주위의 프레임이 플랫인지 아니면 3D인지를 나타냅니다.
CMFCTabCtrl::IsFlatTab 현재 탭 컨트롤의 탭 모양이 플랫인지 여부를 나타냅니다.
CMFCTabCtrl::IsLeftRightRounded 현재 탭 컨트롤에서 탭의 왼쪽과 오른쪽 모양이 둥근지 여부를 나타냅니다.
CMFCTabCtrl::IsMDITabGroup 현재 탭 컨트롤이 다중 문서 인터페이스 창의 클라이언트 영역에 포함되어 있는지 여부를 나타냅니다.
CMFCTabCtrl::IsOneNoteStyle 현재 탭 컨트롤이 Microsoft OneNote 스타일에 표시되는지 여부를 나타냅니다.
CMFCTabCtrl::IsPtInTabArea 지점이 탭 영역 내에 있는지 여부를 확인합니다. ( CMFCBaseTabCtrl::IsPtInTabArea을 재정의합니다.)
CMFCTabCtrl::IsSharedScroll 현재 탭 컨트롤에 탭을 그룹으로 스크롤할 수 있는 스크롤 막대가 있는지 여부를 나타냅니다.
CMFCTabCtrl::IsTabDocumentsMenu 탭 컨트롤에 스크롤 단추가 표시되는지 또는 탭 창의 메뉴를 표시하는 단추가 표시되는지 여부를 나타냅니다.
CMFCTabCtrl::IsVS2005Style 탭이 Visual Studio .NET 2005 스타일로 표시되는지 여부를 나타냅니다.
CMFCTabCtrl::ModifyTabStyle 현재 탭 컨트롤의 탭 모양을 지정합니다.
CMFCTabCtrl::MoveTab 탭을 다른 탭 위치로 이동합니다. ( CMFCBaseTabCtrl::MoveTab을 재정의합니다.)
CMFCTabCtrl::OnDragEnter 커서를 탭 컨트롤 창으로 처음 끌 때 프레임워크에서 호출됩니다.
CMFCTabCtrl::OnDragOver 마우스를 놓기 대상 창 위로 이동할 때 끌기 작업 중에 프레임워크에서 호출됩니다. ( CMFCBaseTabCtrl::OnDragOver을 재정의합니다.)
CMFCTabCtrl::OnShowTabDocumentsMenu 탭 창의 팝업 메뉴를 표시하고 사용자가 탭을 선택할 때까지 기다린 다음 선택한 탭을 활성 탭으로 만듭니다.
CMFCTabCtrl::PreTranslateMessage 창 메시지가 Windows 함수에 DispatchMessage 디스패치되기 TranslateMessage 전에 변환합니다. ( CMFCBaseTabCtrl::PreTranslateMessage을 재정의합니다.)
CMFCTabCtrl::RecalcLayout 탭 컨트롤의 내부 레이아웃을 다시 계산합니다. ( CMFCBaseTabCtrl::RecalcLayout을 재정의합니다.)
CMFCTabCtrl::SetActiveInMDITabGroup 탭 컨트롤의 현재 탭을 여러 문서 인터페이스 탭 그룹의 활성 탭으로 설정합니다.
CMFCTabCtrl::SetActiveTab 탭을 활성화합니다. (재정의합니다 CMFCBaseTabCtrl::SetActiveTab.)
CMFCTabCtrl::SetActiveTabBoldFont 활성 탭에서 굵은 글꼴을 사용하거나 사용하지 않도록 설정합니다.
CMFCTabCtrl::SetDrawFrame 포함된 막대 주위에 프레임 사각형 그리기를 사용하거나 사용하지 않도록 설정합니다.
CMFCTabCtrl::SetFlatFrame 탭 영역 주위에 평면 또는 3D 프레임을 그릴지 여부를 지정합니다.
CMFCTabCtrl::SetImageList 이미지 목록을 지정합니다. ( CMFCBaseTabCtrl::SetImageList을 재정의합니다.)
CMFCTabCtrl::SetResizeMode 현재 탭 컨트롤의 크기를 조정한 다음 컨트롤을 다시 표시할 수 있는 방법을 지정합니다.
CMFCTabCtrl::SetTabMaxWidth 탭 창의 최대 탭 너비를 지정합니다.
CMFCTabCtrl::StopResize 탭 컨트롤에서 현재 크기 조정 작업을 종료합니다.
CMFCTabCtrl::SwapTabs 탭 쌍을 바꿉니다. ( CMFCBaseTabCtrl::SwapTabs을 재정의합니다.)
CMFCTabCtrl::SynchronizeScrollBar 탭 컨트롤에 평면 탭을 표시하는 가로 스크롤 막대를 그립니다.

데이터 멤버

속성 설명
CMFCTabCtrl::m_bEnableActivate 새 탭을 삽입하고 사용하도록 설정할 때 활성 보기의 포커스가 손실되지 않도록 합니다.

설명

클래스는 다음 CMFCTabCtrl 을 지원합니다.

  • 공유 가로 스크롤 막대가 있는 3D, 플랫 및 플랫을 포함하는 탭 컨트롤 스타일입니다.

  • 창의 위쪽 또는 아래쪽에 있는 탭입니다.

  • 텍스트, 이미지 또는 텍스트 및 이미지를 표시하는 탭입니다.

  • 탭이 활성 상태일 때 색을 변경하는 탭입니다.

  • 조정 가능한 탭의 테두리 크기가 변경됩니다.

  • 분리 가능한 탭 창입니다.

이 클래스는 CMFCTabCtrl 대화 상자에서 사용할 수 있지만 Microsoft Excel 및 Visual Studio와 같은 도킹 컨트롤 막대를 사용하는 애플리케이션을 위한 것입니다. 자세한 내용은 클래스를 참조 CDockablePane 하세요.

애플리케이션에서 크기 조정 가능한 도킹 탭 컨트롤을 추가하려면 다음 단계를 수행합니다.

  1. 클래스의 인스턴스를 CTabbedPane 만듭니다.

  2. CDockablePane::Create을 호출합니다.

  3. 새 탭을 사용 CBaseTabbedPane::AddTab 하거나 CMFCBaseTabCtrl::InsertTab 추가합니다.

  4. 현재 도킹 탭 컨트롤이 주 프레임 창에서 도킹할 수 있도록 호출 CBasePane::EnableDocking 합니다.

  5. 주 프레임에 탭 창을 도킹하려면 호출 CFrameWndEx::DockPane 합니다.

탭 창을 도킹 컨트롤 막대로 만드는 방법의 예는 클래스를 참조 CTabbedPane 하세요. 비도킹 컨트롤로 사용 CMFCTabCtrl 하려면 개체를 CMFCTabCtrl 만든 다음 CMFCTabCtrl::Create호출합니다.

상속 계층 구조

CObject

CCmdTarget

CWnd

CMFCBaseTabCtrl

CMFCTabCtrl

예시

다음 예제에서는 클래스의 다양한 메서드를 사용하여 개체를 CMFCTabCtrl CMFCTabCtrl 구성하는 방법을 보여 줍니다. 이 예제에서는 탭을 추가하고, 활성 탭에 닫기 단추를 표시하고, 편집 가능한 탭 레이블을 사용하도록 설정하고, 탭 창 레이블의 팝업 메뉴를 표시하는 방법을 설명합니다. 이 예제는 상태 컬렉션 샘플일부입니다.

CMFCTabCtrl m_wndTabs;
// Attach list windows to tab:
// CListCtrl m_wndList1
// CListCtrl m_wndList2
// CListCtrl m_wndList3
m_wndTabs.AddTab(&m_wndList1, _T("Output 1"), (UINT)-1);
m_wndTabs.AddTab(&m_wndList2, _T("Output 2"), (UINT)-1);
m_wndTabs.AddTab(&m_wndList3, _T("Output 3"), (UINT)-1);

m_wndTabs.EnableActiveTabCloseButton();
m_wndTabs.EnableInPlaceEdit(true);
m_wndTabs.EnableTabDocumentsMenu();
m_wndTabs.SetActiveTab(1);
m_wndTabs.SetDrawFrame();
m_wndTabs.SetFlatFrame();

요구 사항

머리글: afxtabctrl.h

CMFCTabCtrl::ActivateMDITab

현재 탭 컨트롤의 지정된 탭을 표시하고 해당 탭에 포커스를 설정합니다.

void ActivateMDITab(int nTab = -1);

매개 변수

nTab
[in] 표시할 탭의 인덱스(0부터 시작하는 인덱스) 또는 현재 활성 탭을 지정하는 -1입니다.

CMFCTabCtrl::AllowDestroyEmptyTabbedPane

자세한 내용은 Visual Studio 설치의 mfc 폴더에 있는 소스 코드를 참조하세요. 예들 들어 %ProgramFiles(x86)%\Microsoft Visual Studio\2019\Enterprise\VC\Tools\MSVC\14.29.30133\atlmfc\src\mfc입니다.

virtual BOOL AllowDestroyEmptyTabbedPane() const;

Return Value

항상 TRUE입니다.

설명

CMFCTabCtrl::AutoSizeWindow

탭 컨트롤의 사용자 인터페이스 요소가 변경되면 프레임워크가 모든 탭 컨트롤 창의 클라이언트 영역 크기를 조정할지 여부를 지정합니다.

void AutoSizeWindow(BOOL bAutoSize = TRUE);

매개 변수

bAutoSize
[in] TRUE 탭 컨트롤 창의 크기를 자동으로 조정하려면 그렇지 않으면 . FALSE 기본값은 TRUE입니다.

설명

CMFCTabCtrl::Create

탭 컨트롤을 만들어 개체에 CMFCTabCtrl 연결합니다.

BOOL Create(
    Style style,
    const RECT& rect,
    CWnd* pParentWnd,
    UINT nID,
    Location location=LOCATION_BOTTOM,
    BOOL bCloseBtn=FALSE);

매개 변수

style
[in] 탭 컨트롤의 스타일입니다. 자세한 내용은 설명 부분을 참조하세요.

rect
[in] 탭 컨트롤을 경계로 하는 사각형입니다.

pParentWnd
[in] 부모 창에 대한 포인터입니다. NULL이 아니어야 합니다.

nID
[in] 탭 컨트롤의 ID입니다.

location
[in] 탭의 위치입니다. 기본값은 LOCATION_BOTTOM입니다. 자세한 내용은 설명을 참조하세요.

bCloseBtn
[in] TRUE 탭에 닫기 단추를 표시하려면 그렇지 않으면 . FALSE 기본값은 FALSE입니다.

Return Value

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

설명

다음 표에서는 매개 변수에 대해 지정할 수 있는 값에 style 대해 설명합니다.

스타일 설명
STYLE_3D 3차원 모양으로 탭 컨트롤을 만듭니다.
STYLE_FLAT 플랫 탭을 사용하여 탭 컨트롤을 만듭니다.
STYLE_FLAT_SHARED_HORZ_SCROLL 탭이 부모 창에서 잘린 경우 탭을 스크롤할 수 있는 스크롤 막대와 플랫 탭이 있는 탭 컨트롤을 만듭니다.
STYLE_3D_ONENOTE Microsoft OneNote 스타일로 탭 컨트롤을 만듭니다.
STYLE_3D_VS2005 Microsoft Visual Studio 2005 스타일로 탭 컨트롤을 만듭니다.
STYLE_3D_ROUNDED Microsoft Visual Studio 2005 스타일로 둥근 탭을 사용하여 탭 컨트롤을 만듭니다.
STYLE_3D_ROUNDED_SCROLL Microsoft Visual Studio 2005 스타일에서 둥근 탭과 스크롤 단추가 있는 탭 컨트롤을 만듭니다.

다음 표에서는 매개 변수에 지정할 수 있는 값을 나열합니다 location .

위치 설명
LOCATION_BOTTOM 탭은 탭 컨트롤의 맨 아래에 있습니다.
LOCATION_TOP 탭은 탭 컨트롤의 맨 위에 있습니다.

예시

다음 예제에서는 클래스에서 메서드를 Create 사용 하는 방법을 보여 줍니다 CMFCTabCtrl . 이 예제는 상태 컬렉션 샘플일부입니다.

CMFCTabCtrl m_wndTabs;
// Create tabs window:
// CRect rectDummy
// this is a pointer to a parent window
// fourth parameter is the id of the tab control
if (!m_wndTabs.Create (CMFCTabCtrl::STYLE_FLAT, rectDummy, this, 1))
{
    TRACE0("Failed to create output tab window\n");
    return -1;      // fail to create
}

CMFCTabCtrl::CalcRectEdit

지정된 탭 영역의 크기를 축소합니다.

virtual void CalcRectEdit(CRect& rectEdit);

매개 변수

rectEdit
[in] 탭의 영역을 지정하는 사각형입니다.

설명

이 메서드는 탭의 레이블을 변경할 때 호출됩니다. 이 메서드는 지정된 사각형의 왼쪽과 오른쪽을 현재 탭 높이의 절반으로 축소하고 위쪽과 아래쪽을 한 단위로 축소합니다.

CMFCTabCtrl::EnableActiveTabCloseButton

활성 탭에서 닫기 단추( X)를 표시하거나 숨깁니다.

void EnableActiveTabCloseButton(BOOL bEnable=TRUE);

매개 변수

bEnable
[in] TRUE 활성 탭에 닫기 단추를 표시하려면 탭 FALSE 영역의 오른쪽 위 모서리에 닫기 단추를 표시합니다. 기본값은 TRUE입니다.

CMFCTabCtrl::EnableInPlaceEdit

편집 가능한 탭 레이블을 사용하거나 사용하지 않도록 설정합니다.

virtual void EnableInPlaceEdit(BOOL bEnable);

매개 변수

bEnable
[in] TRUE 편집 가능한 탭 레이블을 사용하도록 설정하려면 FALSE 편집 가능한 탭 레이블을 사용하지 않도록 설정합니다.

설명

CMFCTabCtrl::EnableTabDocumentsMenu

두 개의 단추를 사용하여 창 탭을 스크롤하는 사용자 인터페이스와 탭 창의 팝업 메뉴를 표시하는 인터페이스 간에 전환합니다.

void EnableTabDocumentsMenu(BOOL bEnable=TRUE);

매개 변수

bEnable
[in] TRUE 탭 창 레이블의 팝업 메뉴를 표시하려면 FALSE 을 클릭하여 앞으로 및 뒤로 스크롤 단추를 표시합니다. 기본값은 TRUE입니다.

설명

사용자가 탭 레이블을 클릭하면 프레임워크에 해당 탭 창이 표시됩니다. 탭 레이블이 표시되면 탭 창은 위치를 변경하지 않고 열립니다. 사용자가 팝업 메뉴에서 문서를 선택하고 해당 탭 창이 화면이 끄면 탭 창이 첫 번째 탭이 됩니다.

CMFCTabCtrl::EnsureVisible

탭이 표시되는지 확인합니다.

virtual BOOL EnsureVisible(int iTab);

매개 변수

iTab
[in] 탭의 0부터 시작하는 인덱스입니다.

Return Value

TRUE 성공하면 FALSE 매개 변수 인덱스가 iTab 잘못된 경우

설명

지정된 탭이 표시되도록 하려면 이 메서드를 사용합니다. 필요한 경우 탭 컨트롤이 스크롤됩니다.

CMFCTabCtrl::GetDocumentIcon

탭 창의 팝업 메뉴에서 탭과 연결된 이미지를 검색합니다.

static HICON __stdcall GetDocumentIcon(UINT nCmdID);

매개 변수

nCmdID
[in] 탭 창의 팝업 메뉴에 있는 탭의 명령 ID입니다.

Return Value

비트맵 이미지의 핸들입니다.

CMFCTabCtrl::GetFirstVisibleTabNum

현재 탭 컨트롤에 표시되는 첫 번째 탭의 인덱스를 검색합니다.

virtual int GetFirstVisibleTabNum() const;

Return Value

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

설명

탭 컨트롤이 Microsoft OneNote 스타일에 표시되는 경우에만 이 메서드를 사용합니다. 메서드를 CMFCTabCtrl::IsOneNoteStyle 사용하여 스타일을 확인합니다.

CMFCTabCtrl::GetResizeMode

현재 탭 컨트롤의 크기를 조정할 수 있는 방법을 지정하는 값을 검색합니다.

ResizeMode GetResizeMode() const;

Return Value

탭 컨트롤의 CMFCTabCtrl::ResizeMode 크기를 조정할 수 있는 방법을 지정하는 열거형 값 중 하나입니다. 가능한 값 목록은 메서드의 설명 섹션을 CMFCTabCtrl::SetResizeMode 참조하세요.

CMFCTabCtrl::GetScrollBar

탭 컨트롤과 연결된 스크롤 막대 개체에 대한 포인터를 검색합니다.

CScrollBar* GetScrollBar();

Return Value

스크롤 막대 개체에 대한 포인터이거나 NULL 스타일을 사용하여 STYLE_FLAT_SHARED_HORZ_SCROLL 탭 컨트롤을 만들지 않은 경우입니다.

설명

이 메서드를 사용하여 탭 컨트롤의 포함된 스크롤 막대에 액세스합니다. 스크롤 막대 개체는 탭 컨트롤에 스타일이 STYLE_FLAT_SHARED_HORZ_SCROLL 있는 경우에만 만들어집니다.

CMFCTabCtrl::GetTabArea

탭 컨트롤의 위쪽 또는 아래쪽에 있는 탭 레이블 영역의 경계 사각형을 검색합니다.

void GetTabArea(
    CRect& rectTabAreaTop,
    CRect& rectTabAreaBottom) const;

매개 변수

rectTabAreaTop
[out] 이 메서드가 반환되면 이 참조에는 위쪽 탭 레이블 영역을 경계로 하는 사각형이 포함됩니다. 사각형은 클라이언트 좌표에 있습니다. 탭 컨트롤의 맨 위에 탭 레이블 영역이 없으면 이 참조는 비어 있습니다.

rectTabAreaBottom
[out] 이 메서드가 반환되면 이 참조에는 아래쪽 탭 레이블 영역을 경계로 하는 사각형이 포함됩니다. 사각형은 클라이언트 좌표에 있습니다. 탭 컨트롤의 아래쪽에 탭 레이블 영역이 없으면 이 참조는 비어 있습니다.

설명

탭 창에서 탭 영역의 크기와 위치를 확인하려면 이 메서드를 사용합니다.

CMFCTabCtrl::GetTabMaxWidth

탭의 최대 너비를 검색합니다.

int GetTabMaxWidth() const;

Return Value

탭의 최대 너비(픽셀)입니다. 반환 값이 0이면 탭 너비가 무제한입니다.

설명

CMFCTabCtrl::SetTabMaxWidth 메서드를 사용하여 최대 탭 너비를 설정합니다.

CMFCTabCtrl::GetTabsHeight

현재 탭 컨트롤의 탭 영역 높이를 검색합니다.

virtual int GetTabsHeight() const;

Return Value

탭이 표시되는 경우 탭 영역의 높이이거나, 탭이 표시되지 않으면 0입니다.

CMFCTabCtrl::GetTabsRect

현재 탭 컨트롤의 탭 영역을 경계로 하는 사각형을 검색합니다.

virtual void GetTabsRect(CRect& rect) const;

매개 변수

rect
[out] 이 메서드가 rect 반환되면 매개 변수에는 탭 영역을 경계로 하는 사각형이 포함됩니다.

CMFCTabCtrl::GetWndArea

현재 탭 컨트롤의 클라이언트 영역 경계를 검색합니다.

void GetWndArea(CRect& rect) const;

매개 변수

rect
[in, out] 이 메서드가 반환되면 이 매개 변수에는 현재 탭 컨트롤을 경계로 하는 사각형이 포함됩니다.

설명

CMFCTabCtrl::HideActiveWindowHorzScrollBar

현재 창에서 가로 스크롤 막대(있는 경우)를 숨깁니다.

void HideActiveWindowHorzScrollBar();

설명

사용자가 탭 컨트롤 페이지 간에 전환할 때 탭 컨트롤이 깜박이지 않도록 하려면 이 방법을 사용합니다.

CMFCTabCtrl::HideInactiveWindow

프레임워크에 비활성 탭 컨트롤 창이 표시되는지 여부를 지정합니다.

void HideInactiveWindow(BOOL bHide = TRUE);

매개 변수

bHide
[in] TRUE 비활성 창을 표시하지 않습니다. FALSE 비활성 창을 표시합니다. 기본값은 TRUE입니다.

설명

CMFCTabCtrl::HideNoTabs

표시되는 탭이 없는 경우 탭 영역의 그리기를 사용하거나 사용하지 않도록 설정합니다.

void HideNoTabs(BOOL bHide=TRUE);

매개 변수

bHide
[in] TRUE 탭 영역을 그릴 수 있도록 설정하려면 FALSE 그리기를 사용하지 않도록 설정합니다. 기본값은 TRUE입니다.

설명

CMFCTabCtrl::HideSingleTab

탭 창이 하나 있는 경우 탭 그리기를 사용하거나 사용하지 않도록 설정합니다.

virtual void HideSingleTab(BOOL bHide=TRUE);

매개 변수

bHide
[in] TRUE 단일 탭 창에 대한 탭을 그리지 않려면 FALSE 를 선택하여 단일 탭을 그립니다. 기본값은 .입니다 TRUE.

설명

CMFCTabCtrl::IsActiveInMDITabGroup

탭 컨트롤의 현재 탭이 여러 문서 인터페이스 탭 그룹의 활성 탭인지 여부를 나타냅니다.

BOOL IsActiveInMDITabGroup() const;

Return Value

TRUE탭 컨트롤의 현재 탭이 MDI 탭 그룹의 활성 탭인 경우 그렇지 않으면 . FALSE

설명

여러 문서 창을 세로 또는 가로 탭 그룹으로 구성하고 한 탭 그룹에서 다른 탭 그룹으로 문서를 쉽게 섞을 수 있습니다.

CMFCTabCtrl::IsActiveTabBoldFont

굵은 글꼴을 사용하여 현재 탭의 텍스트가 표시되는지 여부를 나타냅니다.

BOOL IsActiveTabBoldFont() const;

Return Value

TRUE굵은 글꼴을 사용하여 활성 탭이 표시되면 이고, 그렇지 않으면 . FALSE

설명

이 메서드를 CMFCTabCtrl::SetActiveTabBoldFont 사용하여 활성 탭 글꼴을 변경합니다.

CMFCTabCtrl::IsActiveTabCloseButton

닫기 단추(X)가 활성 탭 또는 탭 영역의 오른쪽 위 모서리에 표시되는지 여부를 나타냅니다.

virtual BOOL IsActiveTabCloseButton() const;

Return Value

TRUE닫기 단추가 활성 탭에 표시되면 />이고, FALSE 닫기 단추가 탭 영역의 오른쪽 위 모서리에 표시되는 경우입니다.

설명

CMFCTabCtrl::IsDrawFrame

탭 창이 포함된 창 주위에 프레임 사각형을 그릴지 여부를 나타냅니다.

BOOL IsDrawFrame() const;

Return Value

TRUE프레임 사각형이 그려지면 FALSE

설명

이 메서드를 CMFCTabCtrl::SetDrawFrame 사용하여 프레임 사각형 그리기를 사용하거나 사용하지 않도록 설정합니다.

CMFCTabCtrl::IsFlatFrame

탭 영역 주위의 프레임이 플랫인지 아니면 3D인지를 나타냅니다.

BOOL IsFlatFrame() const;

Return Value

TRUE 탭 영역 주위의 프레임이 평평하면 FALSE 프레임이 3차원인 경우

설명

메서드를 CMFCTabCtrl::SetFlatFrame 사용하여 프레임을 그리는 방법을 변경합니다.

CMFCTabCtrl::IsFlatTab

현재 탭 컨트롤의 탭 모양이 플랫인지 여부를 나타냅니다.

virtual BOOL IsFlatTab() const;

Return Value

TRUE현재 탭 컨트롤의 탭 모양이 평평하면 FALSE

CMFCTabCtrl::IsLeftRightRounded

현재 탭 컨트롤에서 탭의 왼쪽과 오른쪽 모양이 둥근지 여부를 나타냅니다.

virtual BOOL IsLeftRightRounded() const;

Return Value

TRUE각 탭의 측면이 둥근 경우 그렇지 않으면 . FALSE

CMFCTabCtrl::IsMDITabGroup

현재 탭 컨트롤이 다중 문서 인터페이스 창의 클라이언트 영역에 포함되어 있는지 여부를 나타냅니다.

virtual BOOL IsMDITabGroup() const;

Return Value

TRUE현재 탭 컨트롤이 MDI 클라이언트 영역 창에 있으면 이고, 그렇지 않으면 . FALSE

CMFCTabCtrl::IsOneNoteStyle

현재 탭 컨트롤이 Microsoft OneNote 스타일에 표시되는지 여부를 나타냅니다.

virtual BOOL IsOneNoteStyle() const;

Return Value

TRUE탭 컨트롤이 Microsoft OneNote 스타일로 표시되면 이고, 그렇지 않으면 . FALSE

CMFCTabCtrl::IsSharedScroll

현재 탭 컨트롤에 탭을 그룹으로 스크롤할 수 있는 스크롤 막대가 있는지 여부를 나타냅니다.

BOOL IsSharedScroll() const;

Return Value

TRUE탭 컨트롤에 공유 스크롤 막대가 있으면 이고, 그렇지 않으면 . FALSE

설명

이 메서드는 메서드 TRUE STYLE_FLAT_SHARED_HORZ_SCROLLCMFCTabCtrl::Create 매개 변수가 style .

CMFCTabCtrl::IsTabDocumentsMenu

탭 컨트롤에 스크롤 단추가 표시되는지 또는 탭 창의 메뉴를 표시하는 단추가 표시되는지 여부를 나타냅니다.

BOOL IsTabDocumentsMenu() const;

Return Value

TRUE 탭 창 레이블의 팝업 메뉴를 사용하여 탭 창을 스크롤하면 이고, FALSE 탭 창이 앞으로 및 뒤로 스크롤 단추를 사용하여 스크롤되면 입니다.

설명

이 메서드를 CMFCTabCtrl::EnableTabDocumentsMenu 사용하여 탭 창을 스크롤하는 방법을 지정합니다.

CMFCTabCtrl::IsVS2005Style

Visual Studio 2005 스타일을 사용하여 탭을 그릴지 여부를 나타냅니다.

virtual BOOL IsVS2005Style() const;

Return Value

TRUEVisual Studio 2005 스타일을 사용하여 탭을 그리면 이고, 그렇지 않으면 . FALSE

설명

메서드의 style 매개 변수를 CMFCTabCtrl::Create 사용하여 탭을 그리는 방법을 지정합니다.

CMFCTabCtrl::m_bEnableActivate

새 탭을 삽입하고 사용하도록 설정할 때 활성 보기의 포커스가 손실되지 않도록 합니다.

static BOOL m_bEnableActivate;

설명

탭이 삽입되고 활성화되면 일반적으로 새 탭 창에서 포커스를 가져옵니다. 원래 포커스를 CMFCTabCtrl::m_bEnableActivate 유지하도록 FALSE 멤버 변수를 설정합니다. 기본값은 TRUE입니다.

CMFCTabCtrl::ModifyTabStyle

현재 탭 컨트롤의 탭 모양을 지정합니다.

BOOL ModifyTabStyle(Style style);

매개 변수

style
[in] 탭 컨트롤의 모양을 지정하는 열거형 값 중 하나입니다. 자세한 내용은 주의 표를 참조하세요.

Return Value

항상 TRUE입니다.

설명

매개 변수 값 style 은 다음 CMFCTabCtrl::Style 열거형 중 하나일 수 있습니다.

속성 설명
STYLE_3D 둥근 모서리가 있는 3차원 사각형 탭을 표시합니다.
STYLE_3D_ONENOTE 세로 측면과 기울어진 측면이 있고 모서리가 둥근 3차원 탭을 표시합니다.
STYLE_3D_ROUNDED 기울어진 면과 둥근 모서리가 있는 3차원 탭을 표시합니다.
STYLE_3D_ROUNDED_SCROLL 기울어진 면과 둥근 모서리가 있는 3차원 탭을 표시합니다. 동시에 표시할 수 있는 것보다 많은 탭이 있는 경우 프레임워크는 드롭다운 화살표와 활성화할 탭 메뉴를 표시합니다.
STYLE_3D_SCROLLED 3차원 사각형 탭을 표시합니다. 동시에 표시할 수 있는 것보다 많은 탭이 있는 경우 프레임워크는 드롭다운 화살표와 활성화할 탭 메뉴를 표시합니다.
STYLE_3D_VS2005 기울어진 측면과 한 개의 세로 면이 있는 3차원 둥근 탭을 표시합니다.
STYLE_FLAT 왼쪽과 오른쪽이 기울어진 2차원 탭을 표시합니다.
STYLE_FLAT_SHARED_HORZ_SCROLL 2차원 탭을 표시합니다. 동시에 표시할 수 있는 것보다 많은 탭이 있는 경우 프레임워크는 탭 영역의 끝에 스크롤 화살표를 표시합니다.

CMFCTabCtrl::OnDragEnter

커서가 현재 탭 컨트롤의 창에 처음 들어갈 때 끌어서 놓기 작업 중에 프레임워크에서 호출됩니다.

virtual DROPEFFECT OnDragEnter(
    COleDataObject* pDataObject,
    DWORD dwKeyState,
    CPoint point);

매개 변수

pDataObject
[in] 사용자가 끄는 데이터가 포함된 데이터 개체를 가리킵니다.

dwKeyState
[in] 한정자 키의 상태를 포함합니다. 이 매개 변수는 다음 값MK_MBUTTONMK_CONTROLMK_RBUTTONMK_SHIFTMK_LBUTTONMK_ALT의 비트 조합 "or"(|)입니다. 자세한 내용은 마우스 입력 정보 메시지 매개 변수 섹션을 참조하세요.

point
[in] 클라이언트 좌표에서 커서의 현재 위치를 포함합니다.

Return Value

항상 DROPEFFECT_NONE즉, 놓기 대상이 데이터를 수락할 수 없습니다.

설명

끌어서 놓기 작업을 지원하려면 이 메서드를 사용합니다. 사용자 고유의 사용자 지정 동작을 구현하려면 이 메서드를 재정의합니다.

기본적으로 이 메서드는 항상 반환DROPEFFECT_NONE되는 호출CMFCTabCtrl::OnDragOver만 합니다.

CMFCTabCtrl::OnDragOver

마우스를 놓기 대상 창 위로 이동할 때 끌기 작업 중에 프레임워크에서 호출됩니다.

virtual DROPEFFECT OnDragOver(
    COleDataObject* pDataObject,
    DWORD dwKeyState,
    CPoint point);

매개 변수

pDataObject
[in] 놓기 COleDataObject 대상 위로 끌 개체에 대한 포인터입니다.

dwKeyState
[in] 한정자 키의 상태이며, 비트 조합 "or"(|)의 MK_CONTROL, MK_SHIFT, MK_ALT, MK_LBUTTONMK_MBUTTONMK_RBUTTON. 자세한 내용은 마우스 입력 정보에서 "메시지 매개 변수"를 참조하세요.

point
[in] 현재 마우스 위치입니다.

Return Value

항상 DROPEFFECT_NONE입니다.

설명

사용자 지정 구현을 사용하여 이 메서드를 재정의합니다. 자세한 내용은 CView::OnDragOver 메서드를 참조하세요.

CMFCTabCtrl::OnShowTabDocumentsMenu

탭 창의 팝업 메뉴를 표시하고 사용자가 탭을 선택할 때까지 기다렸다가 선택한 탭을 활성 탭으로 만듭니다.

virtual void OnShowTabDocumentsMenu(CPoint point);

매개 변수

point
[in] 팝업 메뉴를 표시할 위치의 좌표입니다.

설명

CMFCTabCtrl::SetActiveInMDITabGroup

탭 컨트롤의 현재 탭을 여러 문서 인터페이스 탭 그룹의 활성 탭으로 설정합니다.

void SetActiveInMDITabGroup(BOOL bActive);

매개 변수

bActive
[in] TRUE 현재 탭을 활성 탭으로 만들려면 FALSE 현재 탭을 비활성 상태로 만듭니다.

설명

여러 문서 창을 세로 또는 가로 탭 그룹으로 구성하고 한 탭 그룹에서 다른 탭 그룹으로 문서를 쉽게 섞을 수 있습니다.

CMFCTabCtrl::SetActiveTab

탭을 활성화합니다.

virtual BOOL SetActiveTab(int iTab);

매개 변수

iTab
[in] 활성화할 탭의 인덱스(0부터 시작하는 인덱스)를 지정합니다.

Return Value

TRUE 지정된 탭이 활성화된 경우 FALSE 지정된 iTab 매개 변수 값이 잘못되었으면 입니다.

설명

그러면 탭 컨트롤의 부모 창과 부모 프레임에 알림이 전송 AFX_WM_CHANGE_ACTIVE_TAB 됩니다.

이 메서드는 SetActiveTab 자동으로 메서드를 CMFCTabCtrl::HideActiveWindowHorzScrollBar 호출하여 화면이 깜박이지 않도록 합니다.

CMFCTabCtrl::SetActiveTabBoldFont

활성 탭에서 굵은 글꼴을 사용하거나 사용하지 않도록 설정합니다.

void SetActiveTabBoldFont(BOOL bIsBold=TRUE);

매개 변수

bIsBold
[in] TRUE 굵은 글꼴을 사용하여 활성 탭의 레이블을 표시하려면 FALSE 표준 글꼴을 사용하여 레이블을 표시합니다. 기본값은 TRUE입니다.

설명

CMFCTabCtrl::SetDrawFrame

포함된 막대 주위에 프레임 사각형을 그릴지 여부를 지정합니다.

void SetDrawFrame(BOOL bDraw=TRUE);

매개 변수

bDraw
[in] TRUE 포함된 막대 주위에 프레임 사각형을 표시하려면 입니다. 그렇지 않으면 . FALSE 기본값은 TRUE입니다.

설명

CMFCTabCtrl::SetFlatFrame

탭 영역 주위에 평면 또는 3D 프레임을 그릴지 여부를 지정합니다.

void SetFlatFrame(
    BOOL bFlat=TRUE,
    BOOL bRepaint=TRUE);

매개 변수

bFlat
[in] TRUE 탭 영역 주위에 플랫(2D) 프레임을 그리려면 FALSE 3D(3차원) 프레임을 그리려면 기본값은 TRUE입니다.

bRepaint
[in] TRUE 창을 즉시 다시 그리려면 그렇지 않으면 . FALSE 기본값은 TRUE입니다.

설명

CMFCTabCtrl::SetImageList

이미지 목록을 지정합니다.

virtual BOOL SetImageList(
    UINT uiID,
    int cx=15,
    COLORREF clrTransp=RGB(255, 0, 255));

virtual BOOL SetImageList(HIMAGELIST hImageList);

매개 변수

uiID
[in] 이미지 목록을 포함하는 비트맵 리소스의 ID입니다.

cx
[in] 각 이미지의 너비(픽셀)입니다. 기본값은 15입니다.

clrTransp
[in] 투명한 이미지 색입니다. 이 색인 이미지의 부분은 투명합니다. 기본값은 색 magenta, RGB(255,0,255)입니다.

hImageList
[in] 사전 로드된 이미지 목록에 대한 핸들입니다.

Return Value

TRUE 이 메서드가 성공하면 입니다. FALSE 플랫 스타일을 사용하여 탭 컨트롤을 만들거나 첫 번째 메서드 오버로드가 매개 변수로 uiID 지정된 비트맵을 로드할 수 없는 경우

설명

이 메서드를 사용하여 탭 컨트롤에 대한 이미지 목록을 설정합니다. 이미지 목록의 이미지가 탭 레이블 옆에 표시됩니다. 이 메서드는 탭 높이를 다시 계산하여 이미지와 텍스트를 모두 포함하도록 탭 크기를 조정합니다.

탭 컨트롤에서 CMFCBaseTabCtrl::AddTab 상속된 메서드를 사용하여 표시할 이미지의 인덱스 지정

CMFCTabCtrl::SetResizeMode

현재 탭 컨트롤의 크기를 조정한 다음 컨트롤을 다시 표시할 수 있는 방법을 지정합니다.

void SetResizeMode(ResizeMode resizeMode);

매개 변수

resizeMode
[in] 탭 컨트롤의 CMFCTabCtrl::ResizeMode 크기를 조정할 수 있는 방법을 지정하는 열거형 값 중 하나입니다. 가능한 값 목록은 주의 표를 참조하세요.

설명

resizeMode 매개 변수는 다음 ResizeMode 열거형 값 중 하나일 수 있습니다.

속성 설명
RESIZE_NO 탭 컨트롤의 크기를 조정할 수 없습니다.
RESIZE_VERT 탭 컨트롤의 크기를 세로로 조정할 수 있지만 가로는 조정할 수 없습니다.
RESIZE_HORIZ 탭 컨트롤의 크기를 가로로 조정할 수 있지만 세로로는 조정할 수 없습니다.

CMFCTabCtrl::SetTabMaxWidth

탭 창의 최대 탭 너비를 지정합니다.

void SetTabMaxWidth(int nTabMaxWidth);

매개 변수

nTabMaxWidth
[in] 최대 탭 너비(픽셀)입니다.

설명

탭 창에서 각 탭의 너비를 제한하려면 이 메서드를 사용합니다. 이 메서드는 탭에 레이블이 매우 긴 경우에 유용합니다. CMFCTabCtrl 클래스 생성자는 최대 탭 너비를 0으로 초기화합니다. 이는 실제로 너비가 제한되지 않음을 의미합니다.

CMFCTabCtrl::StopResize

탭 컨트롤에서 현재 크기 조정 작업을 종료합니다.

void StopResize(BOOL bCancel);

매개 변수

bCancel
[in] TRUE 현재 크기 조정 작업을 중단하려면 다음을 수행합니다. FALSE 현재 크기 조정 작업을 완료합니다. 두 경우 모두 프레임워크는 크기 조정 사각형 그리기를 중지합니다.

CMFCTabCtrl::SynchronizeScrollBar

탭 컨트롤에 평면 탭을 표시하는 가로 스크롤 막대를 그립니다.

BOOL SynchronizeScrollBar(SCROLLINFO* pScrollInfo = NULL);

매개 변수

pScrollInfo
[out] 구조체에 대한 SCROLLINFO 포인터 또는 NULL. 이 메서드가 반환되고 이 매개 변수가 없 NULL으면 구조체에 스크롤 막대의 모든 매개 변수가 포함됩니다. 기본값은 NULL입니다.

Return Value

TRUE이 메서드가 성공하면 이고, 그렇지 않으면 . FALSE

설명

이 메서드는 플랫 탭을 표시하는 탭 컨트롤에만 영향을 줍니다. 스크롤 막대는 모든 탭에 동시에 영향을 줍니다.

참고 항목

계층 구조 차트
클래스
CDockablePane 클래스
CMFCBaseTabCtrl 클래스