다음을 통해 공유

CMFCOutlookBarTabCtrl 클래스

  • 아티클

Microsoft Outlook의 탐색 창 과 시각적으로 유사한 탭 컨트롤입니다. 더 자세한 내용은 Visual Studio 설치의 VC\atlmfc\src\mfc 폴더에 있는 소스 코드를 참조하세요.

구문

class CMFCOutlookBarTabCtrl : public CMFCBaseTabCtrl

멤버

공용 생성자

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

공용 메서드

이름 설명
CMFCOutlookBarTabCtrl::AddControl Outlook 표시줄에서 Windows 컨트롤을 새 탭으로 추가합니다.
CMFCOutlookBarTabCtrl::CalcRectEdit 사용자가 탭 이름을 바꿀 때 나타나는 편집 상자의 크기를 결정하기 위해 프레임워크에서 호출됩니다. (재정의. CMFCBaseTabCtrl::CalcRectEdit)
CMFCOutlookBarTabCtrl::CanShowFewerPageButtons 크기 조정 작업 중에 프레임워크에서 호출하여 현재 표시되는 것보다 적은 수의 Outlook 표시줄 탭 페이지 단추를 표시할 수 있는지 확인합니다.
CMFCOutlookBarTabCtrl::CanShowMorePageButtons 크기 조정 작업 중에 프레임워크에서 호출하여 현재 표시되는 것보다 더 많은 Outlook 표시줄 탭 페이지 단추를 표시할 수 있는지 확인합니다.
CMFCOutlookBarTabCtrl::Create Outlook 표시줄 탭 컨트롤을 만듭니다.
CMFCOutlookBarTabCtrl::CreateObject 프레임워크에서 이 클래스 형식의 동적 인스턴스를 만드는 데 사용합니다.
CMFCOutlookBarTabCtrl::EnableAnimation 활성 탭 간 전환 중에 발생하는 애니메이션을 사용할 수 있는지 여부를 지정합니다.
CMFCOutlookBarTabCtrl::EnableInPlaceEdit 사용자가 Outlook 표시줄의 탭 단추에서 텍스트 레이블을 수정할 수 있는지 여부를 지정합니다. (재정의 CMFCBaseTabCtrl::EnableInPlaceEdit.)
CMFCOutlookBarTabCtrl::EnableScrollButtons 사용자가 Outlook 표시줄 창에서 단추를 스크롤할 수 있도록 하는 단추를 사용하도록 설정하기 위해 프레임워크에서 호출됩니다.
CMFCOutlookBarTabCtrl::FindTargetWnd 지정된 지점에 포함된 창을 확인합니다. (재정의 CMFCBaseTabCtrl::FindTargetWnd.)
CMFCOutlookBarTabCtrl::GetBorderSize Outlook 탭 컨트롤의 테두리 크기를 반환합니다.
CMFCOutlookBarTabCtrl::GetTabArea 탭 컨트롤의 탭 영역 크기 및 위치를 검색합니다. (재정의 CMFCBaseTabCtrl::GetTabArea.)
CMFCOutlookBarTabCtrl::GetThisClass 프레임워크에서 이 클래스 형식과 연결된 CRuntimeClass 개체에 대한 포인터를 가져오는 데 사용됩니다.
CMFCOutlookBarTabCtrl::GetVisiblePageButtons
CMFCOutlookBarTabCtrl::IsAnimation 활성 탭 간 전환 중에 발생하는 애니메이션을 사용할 수 있는지 여부를 결정합니다.
CMFCOutlookBarTabCtrl::IsMode2003 Outlook 표시줄 탭 컨트롤이 Microsoft Outlook 2003을 에뮬레이트하는 모드에 있는지 확인합니다.
CMFCOutlookBarTabCtrl::IsPtInTabArea 지점이 탭 영역 내에 있는지 여부를 확인합니다. (재정의 CMFCBaseTabCtrl::IsPtInTabArea.)
CMFCOutlookBarTabCtrl::IsTabDetachable 탭이 분리 가능한지 여부를 나타냅니다. (재정의 CMFCBaseTabCtrl::IsTabDetachable.)
CMFCOutlookBarTabCtrl::OnChangeTabs 탭을 삽입하거나 제거할 때 프레임워크에서 호출됩니다. ( CMFCBaseTabCtrl::OnChangeTabs을 재정의합니다.)
CMFCOutlookBarTabCtrl::OnShowFewerPageButtons 표시되는 탭 페이지 단추 수를 줄이기 위해 프레임워크에서 호출됩니다.
CMFCOutlookBarTabCtrl::OnShowMorePageButtons 표시되는 탭 페이지 단추 수를 늘리기 위해 프레임워크에서 호출됩니다.
CMFCOutlookBarTabCtrl::OnShowOptions 탐색 창 옵션 대화 상자를 표시합니다.
CMFCOutlookBarTabCtrl::RecalcLayout 탭 컨트롤의 내부 레이아웃을 다시 계산합니다. (재정의 CMFCBaseTabCtrl::RecalcLayout.)
CMFCOutlookBarTabCtrl::SetActiveTab 활성 탭을 설정합니다. (CMFCBaseTabCtrl::SetActiveTab을 재정의합니다.)
CMFCOutlookBarTabCtrl::SetBorderSize Outlook 탭 컨트롤의 테두리 크기를 설정합니다.
CMFCOutlookBarTabCtrl::SetPageButtonTextAlign Outlook 표시줄의 탭 단추에 있는 텍스트 레이블의 맞춤을 설정합니다.
CMFCOutlookBarTabCtrl::SetToolbarImageList Outlook 2003 모드의 Outlook 표시줄 아래쪽에 표시되는 아이콘이 포함된 비트맵을 설정합니다(CMFCOutlookBar 클래스 참조).
CMFCOutlookBarTabCtrl::SetVisiblePageButtons

설명

도킹 지원이 있는 Outlook 표시줄을 만들려면 개체를 CMFCOutlookBar 사용하여 Outlook 표시줄 탭 컨트롤을 호스트합니다. 자세한 내용은 CMFCOutlookBar 클래스를 참조 하세요.

예시

다음 예제에서는 개체를 초기화 하 고 클래스에서 다양 한 CMFCOutlookBarTabCtrl 메서드를 CMFCOutlookBarTabCtrl 사용 하는 방법을 보여 줍니다. 이 예제에서는 Outlook 표시줄의 탭 페이지 단추에서 텍스트 레이블의 현재 위치 편집을 사용하도록 설정하고, 애니메이션을 사용하도록 설정하고, 사용자가 Outlook 표시줄 창에서 단추를 스크롤할 수 있는 스크롤 핸들을 사용하도록 설정하고, Outlook 탭 컨트롤의 테두리 크기를 설정하고, Outlook 표시줄의 탭 단추에서 텍스트 레이블의 맞춤을 설정하는 방법을 보여 줍니다. 이 코드 조각은 Outlook 데모 샘플의 일부입니다.

// CMFCOutlookBar& bar
CMFCOutlookBarTabCtrl *pOutlookBar = (CMFCOutlookBarTabCtrl*)bar.GetUnderlyingWindow();

pOutlookBar->EnableInPlaceEdit(TRUE);
pOutlookBar->EnableAnimation();
pOutlookBar->EnableScrollButtons();
pOutlookBar->SetBorderSize(10);
pOutlookBar->SetPageButtonTextAlign(TA_LEFT);

상속 계층 구조

CObject

CCmdTarget

CWnd

CMFCBaseTabCtrl

CMFCOutlookBarTabCtrl

요구 사항

헤더: afxoutlookbartabctrl.h

CMFCOutlookBarTabCtrl::AddControl

Outlook 표시줄에서 Windows 컨트롤을 새 탭으로 추가합니다.

void AddControl(
    CWnd* pWndCtrl,
    LPCTSTR lpszName,
    int nImageID=-1,
    BOOL bDetachable=TRUE,
    DWORD dwControlBarStyle=AFX_CBRS_FLOAT |  AFX_CBRS_CLOSE | AFX_CBRS_RESIZE |  CBRS_AFX_AUTOHIDE);

매개 변수

pWndCtrl
[in] 추가할 컨트롤에 대한 포인터입니다.

lpszName
[in] 탭의 이름을 지정합니다.

bDetachable
[in] TRUE이면 페이지가 분리 가능으로 만들어집니다.

nImageID
[in] 새 탭에 표시할 이미지에 대한 내부 이미지 목록의 이미지 인덱스입니다.

dwControlBarStyle
[in] 래핑된 도킹 창의 AFX_ CBRS_* 스타일을 지정합니다.

설명

이 함수를 사용하여 Outlook 표시줄의 새 페이지로 컨트롤을 추가합니다.

이 함수는 CMFCBaseTabCtrl::AddTab을 내부적으로 호출합니다.

bDetachable을 TRUE AddControl 로 설정하면 내부적으로 개체를 CDockablePaneAdapter 만들고 추가된 컨트롤을 래핑합니다. 탭 창의 런타임 클래스를 런타임 클래스의 CMFCOutlookBar 런타임 클래스로 자동으로 설정하고 부동 프레임 CMultiPaneFrameWnd의 런타임 클래스를 .로 설정합니다.

예시

다음 예제에서는 클래스에서 메서드를 AddControl 사용 하는 방법을 보여 줍니다 CMFCOutlookBarTabCtrl . 이 코드 조각은 Outlook 데모 샘플의 일부입니다.

// CMFCOutlookBarTabCtrl* pOutlookBar
// DWORD dwStyle = AFX_CBRS_FLOAT | AFX_CBRS_AUTOHIDE | AFX_CBRS_RESIZE
// CMFCOutlookBarPane pane1
// The third parameter is the image index.
pOutlookBar->AddControl(&pane1, _T("General"), 0, TRUE, dwStyle);

CMFCOutlookBarTabCtrl::CanShowFewerPageButtons

크기 조정 작업 중에 프레임워크에서 호출하여 현재 표시되는 것보다 적은 수의 Outlook 표시줄 탭 페이지 단추를 표시할 수 있는지 여부를 확인합니다.

virtual BOOL CanShowFewerPageButtons() const;

Return Value

둘 이상의 단추가 있는 경우 TRUE입니다. 그렇지 않으면 FALSE입니다.

설명

Outlook 표시줄 탭 컨트롤은 사용 가능한 공간의 양에 따라 디스플레이에서 탭을 동적으로 추가하거나 제거합니다. 이 메서드는 프레임워크에서 해당 프로세스를 지원하는 데 사용됩니다.

CMFCOutlookBarTabCtrl::CanShowMorePageButtons

크기 조정 작업 중에 프레임워크에서 호출하여 현재 표시되는 것보다 더 많은 Outlook 표시줄 탭 페이지 단추를 표시할 수 있는지 여부를 확인합니다.

virtual BOOL CanShowMorePageButtons() const;

Return Value

현재 표시되지 않는 단추가 있는 경우 TRUE입니다. 그렇지 않으면 FALSE입니다.

설명

Outlook 표시줄 탭 컨트롤은 사용 가능한 공간의 양에 따라 디스플레이에서 탭을 동적으로 추가하거나 제거합니다. 이 메서드는 프레임워크에서 해당 프로세스를 지원하는 데 사용됩니다.

CMFCOutlookBarTabCtrl::Create

Outlook 표시줄 탭 컨트롤을 만듭니다.

virtual BOOL Create(
    const CRect& rect,
    CWnd* pParentWnd,
    UINT nID);

매개 변수

rect
[in] 초기 크기 및 위치를 픽셀 단위로 지정합니다.

pParentWnd
[in] 부모 창을 가리킵니다. NULL이 아니어야 합니다.

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

Return Value

컨트롤이 성공적으로 만들어진 경우 0이 아닌 경우 그렇지 않으면 0입니다.

설명

일반적으로 OUTLOOK 표시줄 탭 컨트롤은 CMFCOutlookBar 클래스가 프로세스의 WM_CREATE 메시지를 제어할 때 만들어집니다.

CMFCOutlookBarTabCtrl::EnableAnimation

활성 탭 간 전환 중에 발생하는 애니메이션을 사용할 수 있는지 여부를 지정합니다.

static void EnableAnimation(BOOL bEnable=TRUE);

매개 변수

bEnable
[in] 애니메이션을 사용할지 아니면 사용하지 않도록 설정해야 하는지를 지정합니다.

설명

애니메이션을 사용하거나 사용하지 않도록 설정하려면 이 함수를 호출합니다. 사용자가 탭 페이지를 열면 애니메이션이 활성화된 경우 페이지의 캡션이 위아래로 슬라이드됩니다. 애니메이션을 사용하지 않도록 설정하면 페이지가 즉시 활성화됩니다.

기본적으로 애니메이션은 사용하도록 설정됩니다.

CMFCOutlookBarTabCtrl::EnableInPlaceEdit

사용자가 Outlook 표시줄의 탭 페이지 단추에서 텍스트 레이블을 수정할 수 있는지 여부를 지정합니다.

virtual void EnableInPlaceEdit(BOOL bEnable);

매개 변수

bEnable
TRUE이면 텍스트 레이블의 현재 위치 편집을 사용하도록 설정합니다. FALSE이면 현재 위치 편집을 사용하지 않도록 설정합니다.

설명

탭 페이지 단추에서 텍스트 레이블의 현재 위치 편집을 사용하거나 사용하지 않도록 설정하려면 이 함수를 호출합니다. 기본적으로 현재 위치 편집은 사용하지 않도록 설정됩니다.

CMFCOutlookBarTabCtrl::EnableScrollButtons

사용자가 Outlook 표시줄 창에서 단추를 스크롤할 수 있도록 하는 스크롤 핸들을 사용하도록 설정하기 위해 프레임워크에서 호출됩니다.

void EnableScrollButtons(
    BOOL bEnable = TRUE,
    BOOL bIsUp = TRUE,
    BOOL bIsDown = TRUE);

매개 변수

bEnable
[in] 스크롤 단추가 표시되는지 여부를 결정합니다.

bIsUp
[in] 위쪽 스크롤 막대가 표시되는지 여부를 결정합니다.

bIsDown
[in] 아래쪽 스크롤 막대가 표시되는지 여부를 결정합니다.

설명

스크롤 단추를 표시할 수 있습니다. 이 메서드는 활성 탭이 스크롤 단추를 복원하기 위해 변경되면 프레임워크에서 호출됩니다.

CMFCOutlookBarTabCtrl::GetBorderSize

Outlook 탭 컨트롤의 테두리 크기를 반환합니다.

int GetBorderSize() const;

Return Value

테두리 크기(픽셀)입니다.

CMFCOutlookBarTabCtrl::GetVisiblePageButtons

int GetVisiblePageButtons() const;

Return Value

설명

CMFCOutlookBarTabCtrl::IsAnimation

활성 탭 간 전환 중에 발생하는 애니메이션을 사용할 수 있는지 여부를 지정합니다.

static BOOL IsAnimation();

Return Value

애니메이션이 활성화된 경우 0이 아닌 경우 그렇지 않으면 0입니다.

설명

CMFCOutlookBarTabCtrl::EnableAnimation 함수를 호출하여 애니메이션을 사용하거나 사용하지 않도록 설정합니다.

CMFCOutlookBarTabCtrl::IsMode2003

Outlook 표시줄 탭 컨트롤이 Microsoft Outlook 2003을 에뮬레이트하는 모드에 있는지 여부를 확인합니다.

BOOL IsMode2003() const;

Return Value

Outlook 표시줄 탭 컨트롤이 Outlook 2003 모드인 경우 TRUE입니다. 그렇지 않으면 FALSE입니다.

설명

이 값은 CMFCOutlookBar::SetMode2003에 의해 설정됩니다.

CMFCOutlookBarTabCtrl::OnShowFewerPageButtons

표시되는 탭 페이지 단추 수를 줄이기 위해 프레임워크에서 호출됩니다.

virtual void OnShowFewerPageButtons();

설명

이 메서드는 컨트롤 크기가 조정될 때 표시되는 페이지 탭 단추 수를 조정합니다.

CMFCOutlookBarTabCtrl::OnShowMorePageButtons

표시되는 탭 페이지 단추 수를 늘리기 위해 프레임워크에서 호출됩니다.

virtual void OnShowMorePageButtons();

설명

이 메서드는 컨트롤의 크기가 조정될 때 표시되는 탭 페이지 단추 수를 조정합니다.

CMFCOutlookBarTabCtrl::OnShowOptions

탐색 창 옵션 대화 상자를 표시합니다.

virtual void OnShowOptions();

설명

탐색 창 옵션 대화 상자를 사용하면 표시할 탭 페이지 단추와 표시되는 순서를 선택할 수 있습니다.

이 메서드는 사용자가 컨트롤의 사용자 지정 메뉴에서 탐색 창 옵션 메뉴 항목을 선택할 때 프레임워크에서 호출됩니다.

CMFCOutlookBarTabCtrl::SetActiveTab

활성 탭을 설정합니다. 활성 탭은 열려 있는 탭이며 해당 내용이 표시됩니다.

virtual BOOL SetActiveTab(int iTab);

매개 변수

iTab
[in] 열 탭의 인덱스(0부터 시작)입니다.

Return Value

지정한 탭이 성공적으로 열려 있으면 0이 아닌 경우 그렇지 않으면 0입니다.

설명

활성 탭 설정의 시각적 효과는 애니메이션을 사용하도록 설정했는지 여부에 따라 달라집니다. 자세한 내용은 CMFCOutlookBarTabCtrl::EnableAnimation을 참조하세요.

CMFCOutlookBarTabCtrl::SetBorderSize

Outlook 탭 컨트롤의 테두리 크기를 설정합니다.

void SetBorderSize(int nBorderSize);

매개 변수

nBorderSize
[in] 새 테두리 크기를 픽셀 단위로 지정합니다.

설명

새 테두리 크기를 설정하고 Outlook 창 레이아웃을 다시 계산합니다.

CMFCOutlookBarTabCtrl::SetPageButtonTextAlign

Outlook 표시줄의 탭 단추에 있는 텍스트 레이블의 맞춤을 설정합니다.

void SetPageButtonTextAlign(
    UINT uiAlign,
    BOOL bRedraw=TRUE);

매개 변수

uiAlign
[in] 텍스트 맞춤을 지정합니다.

bRedraw
[in] TRUE이면 Outlook 창이 다시 그려지게 됩니다.

설명

이 함수를 사용하여 페이지 단추의 텍스트 맞춤을 변경할 수 있습니다.

uiAlign 은 다음 값 중 하나일 수 있습니다.

상수 의미
TA_LEFT 왼쪽 맞춤
TA_CENTER 가운데 맞춤
TA_RIGHT 오른쪽 맞춤

기본값은 TA_CENTER.

CMFCOutlookBarTabCtrl::SetToolbarImageList

Outlook 2003 모드의 Outlook 표시줄 아래쪽에 표시되는 아이콘이 포함된 비트맵을 설정합니다.

BOOL SetToolbarImageList(
    UINT uiID,
    int cx,
    COLORREF clrTransp=RGB(255, 0, 255));

매개 변수

uiID
[in] 로드할 이미지의 리소스 ID를 지정합니다.

cx
[in] 이미지 목록의 이미지 너비를 픽셀 단위로 지정합니다.

clrTransp
[in] 투명한 색을 지정하는 RGB 값입니다.

Return Value

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

설명

이 함수를 사용하여 Microsoft Office 2003 모드의 도구 모음 단추에 이미지가 표시되는 이미지 목록을 첨부합니다. 이미지 인덱스는 페이지 인덱스에 해당해야 합니다.

Microsoft Office 2003 모드가 아닌 경우 이 메서드를 호출하면 안 됩니다. 자세한 내용은 CMFCOutlookBar 클래스를 참조 하세요.

CMFCOutlookBarTabCtrl::SetVisiblePageButtons

void SetVisiblePageButtons(int nVisiblePageButtons);

매개 변수

[in] nVisiblePageButtons

설명

참고 항목

계층 구조 차트
클래스
CMFCBaseTabCtrl 클래스
CMFCOutlookBar 클래스
CMFCOutlookBarPane 클래스