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
하세요.
애플리케이션에서 크기 조정 가능한 도킹 탭 컨트롤을 추가하려면 다음 단계를 수행합니다.
클래스의 인스턴스를
CTabbedPane
만듭니다.CDockablePane::Create
을 호출합니다.새 탭을 사용
CBaseTabbedPane::AddTab
하거나CMFCBaseTabCtrl::InsertTab
추가합니다.현재 도킹 탭 컨트롤이 주 프레임 창에서 도킹할 수 있도록 호출
CBasePane::EnableDocking
합니다.주 프레임에 탭 창을 도킹하려면 호출
CFrameWndEx::DockPane
합니다.
탭 창을 도킹 컨트롤 막대로 만드는 방법의 예는 클래스를 참조 CTabbedPane
하세요. 비도킹 컨트롤로 사용 CMFCTabCtrl
하려면 개체를 CMFCTabCtrl
만든 다음 CMFCTabCtrl::Create
호출합니다.
상속 계층 구조
예시
다음 예제에서는 클래스의 다양한 메서드를 사용하여 개체를 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
성공하면 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
프레임 사각형이 그려지면
설명
이 메서드를 CMFCTabCtrl::SetDrawFrame
사용하여 프레임 사각형 그리기를 사용하거나 사용하지 않도록 설정합니다.
CMFCTabCtrl::IsFlatFrame
탭 영역 주위의 프레임이 플랫인지 아니면 3D인지를 나타냅니다.
BOOL IsFlatFrame() const;
Return Value
TRUE
탭 영역 주위의 프레임이 평평하면
설명
메서드를 CMFCTabCtrl::SetFlatFrame
사용하여 프레임을 그리는 방법을 변경합니다.
CMFCTabCtrl::IsFlatTab
현재 탭 컨트롤의 탭 모양이 플랫인지 여부를 나타냅니다.
virtual BOOL IsFlatTab() const;
Return Value
TRUE
현재 탭 컨트롤의 탭 모양이 평평하면
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_SCROLL
의 CMFCTabCtrl::Create
매개 변수가 style
.
CMFCTabCtrl::IsTabDocumentsMenu
탭 컨트롤에 스크롤 단추가 표시되는지 또는 탭 창의 메뉴를 표시하는 단추가 표시되는지 여부를 나타냅니다.
BOOL IsTabDocumentsMenu() const;
Return Value
TRUE
탭 창 레이블의 팝업 메뉴를 사용하여 탭 창을 스크롤하면 이고, FALSE
탭 창이 앞으로 및 뒤로 스크롤 단추를 사용하여 스크롤되면 입니다.
설명
이 메서드를 CMFCTabCtrl::EnableTabDocumentsMenu
사용하여 탭 창을 스크롤하는 방법을 지정합니다.
CMFCTabCtrl::IsVS2005Style
Visual Studio 2005 스타일을 사용하여 탭을 그릴지 여부를 나타냅니다.
virtual BOOL IsVS2005Style() const;
Return Value
TRUE
Visual 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_MBUTTON
MK_CONTROL
MK_RBUTTON
MK_SHIFT
MK_LBUTTON
MK_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_LBUTTON
MK_MBUTTON
및 MK_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
설명
이 메서드는 플랫 탭을 표시하는 탭 컨트롤에만 영향을 줍니다. 스크롤 막대는 모든 탭에 동시에 영향을 줍니다.