다음을 통해 공유


CMFCAutoHideBar 클래스

CMFCAutoHideBar 클래스는 자동 숨기기 기능을 구현하는 특수 도구 모음 클래스입니다.

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

구문

class CMFCAutoHideBar : public CPane

멤버

공용 생성자

속성 설명
CMFCAutoHideBar::CMFCAutoHideBar

공용 메서드

이름 설명
CMFCAutoHideBar::AddAutoHideWindow
CMFCAutoHideBar::AllowShowOnPaneMenu ( CPane::AllowShowOnPaneMenu을 재정의합니다.)
CMFCAutoHideBar::CalcFixedLayout (재정의 CBasePane::CalcFixedLayout.)
CMFCAutoHideBar::Create 컨트롤 막대를 만들어 CPane 개체에 연결합니다. (재정의 CPane::Create.)
CMFCAutoHideBar::GetFirstAHWindow
CMFCAutoHideBar::GetVisibleCount
CMFCAutoHideBar::OnShowControlBarMenu 특수 창 메뉴를 표시하려고 할 때 프레임워크에서 호출됩니다. (재정의 CPane::OnShowControlBarMenu.)
CMFCAutoHideBar::RemoveAutoHideWindow
CMFCAutoHideBar::SetActiveInGroup (재정의 CPane::SetActiveInGroup.)
CMFCAutoHideBar::SetRecentVisibleState
CMFCAutoHideBar::ShowAutoHideWindow
CMFCAutoHideBar::StretchPane 창을 가로 또는 세로로 확장합니다. (재정의 CBasePane::StretchPane.)
CMFCAutoHideBar::UnSetAutoHideMode
CMFCAutoHideBar::UpdateVisibleState

데이터 멤버

속성 설명
CMFCAutoHideBar::m_nShowAHWndDelay 사용자가 CMFCAutoHideButton 클래스 위에 마우스 커서를 놓는 시점과 프레임워크에 연결된 창이 표시되는 순간 사이의 시간 지연입니다.

설명

사용자가 도킹 창을 자동 숨기기 모드로 전환하면 프레임워크에서 자동으로 CMFCAutoHideBar 개체를 만듭니다. 또한 필요한 CAutoHideDockSiteCMFCAutoHideButton 개체를 만듭니다. 각 CAutoHideDockSite 개체는 개별 CMFCAutoHideButton에 연결됩니다.

CMFCAutoHideBar 클래스는 사용자의 마우스로 CMFCAutoHideButton을 가리킬 때 CAutoHideDockSite의 표시를 구현합니다. 도구 모음에서 WM_MOUSEMOVE 메시지를 받으면 CMFCAutoHideBar에서 타이머를 시작합니다. 타이머가 완료되면 도구 모음에 WM_TIMER 이벤트 알림을 보냅니다. 도구 모음은 마우스 포인터가 타이머가 시작될 때 배치되었던 것과 동일한 자동 숨기기 단추에 배치되었는지 확인하여 이 이벤트를 처리합니다. 그럴 경우 연결된 CAutoHideDockSite가 표시됩니다.

m_nShowAHWndDelay를 설정하여 타이머의 지연 길이를 제어할 수 있습니다. 기본값은 400ms입니다.

예시

다음 예제에서는 CMFCAutoHideBar 개체를 생성하고 해당 GetDockSiteRow 메서드를 사용하는 방법을 보여 줍니다.

CMFCAutoHideBar *pParentBar = new CMFCAutoHideBar();
CDockingPanesRow *pParentRow = pParentBar->GetDockSiteRow();

상속 계층 구조

CObject

CCmdTarget

CWnd

CBasePane

CPane

CMFCAutoHideBar

요구 사항

헤더: afxautohidebar.h

CMFCAutoHideBar::AddAutoHideWindow

자동으로 숨길 수 있도록 하는 기능을 CDockablePane 창에 추가합니다.

CMFCAutoHideButton* AddAutoHideWindow(
    CDockablePane* pAutoHideWnd,
    DWORD dwAlignment);

매개 변수

pAutoHideWnd
[in] 숨기려는 창입니다.

dwAlignment
[in] 애플리케이션 창과 자동 숨기기 단추의 맞춤을 지정하는 값입니다.

Return Value

설명

dwAlignment 매개 변수는 자동 숨기기 단추가 애플리케이션에 있는 위치를 나타냅니다. 이 매개 변수는 다음 값 중 하나가 될 수 있습니다.

  • CBRS_ALIGN_LEFT

  • CBRS_ALIGN_RIGHT

  • CBRS_ALIGN_TOP

  • CBRS_ALIGN_BOTTOM

CMFCAutoHideBar::AllowShowOnPaneMenu

virtual BOOL AllowShowOnPaneMenu() const;

Return Value

설명

CMFCAutoHideBar::CalcFixedLayout

virtual CSize CalcFixedLayout(
    BOOL bStretch,
    BOOL bHorz);

매개 변수

[in] bStretch

[in] bHorz

Return Value

설명

CMFCAutoHideBar::CMFCAutoHideBar

CMFCAutoHideBar 개체를 생성합니다.

CMFCAutoHideBar();

설명

CMFCAutoHideBar::Create

virtual BOOL Create(
    LPCTSTR lpszClassName,
    DWORD dwStyle,
    const RECT& rect,
    CWnd* pParentWnd,
    UINT nID,
    DWORD dwControlBarStyle = AFX_DEFAULT_PANE_STYLE,
    CCreateContext* pContext = NULL);

매개 변수

lpszClassName

dwStyle

rect

pParentWnd

nID

dwControlBarStyle

pContext

Return Value

설명

CMFCAutoHideBar::GetFirstAHWindow

애플리케이션의 첫 번째 자동 숨기기 창에 대한 포인터를 반환합니다.

CDockablePane* GetFirstAHWindow();

Return Value

애플리케이션의 첫 번째 자동 숨기기 창이거나, 없는 경우 NULL입니다.

설명

CMFCAutoHideBar::GetVisibleCount

표시되는 자동 숨기기 단추 수를 가져옵니다.

int GetVisibleCount();

Return Value

표시되는 자동 숨기기 단추 수를 반환합니다.

설명

CMFCAutoHideBar::m_nShowAHWndDelay

사용자가 CMFCAutoHideButton 클래스 위에 마우스 커서를 놓는 시점과 프레임워크에 연결된 창이 표시되는 순간 사이의 시간 지연입니다.

int CMFCAutoHideBar::m_nShowAHWndDelay = 400;

설명

사용자가 마우스 커서를 위에 CMFCAutoHideButton놓으면 프레임워크가 연결된 창을 표시하기 전에 약간의 지연이 발생합니다. 이 매개 변수는 해당 지연 시간(밀리초)을 결정합니다.

CMFCAutoHideBar::OnShowControlBarMenu

virtual BOOL OnShowControlBarMenu(CPoint);

매개 변수

[in] CPoint

Return Value

설명

CMFCAutoHideBar::RemoveAutoHideWindow

자동 숨기기 창을 제거하고 삭제합니다.

    BOOL RemoveAutoHideWindow(CDockablePane* pAutoHideWnd);

매개 변수

CDockablePane* pAutoHideWnd 제거할 자동 숨기기 창입니다.

Return Value

성공하면 TRUE이고, 실패하면 FALSE입니다.

설명

CMFCAutoHideBar::SetActiveInGroup

자동 숨기기 막대에 활성으로 플래그를 지정합니다.

virtual void SetActiveInGroup(BOOL bActive);

매개 변수

[in] BOOL bActive TRUE를 활성으로 설정하고, 그렇지 않으면 FALSE로 설정합니다.

설명

CPane::SetActiveInGroup을 참조하세요.

CMFCAutoHideBar::SetRecentVisibleState

void SetRecentVisibleState(BOOL bState);

매개 변수

bState
[in] 설정할 상태입니다.

설명

CMFCAutoHideBar::ShowAutoHideWindow

자동 숨기기 창을 표시합니다.

BOOL ShowAutoHideWindow(
    CDockablePane* pAutoHideWnd,
    BOOL bShow,
    BOOL bDelay);

매개 변수

pAutoHideWnd
[in] 표시할 창입니다.

bShow
[in] TRUE이면 창이 표시됩니다.

bDelay
[in] 이 매개 변수는 무시됩니다.

Return Value

성공하면 TRUE이고, 실패하면 FALSE입니다.

설명

CMFCAutoHideBar::StretchPane

CMFCAutoHideButton 개체에 맞게 자동 숨기기 막대의 크기를 축소된 상태로 조정합니다.

virtual CSize StretchPane(
    int nLength,
    BOOL bVert);

매개 변수

nLength
[in] 값은 기본 구현에서 사용되지 않습니다. 파생된 구현에서는 이 값을 사용하여 크기 조정된 창의 길이를 나타냅니다.

bVert
[in] 값은 기본 구현에서 사용되지 않습니다. 파생 구현에서 TRUE를 사용하여 자동 숨기기 막대가 세로로 축소되는 경우를 처리하고 자동 숨기기 막대가 가로로 축소되는 경우 FALSE를 사용합니다.

Return Value

크기 조정된 창의 결과 크기입니다.

설명

파생된 클래스는 이 메서드를 재정의하여 동작을 사용자 지정할 수 있습니다.

CMFCAutoHideBar::UnSetAutoHideMode

자동 숨기기 막대의 그룹에 대해 자동 숨기기 모드를 사용하지 않도록 설정합니다.

void UnSetAutoHideMode(CDockablePane* pFirstBarInGroup)

매개 변수

[in] pFirstBarInGroup 그룹의 첫 번째 자동 숨기기 막대에 대한 포인터입니다.

설명

CMFCAutoHideBar::UpdateVisibleState

자동 숨기기 막대를 다시 그려야 할 때 프레임워크에서 호출됩니다.

void UpdateVisibleState();

설명

참고 항목

계층 구조 차트
클래스
CPane 클래스
CAutoHideDockSite 클래스
CMFCAutoHideButton 클래스