다음을 통해 공유

CMFCOutlookBarPane 클래스

  • 아티클

더 자세한 내용은 Visual Studio 설치의 VC\atlmfc\src\mfc 폴더에 있는 소스 코드를 참조하세요.

Outlook 표시줄(CMFCOutlookBar 클래스)에 삽입할 수 있는 CMFCToolBar 클래스에서 파생된 컨트롤입니다. Outlook 표시줄 창에 큰 단추의 열이 포함되어 있습니다. 단추 목록이 창보다 크면 위 아래로 스크롤할 수 있습니다. 사용자가 Outlook 표시줄 창을 Outlook 표시줄에서 분리하면 기본 프레임 창에서 이동하거나 도킹할 수 있습니다.

구문

class CMFCOutlookBarPane : public CMFCToolBar

멤버

공용 생성자

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

공용 메서드

이름 설명
CMFCOutlookBarPane::AddButton Outlook 표시줄 창에 단추를 추가합니다.
CMFCOutlookBarPane::CanBeAttached 창을 다른 창이나 프레임 창에 도킹할 수 있는지 여부를 결정합니다. (재정의 CBasePane::CanBeAttached.)
CMFCOutlookBarPane::CanBeRestored 시스템이 사용자 지정 후 도구 모음을 원래 상태로 복원할 수 있는지 여부를 결정합니다. (재정의 CMFCToolBar::CanBeRestored.)
CMFCOutlookBarPane::ClearAll Outlook 표시줄 창에서 이미지에서 사용하는 리소스를 해제합니다.
CMFCOutlookBarPane::Create Outlook 표시줄 창을 만듭니다.
CMFCOutlookBarPane::CreateObject 프레임워크에서 이 클래스 형식의 동적 인스턴스를 만드는 데 사용합니다.
CMFCOutlookBarPane::Dock Outlook 표시줄 창을 도킹하기 위해 프레임워크에서 호출됩니다. ( CPane::Dock을 재정의합니다.)
CMFCOutlookBarPane::EnablePageScrollMode Outlook 표시줄 창의 스크롤 화살표가 페이지별로 또는 단추별로 단추 목록을 앞으로 진행할지 여부를 지정합니다.
CMFCOutlookBarPane::GetRegularColor Outlook 표시줄 창의 일반(선택되지 않은) 텍스트 색을 반환합니다.
CMFCOutlookBarPane::GetThisClass 프레임워크에서 이 클래스 형식과 연결된 CRuntimeClass 개체에 대한 포인터를 가져오는 데 사용됩니다.
CMFCOutlookBarPane::IsBackgroundTexture Outlook 표시줄 창에 대해 로드된 배경 이미지가 있는지 여부를 확인합니다.
CMFCOutlookBarPane::IsChangeState 부동 창이 도킹될 수 있는지 여부를 결정합니다. ( CPane::IsChangeState을 재정의합니다.)
CMFCOutlookBarPane::IsDrawShadedHighlight 단추가 강조 표시되고 배경 이미지가 표시될 때 단추 테두리가 음영 처리되는지 여부를 결정합니다.
CMFCOutlookBarPane::OnBeforeFloat 창이 부동하려고 할 때 프레임워크에서 호출됩니다. (재정의 CPane::OnBeforeFloat.)
CMFCOutlookBarPane::RemoveButton 지정된 명령 ID가 있는 단추를 제거합니다.
CMFCOutlookBarPane::RestoreOriginalstate 도구 모음의 원래 상태를 복원합니다. (재정의 CMFCToolBar::RestoreOriginalState.)
CMFCOutlookBarPane::SetBackColor 배경색을 설정합니다.
CMFCOutlookBarPane::SetBackImage 배경 이미지를 설정합니다.
CMFCOutlookBarPane::SetDefaultState Outlook 표시줄 창을 원래 단추 집합으로 다시 설정합니다.
CMFCOutlookBarPane::SetExtraSpace Outlook 표시줄 창에서 단추 주위에 사용되는 안쪽 여백의 픽셀 수를 설정합니다.
CMFCOutlookBarPane::SetTextColor Outlook 표시줄 창에서 일반 텍스트와 강조 표시된 텍스트의 색을 설정합니다.
CMFCOutlookBarPane::SetTransparentColor Outlook 표시줄 창의 투명한 색을 설정합니다.
CMFCOutlookBarPane::SmartUpdate 내부적으로 Outlook 표시줄을 업데이트하는 데 사용됩니다. ( CMFCToolBar::SmartUpdate을 재정의합니다.)

보호된 메서드

속성 설명
CMFCOutlookBarPane::EnableContextMenuItems 사용자 지정 모드로 표시되는 바로 가기 메뉴 항목을 지정합니다.
CMFCOutlookBarPane::RemoveAllButtons Outlook 표시줄 창에서 모든 단추를 제거합니다. (재정의 CMFCToolBar::RemoveAllButtons.)

설명

Outlook 표시줄을 구현하는 방법에 대한 자세한 내용은 CMFCOutlookBar 클래스를 참조 하세요.

Outlook 표시줄의 예제는 OutlookDemo 샘플 프로젝트를 참조하세요.

예시

다음 예제에서는 클래스의 다양 한 메서드를 사용 하는 방법을 보여 줍니다 CMFCOutlookBarPane . 이 예제에서는 Outlook 표시줄 창을 만들고, 페이지 스크롤 모드를 사용하도록 설정하고, 도킹을 사용하도록 설정하고, Outlook 표시줄의 배경색을 설정하는 방법을 보여 줍니다. 이 코드 조각은 Outlook 다중 보기 샘플의 일부입니다.

CMFCOutlookBarPane m_wndShortcutsPane1;

CImageList images;
images.Create(IDB_SHORTCUTS, 32, 0, RGB(255, 0, 255));

// Create first page:
m_wndShortcutsPane1.Create(&m_wndShortcutsBar, AFX_DEFAULT_TOOLBAR_STYLE, ID_SHORTCUTS_PANE_1);
// The this pointer points to a CMainFrame class which extends the CFrameWnd class
m_wndShortcutsPane1.SetOwner(this);
m_wndShortcutsPane1.EnableTextLabels();
m_wndShortcutsPane1.EnableDocking(CBRS_ALIGN_ANY);
m_wndShortcutsPane1.EnablePageScrollMode();
m_wndShortcutsPane1.SetBackColor(RGB(0, 255, 0));

m_wndShortcutsPane1.AddButton(images.ExtractIcon(0), _T("View 1"), ID_SHORTCUT_1);
m_wndShortcutsPane1.AddButton(images.ExtractIcon(1), _T("View 2"), ID_SHORTCUT_2);
m_wndShortcutsPane1.AddButton(images.ExtractIcon(2), _T("View 3"), ID_SHORTCUT_3);
m_wndShortcutsPane1.AddButton(images.ExtractIcon(3), _T("View 4"), ID_SHORTCUT_4);

상속 계층 구조

CObject

CCmdTarget

CWnd

CBasePane

CPane

CMFCBaseToolBar

CMFCToolBar

CMFCOutlookBarPane

요구 사항

헤더: afxoutlookbarpane.h

CMFCOutlookBarPane::AddButton

Outlook 표시줄 창에 단추를 추가합니다.

BOOL AddButton(
    UINT uiImage,
    LPCTSTR lpszLabel,
    UINT iIdCommand,
    int iInsertAt=-1);

BOOL AddButton(
    UINT uiImage,
    UINT uiLabel,
    UINT iIdCommand,
    int iInsertAt=-1);

BOOL AddButton(
    LPCTSTR szBmpFileName,
    LPCTSTR szLabel,
    UINT iIdCommand,
    int iInsertAt=-1);

BOOL AddButton(
    HBITMAP hBmp,
    LPCTSTR lpszLabel,
    UINT iIdCommand,
    int iInsertAt=-1);

BOOL AddButton(
    HICON hIcon,
    LPCTSTR lpszLabel,
    UINT iIdCommand,
    int iInsertAt=-1,
    BOOL bAlphaBlend=FALSE);

매개 변수

uiImage
[in] 비트맵의 리소스 식별자를 지정합니다.

lpszLabel
[in] 단추의 텍스트를 지정합니다.

iIdCommand
[in] 단추 컨트롤의 ID를 지정합니다.

iInsertAt
[in] 단추를 삽입할 Outlook 표시줄 페이지의 인덱스(0부터 시작하는 인덱스)를 지정합니다.

uiLabel
[in] 문자열 리소스 ID입니다.

szBmpFileName
[in] 로드할 디스크 이미지 파일의 이름을 지정합니다.

szLabel
[in] 단추의 텍스트를 지정합니다.

hBmp
[in] 단추의 비트맵에 대한 핸들입니다.

hIcon
[in] 단추 아이콘에 대한 핸들입니다.

Return Value

단추가 성공적으로 추가되었으면 TRUE입니다. 그렇지 않으면 FALSE입니다.

설명

이 메서드를 사용하여 Outlook 표시줄의 페이지에 새 단추를 삽입합니다. 단추의 이미지는 애플리케이션 리소스 또는 디스크 파일에서 로드할 수 있습니다.

uiPageID로 지정된 페이지 ID가 -1이면 단추가 첫 번째 페이지에 삽입됩니다.

iInsertAt에서 지정한 인덱스가 -1이면 페이지 끝에 단추가 추가됩니다.

CMFCOutlookBarPane::CanBeAttached

더 자세한 내용은 Visual Studio 설치의 VC\atlmfc\src\mfc 폴더에 있는 소스 코드를 참조하세요.

virtual BOOL CanBeAttached() const;

Return Value

설명

CMFCOutlookBarPane::ClearAll

Outlook 표시줄 창에서 이미지에서 사용하는 리소스를 해제합니다.

void ClearAll();

설명

이 메서드는 CMFCToolBarImages::Clear를 직접 호출하며 Outlook 표시줄 창에서 사용되는 이미지에서 호출됩니다.

CMFCOutlookBarPane::Create

Outlook 표시줄 창을 만듭니다.

virtual BOOL Create(
    CWnd* pParentWnd,
    DWORD dwStyle=AFX_DEFAULT_TOOLBAR_STYLE,
    UINT uiID=(UINT)-1,
    DWORD dwControlBarStyle=0);

매개 변수

pParentWnd
[in] Outlook 표시줄 창 컨트롤의 부모 창을 지정합니다. NULL이 아니어야 합니다.

dwStyle
[in] 창 스타일입니다. 창 스타일 목록은 창 스타일을 참조 하세요.

uiID
[in] 컨트롤 ID입니다. 컨트롤의 상태를 저장할 수 있도록 하려면 고유해야 합니다.

dwControlBarStyle
[in] Outlook 표시줄에서 분리할 때 Outlook 막대 창 컨트롤의 동작을 정의하는 특수 스타일을 지정합니다.

Return Value

메서드가 성공하면 TRUE입니다. 그렇지 않으면 FALSE입니다.

설명

개체를 CMFCOutlookBarPane 생성하려면 먼저 생성자를 호출한 다음 호출 Create합니다. 그러면 Outlook 막대 창 컨트롤이 만들어지고 개체에 CMFCOutlookBarPane 연결됩니다.

자세한 내용은 dwControlBarStyle CBasePane::CreateEx를 참조하세요.

CMFCOutlookBarPane::EnableContextMenuItems

사용자 지정 모드로 표시되는 바로 가기 메뉴 항목을 지정합니다.

virtual BOOL EnableContextMenuItems(
    CMFCToolBarButton* pButton,
    CMenu* pPopup);

매개 변수

pButton
[in] 사용자가 클릭한 도구 모음 단추에 대한 포인터입니다.

pPopup
[in] 바로 가기 메뉴에 대한 포인터입니다.

Return Value

바로 가기 메뉴를 표시해야 하는 경우 TRUE를 반환합니다. 그렇지 않으면 FALSE입니다.

설명

프레임워크가 사용자 지정 모드로 표시하는 프레임워크 표준 바로 가기 메뉴를 수정하려면 이 메서드를 재정의합니다.

기본 구현은 사용자 지정 모드(CMFCToolBar::IsCustomizeMode)를 확인하고 TRUE로 설정된 경우 삭제를 제외한 모든 바로 가기 메뉴 항목을 사용하지 않도록 설정합니다. 그런 다음 입력 매개 변수를 .에 전달합니다 CMFCToolBar::EnableContextMenuItems.

참고 항목

상황에 맞는 메뉴 는 바로 가기 메뉴의 동의어입니다.

CMFCOutlookBarPane::EnablePageScrollMode

Outlook 표시줄 창의 스크롤 화살표를 페이지별로 단추 목록으로 이동하거나 단추로 앞으로 이동시킬지 여부를 지정합니다.

void EnablePageScrollMode(BOOL bPageScroll=TRUE);

매개 변수

bPageScroll
[in] TRUE이면 페이지 스크롤 모드를 사용하도록 설정합니다. FALSE이면 페이지 스크롤 모드를 사용하지 않도록 설정합니다.

CMFCOutlookBarPane::GetRegularColor

Outlook 표시줄 창의 일반 텍스트 색(즉, 선택되지 않은)을 반환합니다.

DECLARE_MESSAGE_MAPCOLORREF GetRegularColor() const;

Return Value

RGB 색 값으로 현재 텍스트 색입니다.

설명

CMFCOutlookBarPane::SetTextColor를 사용하여 Outlook 표시줄의 현재(일반 및 선택한) 텍스트 색을 설정합니다. COLOR_WINDOW 인덱스를 사용하여 GetSysColor 함수를 호출하여 기본 텍스트 색을 가져올 수 있습니다.

CMFCOutlookBarPane::IsBackgroundTexture

Outlook 표시줄 창에 대해 로드된 배경 이미지가 있는지 여부를 확인합니다.

BOOL IsBackgroundTexture() const;

Return Value

표시할 배경 이미지가 있으면 TRUE이고, 그렇지 않으면 FALSE입니다.

설명

CMFCOutlookBarPane::SetBackImage 함수를 호출하여 배경 이미지를 추가할 수 있습니다.

배경 이미지가 없으면 CMFCOutlookBarPane::SetBackColor를 사용하여 지정된 색으로 배경이 그려집니다.

CMFCOutlookBarPane::IsDrawShadedHighlight

단추가 강조 표시되고 배경 이미지가 표시될 때 단추 테두리가 음영 처리되는지 여부를 결정합니다.

BOOL IsDrawShadedHighlight() const;

Return Value

단추의 테두리가 음영 처리되면 TRUE이고, 그렇지 않으면 FALSE입니다.

CMFCOutlookBarPane::RemoveAllButtons

Outlook 표시줄 창에서 모든 단추를 제거합니다.

virtual void RemoveAllButtons();

CMFCOutlookBarPane::RemoveButton

지정된 명령 ID가 있는 단추를 제거합니다.

BOOL RemoveButton(UINT iIdCommand);

매개 변수

iIdCommand
[in] 제거할 단추의 명령 ID를 지정합니다.

Return Value

단추가 성공적으로 제거되었으면 TRUE입니다. 지정한 명령 ID가 잘못되면 FALSE입니다.

CMFCOutlookBarPane::SetBackColor

Outlook 표시줄의 배경색을 설정합니다.

void SetBackColor(COLORREF color);

매개 변수

color
[in] 새 배경색을 지정합니다.

설명

Outlook 표시줄의 현재 배경색을 설정하려면 이 함수를 호출합니다. 배경색은 배경 이미지가 없는 경우에만 사용됩니다.

CMFCOutlookBarPane::SetBackImage

배경 이미지를 설정합니다.

void SetBackImage(UINT uiImageID);

매개 변수

uiImageID
[in] 이미지 리소스 ID를 지정합니다.

설명

Outlook 표시줄의 배경 이미지를 설정하려면 이 메서드를 호출합니다. 배경 이미지 목록은 포함된 CMFCToolBarImages 클래스 개체에 의해 관리됩니다.

CMFCOutlookBarPane::SetDefaultState

Outlook 표시줄 창을 원래 단추 집합으로 다시 설정합니다.

void SetDefaultState();

설명

이 메서드는 Outlook 표시줄 단추를 원래 집합으로 복원합니다. 이 메서드는 Outlook 표시줄 창의 다시 그리기를 트리거하지 않는다는 점을 제외하면 다음과 같습니다 CMFCOutlookBarPane::RestoreOriginalstate.

CMFCOutlookBarPane::SetExtraSpace

Outlook 표시줄 창에서 단추 주위에 사용되는 안쪽 여백의 픽셀 수를 설정합니다.

void SetExtraSpace()

CMFCOutlookBarPane::SetTextColor

Outlook 표시줄 창에서 일반 텍스트와 강조 표시된 텍스트의 색을 설정합니다.

void SetTextColor(
    COLORREF clrRegText,
    COLORREF clrSelText=0);

매개 변수

clrRegText
[in] 선택하지 않은 텍스트의 새 색을 지정합니다.

clrSelText
[in] 선택한 텍스트의 새 색을 지정합니다.

CMFCOutlookBarPane::SetTransparentColor

Outlook 표시줄 창의 투명한 색을 설정합니다.

void SetTransparentColor(COLORREF color);

매개 변수

color
새 투명 색을 지정합니다.

설명

투명한 이미지를 표시하려면 투명한 색이 필요합니다. 이미지에서 이 색이 나타나는 경우 대신 배경색으로 그려집니다. 배경 및 전경 이미지의 혼합은 없습니다.

참고 항목

계층 구조 차트
클래스
CMFCToolBar 클래스
CMFCOutlookBar 클래스
CMFCOutlookBarTabCtrl 클래스