영어로 읽기

다음을 통해 공유


CDockablePane 수업

도킹 사이트에 도킹되거나 탭 창에 포함될 수 있는 창을 구현합니다.

구문

class CDockablePane : public CPane

멤버

공용 생성자

속성 설명
CDockablePane::CDockablePane CDockablePane 개체를 생성하고 초기화합니다.

공용 메서드

이름 설명
CDockablePane::AttachToTabWnd 창을 다른 창에 연결합니다. 그러면 탭 창이 만들어집니다.
CDockablePane::CalcFixedLayout 창 사각형의 크기를 반환합니다.
CDockablePane::CanAcceptMiniFrame 지정된 미니 프레임을 창에 도킹할 수 있는지 여부를 결정합니다.
CDockablePane::CanAcceptPane 다른 창을 현재 창에 도킹할 수 있는지 여부를 결정합니다.
CDockablePane::CanAutoHide 창에서 자동 숨기기 모드를 지원하는지 여부를 결정합니다. ( CBasePane::CanAutoHide을 재정의합니다.)
CDockablePane::CanBeAttached 현재 창을 다른 창에 도킹할 수 있는지 여부를 결정합니다.
CDockablePane::ConvertToTabbedDocument 하나 이상의 도킹 가능한 창을 MDI 탭 문서로 변환합니다.
CDockablePane::CopyState 도킹 가능한 창의 상태를 복사합니다.
CDockablePane::Create Windows 컨트롤을 만들어 개체에 CDockablePane 연결합니다.
CDockablePane::CreateDefaultPaneDivider 틀 창에 도킹할 때 창의 기본 구분선이 만들어집니다.
CDockablePane::CreateEx Windows 컨트롤을 만들어 개체에 CDockablePane 연결합니다.
CDockablePane::CreateTabbedPane 현재 창에서 탭 창을 만듭니다.
CDockablePane::DockPaneContainer 컨테이너를 창에 도킹합니다.
CDockablePane::DockPaneStandard 개요(표준) 도킹을 사용하여 창을 도킹합니다.
CDockablePane::DockToFrameWindow 내부적으로 사용됩니다. 창을 CPane::DockPane CDockablePane::DockToWindow도킹하려면
CDockablePane::DockToRecentPos 저장된 최근 도킹 위치에 창을 도킹합니다.
CDockablePane::DockToWindow 한 도킹 창을 다른 도킹 창에 도킹합니다.
CDockablePane::EnableAutohideAll 컨테이너의 다른 창과 함께 이 창에 대한 자동 숨기기 모드를 사용하거나 사용하지 않도록 설정합니다.
CDockablePane::EnableGripper 캡션(그리퍼)을 표시하거나 숨깁니다.
CDockablePane::GetAHRestoredRect 자동 숨기기 모드에서 표시할 때 창의 위치를 지정합니다.
CDockablePane::GetAHSlideMode 창의 자동 숨기기 슬라이드 모드를 검색합니다.
CDockablePane::GetAutoHideButton 내부적으로 사용됩니다.
CDockablePane::GetAutoHideToolBar 내부적으로 사용됩니다.
CDockablePane::GetCaptionHeight 현재 캡션의 높이를 반환합니다.
CDockablePane::GetDefaultPaneDivider 창 컨테이너의 기본 창 나누기를 반환합니다.
CDockablePane::GetDockingStatus 제공된 포인터 위치에 따라 창이 도킹되는 기능을 결정합니다.
CDockablePane::GetDragSensitivity 도킹 창의 끌기 민감도를 반환합니다.
CDockablePane::GetLastPercentInPaneContainer 창이 컨테이너 내에서 차지하는 공간의 백분율을 검색합니다.
CDockablePane::GetTabArea 창의 탭 영역을 검색합니다.
CDockablePane::GetTabbedPaneRTC 다른 창이 현재 창에 도킹될 때 만들어지는 탭 창에 대한 런타임 클래스 정보를 반환합니다.
CDockablePane::HasAutoHideMode 도킹 창을 자동 숨기기 모드로 전환할 수 있는지 여부를 지정합니다.
CDockablePane::HitTest 사용자가 마우스를 클릭하는 창의 특정 위치를 지정합니다.
CDockablePane::IsAccessibilityCompatible 내부적으로 사용됩니다.
CDockablePane::IsAutohideAllEnabled 컨테이너의 도킹 창과 다른 모든 창을 자동 숨기기 모드로 배치할 수 있는지 여부를 나타냅니다.
CDockablePane::IsAutoHideMode 창이 자동 숨기기 모드인지 여부를 확인합니다.
CDockablePane::IsChangeState 내부적으로 사용됩니다.
CDockablePane::IsDocked 현재 창이 도킹되었는지 여부를 확인합니다.
CDockablePane::IsHideInAutoHideMode 호출 ShowPane하여 표시되거나 숨겨진 경우 자동 숨기기 모드에 있는 창의 동작을 결정합니다.
CDockablePane::IsInFloatingMultiPaneFrameWnd 창이 다중 창 프레임 창에 있는지 여부를 지정합니다.
CDockablePane::IsResizable 창의 크기 조정 가능 여부를 지정합니다.
CDockablePane::IsTabLocationBottom 탭이 창의 위쪽 또는 아래쪽에 있는지 여부를 지정합니다.
CDockablePane::IsTracked 사용자가 창을 끌지 여부를 지정합니다.
CDockablePane::IsVisible 현재 창이 표시되는지 여부를 확인합니다.
CDockablePane::LoadState 내부적으로 사용됩니다.
CDockablePane::OnAfterChangeParent 창의 부모가 변경될 때 프레임워크에서 호출됩니다. ( CPane::OnAfterChangeParent을 재정의합니다.)
CDockablePane::OnAfterDockFromMiniFrame 부동 도킹 막대가 프레임 창에 도킹되면 프레임워크에서 호출됩니다.
CDockablePane::OnBeforeChangeParent 창의 부모가 변경하려고 할 때 프레임워크에서 호출됩니다. ( CPane::OnBeforeChangeParent을 재정의합니다.)
CDockablePane::OnBeforeFloat 창이 부동하려고 할 때 프레임워크에서 호출됩니다. ( CPane::OnBeforeFloat을 재정의합니다.)
CDockablePane::RemoveFromDefaultPaneDividier 프레임워크는 창이 도킹 취소될 때 이 메서드를 호출합니다.
CDockablePane::ReplacePane 창을 지정된 창으로 바꿉니다.
CDockablePane::RestoreDefaultPaneDivider 프레임워크는 이 메서드를 기본 창 나누기를 복원하기 위해 창이 역직렬화되어 있다고 호출합니다.
CDockablePane::SaveState 내부적으로 사용됩니다.
CDockablePane::Serialize 창을 직렬화합니다. ( CBasePane::Serialize을 재정의합니다.)
CDockablePane::SetAutoHideMode 도킹 창을 표시 모드와 자동 숨기기 모드 간에 전환합니다.
CDockablePane::SetAutoHideParents 창의 자동 숨기기 단추와 자동 숨기기 도구 모음을 설정합니다.
CDockablePane::SetDefaultPaneDivider 내부적으로 사용됩니다.
CDockablePane::SetLastPercentInPaneContainer 창이 컨테이너 내에서 차지하는 공간의 백분율을 설정합니다.
CDockablePane::SetResizeMode 내부적으로 사용됩니다.
CDockablePane::SetRestoredDefaultPaneDivider 복원된 기본 창 나누기를 설정합니다.
CDockablePane::SetTabbedPaneRTC 두 창이 함께 도킹될 때 만들어지는 탭 창에 대한 런타임 클래스 정보를 설정합니다.
CDockablePane::ShowPane 창을 표시하거나 숨깁니다.
CDockablePane::Slide 창이 자동 숨기기 모드인 경우에만 표시되는 슬라이딩 애니메이션이 있는 창을 표시하거나 숨깁니다.
CDockablePane::ToggleAutoHide 자동 숨기기 모드를 전환합니다. (재정의 . CPane::ToggleAutoHide )
CDockablePane::UndockPane 주 프레임 창 또는 미니프레임 창 컨테이너에서 창을 도킹 해제합니다.
CDockablePane::UnSetAutoHideMode 내부적으로 사용됩니다. 자동 숨기기 모드를 설정하려면 CDockablePane::SetAutoHideMode

보호된 메서드

속성 설명
CDockablePane::CheckAutoHideCondition 도킹 창이 숨겨지는지 여부를 결정합니다(자동 숨기기 모드).
CDockablePane::CheckStopSlideCondition 자동 숨기기 도킹 창이 슬라이딩을 중지해야 하는 시기를 결정합니다.
CDockablePane::DrawCaption 도킹 창 캡션(그리기)을 그립니다.
CDockablePane::OnPressButtons 사용자가 및 AFX_HTMAXBUTTON 단추 이외의 AFX_HTCLOSE 캡션 단추를 누를 때 호출됩니다.
CDockablePane::OnSlide 창이 표시되거나 숨겨질 때 자동 숨기기 슬라이드 효과를 렌더링하기 위해 프레임워크에서 호출됩니다.

데이터 멤버

속성 설명
CDockablePane::m_bDisableAnimation 도킹 가능한 창의 자동 숨기기 애니메이션을 사용하지 않도록 설정할지 여부를 지정합니다.
CDockablePane::m_bHideInAutoHideMode 창이 자동 숨기기 모드일 때 창의 동작을 결정합니다.
CDockablePane::m_nSlideSteps 자동 숨기기 모드에서 창이 표시되거나 숨겨질 때 창의 애니메이션 속도를 지정합니다.

설명

CDockablePane 에서는 다음 기능을 구현합니다.

  • 창을 주 프레임 창에 도킹합니다.

  • 창을 자동 숨기기 모드로 전환

  • 탭 창에 창 연결

  • 미니프레임 창에 창 부동

  • 미니프레임 창에 떠 있는 다른 창에 창을 도킹합니다.

  • 창 크기 조정

  • 도킹 창에 대한 상태 로드 및 저장

    참고

    상태 정보는 Windows 레지스트리에 저장됩니다.

  • 캡션을 사용하거나 사용하지 않고 창을 만듭니다. 캡션에는 텍스트 레이블이 있을 수 있으며 그라데이션 색으로 채울 수 있습니다.

  • 창의 내용을 표시하는 동안 창 끌기

  • 끌어서 직사각형을 표시하는 동안 창을 끌어다 옵니다.

애플리케이션에서 도킹 창을 사용하려면 클래스에서 창 클래스를 CDockablePane 파생합니다. 파생 개체를 주 프레임 창 개체에 포함하거나 창의 인스턴스를 제어하는 창 개체에 포함합니다. 그런 다음 기본 프레임 창에서 메시지를 처리 WM_CREATE 할 때 메서드 또는 CDockablePane::CreateEx 메서드를 호출 CDockablePane::Create 합니다. 마지막으로 , 또는 CDockablePane::AttachToTabWnd를 호출CBasePane::EnableDockingCBasePane::DockPane하여 창 개체를 설정합니다.

사용자 지정 팁

다음 팁은 개체에 CDockablePane 적용됩니다.

  • 탭이 없는 도킹 가능한 두 창을 호출 CDockablePane::AttachToTabWnd 하면 탭 창에 대한 포인터가 매개 변수에 ppTabbedControlBar 반환됩니다. 이 매개 변수를 사용하여 탭 창에 탭을 계속 추가할 수 있습니다.

  • 만든 CDockablePane::AttachToTabWnd 탭 창의 종류는 매개 변수의 개체 pTabControlBarAttachToCDockablePane 의해 결정됩니다. 호출 CDockablePane::SetTabbedPaneRTC 하여 만들 탭 창 CDockablePane 의 종류를 설정할 수 있습니다. 기본 형식은 처음 만들 때의 dwTabbedStyle CDockablePane::Create 형식에 따라 결정됩니다 CDockablePane. 기본 형식CMFCOutlookBarAFX_CBRS_OUTLOOK_TABS 클래스이면 dwTabbedStyle 클래스이고, 기본 형식이 AFX_CBRS_REGULAR_TABSdwTabbedStyle Class입니다CTabbedPane.

  • 도킹 가능한 창을 다른 창에 도킹하려면 메서드를 호출합니다 CDockablePane::DockToWindow . 이 메서드를 호출하기 전에 원래 창이 어딘가에 도킹되어야 합니다.

  • 멤버 변수 CDockablePane::m_bHideInAutoHideMode 는 호출 CDockablePane::ShowPane할 때 도킹 가능한 창이 자동 숨기기 모드에서 동작하는 방식을 제어합니다. 이 멤버 변수를 TRUE설정하면 도킹 가능한 창과 자동 숨기기 단추가 숨겨집니다. 그렇지 않으면 슬라이드 내부 및 외부로 이동합니다.

  • 멤버 변수TRUE를 .로 설정하여 자동 숨기기 애니메이션을 CDockablePane::m_bDisableAnimation 사용하지 않도록 설정할 수 있습니다.

예시

다음 예제에서는 클래스의 다양한 메서드를 사용하여 개체를 CDockablePane 구성하는 방법을 보여 줍니다 CDockablePane . 이 예제에서는 도킹 가능한 창에 대해 모든 기능을 자동으로 숨기고, 캡션 또는 그리퍼를 사용하도록 설정하고, 자동 숨기기 모드를 사용하도록 설정하고, 창을 표시하고, 자동 숨기기 모드에 있는 창에 애니메이션 효과를 주는 방법을 보여 줍니다. 이 코드 조각은 Visual Studio 데모 샘플일부입니다.

// GetOwner is an inherited method.
CDockablePane *pParentBar = DYNAMIC_DOWNCAST(CDockablePane, GetOwner());

상속 계층 구조

CObject

CCmdTarget

CWnd

CBasePane

CPane

CDockablePane

요구 사항

머리글: afxDockablePane.h

CDockablePane::AttachToTabWnd

현재 창을 대상 창에 연결하여 탭 창을 만듭니다.

virtual CDockablePane* AttachToTabWnd(
    CDockablePane* pTabControlBarAttachTo,
    AFX_DOCK_METHOD dockMethod,
    BOOL bSetActive= TRUE,
    CDockablePane** ppTabbedControlBar = NULL);

매개 변수

pTabControlBarAttachTo
[in, out] 현재 창이 연결하는 대상 창을 지정합니다. 대상 창은 도킹 가능한 창이어야 합니다.

dockMethod
[in] 도킹 메서드를 지정합니다.

bSetActive
[in] TRUE 연결 작업 후 탭 창을 활성화하려면 입니다. 그렇지 않으면 . FALSE

ppTabbedControlBar
[out] 연결 작업으로 인한 탭 창을 포함합니다.

Return Value

탭 창이 아닌 경우 현재 창에 대한 포인터입니다. 그렇지 않으면 연결 작업으로 인한 탭 창에 대한 포인터입니다. 반환 값은 NULL 현재 창을 연결할 수 없거나 오류가 발생하는 경우입니다.

설명

이 메서드를 사용하여 하나의 도킹 가능한 창이 다른 창에 연결되면 다음이 발생합니다.

  1. 프레임워크는 대상 창 pTabControlBarAttachTo 이 일반 도킹 창인지 또는 파생되었는지 CBaseTabbedPane확인합니다.

  2. 대상 창이 탭 창인 경우 프레임워크는 현재 창을 탭으로 추가합니다.

  3. 대상 창이 일반 도킹 창인 경우 프레임워크는 탭 창을 만듭니다.

    • 프레임워크에서 .를 호출합니다 pTabControlBarAttachTo->CreateTabbedPane. 새 탭 창의 스타일은 멤버에 m_pTabbedControlBarRTC 따라 달라집니다. 기본적으로 이 멤버는 .의 CTabbedPane런타임 클래스로 설정됩니다. 스타일을 매개 변수로 메서드에 dwTabbedStyle CDockablePane::Create 전달 AFX_CBRS_OUTLOOK_TABS 하면 런타임 클래스 개체가 런타임 클래스로 CMFCOutlookBar설정됩니다. 언제든지 이 멤버를 변경하여 새 창의 스타일을 변경할 수 있습니다.

    • 이 메서드가 탭 창을 만들 때 프레임워크는 포인터를 pTabControlBarAttachTo 새 탭 창에 대한 포인터로 바꿉니다(창이 도킹되거나 다중 미니프레임 창에 부동하는 경우).

    • 프레임워크는 탭 창에 창을 첫 번째 탭으로 추가합니다 pTabControlBarAttachTo . 그런 다음 프레임워크는 현재 창을 두 번째 탭으로 추가합니다.

  4. 현재 창이 파생된 CBaseTabbedPane경우 모든 탭이 이동 pTabControlBarAttachTo 되고 현재 창이 제거됩니다. 따라서 현재 창에 대한 포인터가 메서드가 반환될 때 유효하지 않을 수 있으므로 이 메서드를 호출할 때는 주의해야 합니다.

도킹 레이아웃을 빌드할 때 한 창을 다른 창에 연결하는 경우 .로 DM_SHOW설정합니다dockMethod.

다른 창을 연결하기 전에 첫 번째 창을 도킹해야 합니다.

CDockablePane::CalcFixedLayout

창 사각형의 크기를 반환합니다.

virtual CSize CalcFixedLayout(
    BOOL bStretch,
    BOOL bHorz);

매개 변수

bStretch
[in] 사용되지 않습니다.

bHorz
[in] 사용되지 않습니다.

Return Value

CSize 창 사각형의 크기를 포함하는 개체입니다.

CDockablePane::CanAcceptMiniFrame

지정된 미니 프레임을 창에 도킹할 수 있는지 여부를 결정합니다.

virtual BOOL CanAcceptMiniFrame(CPaneFrameWnd* pMiniFrame) const;

매개 변수

pMiniFrame
[in] 개체에 대한 포인터입니다 CPaneFrameWnd .

Return Value

TRUE 창에 도킹할 수 있으면 pMiniFrame 이고, FALSE그렇지 않으면 .입니다.

CDockablePane::CanAcceptPane

다른 창을 현재 창에 도킹할 수 있는지 여부를 결정합니다.

virtual BOOL CanAcceptPane(const CBasePane* pBar) const;

매개 변수

pBar
[in] 현재 창에 도킹할 창을 지정합니다.

Return Value

TRUE지정된 창을 이 창에 도킹할 수 있으면 이고, 그렇지 않으면 . FALSE

설명

프레임워크는 창이 현재 창에 도킹되기 전에 이 메서드를 호출합니다.

특정 창에 도킹을 사용하거나 사용하지 않도록 설정하려면 파생 클래스에서 이 함수를 재정의합니다.

기본적으로 이 메서드는 부모 중 하나 pBar 또는 해당 부모가 형식CDockablePane이면 반환 TRUE 됩니다.

CDockablePane::CanAutoHide

창이 자동으로 숨겨질 수 있는지 여부를 결정합니다.

virtual BOOL CanAutoHide() const;

Return Value

TRUE창이 자동으로 숨겨질 수 있으면 이고, 그렇지 않으면 . FALSE

설명

CDockablePane::CanAutoHide 는 다음과 같은 경우에 반환 FALSE 됩니다.

  • 창에 부모가 없습니다.

  • 도킹 관리자는 창을 자동으로 숨기는 것을 허용하지 않습니다.

  • 창이 도킹되지 않습니다.

CDockablePane::CanBeAttached

현재 창을 다른 창에 도킹할 수 있는지 여부를 결정합니다.

virtual BOOL CanBeAttached() const;

Return Value

TRUE도킹 가능한 창을 다른 창이나 주 프레임 창에 도킹할 수 있으면 이고, 그렇지 않으면 . FALSE

설명

기본적으로 이 메서드는 항상 .TRUE 호출 CBasePane::EnableDocking하지 않고 도킹을 사용하거나 사용하지 않도록 설정하려면 파생 클래스에서 이 메서드를 재정의합니다.

CDockablePane::CDockablePane

CDockablePane 개체를 생성하고 초기화합니다.

CDockablePane();

설명

도킹 가능한 창 개체를 생성한 후 호출 CDockablePane::Create 하거나 CDockablePane::CreateEx 만듭니다.

CDockablePane::ConvertToTabbedDocument

하나 이상의 도킹 가능한 창을 MDI 탭 문서로 변환합니다.

virtual void ConvertToTabbedDocument(BOOL bActiveTabOnly = TRUE);

매개 변수

bActiveTabOnly
[in] 변환할 CTabbedPane때 활성 탭만 변환하도록 지정 TRUE 합니다. 창의 모든 탭을 변환하려면 지정 FALSE 하십시오.

CDockablePane::CheckAutoHideCondition

도킹 창이 숨겨져 있는지 여부를 확인합니다(자동 숨기기 모드라고도 함).

virtual BOOL CheckAutoHideCondition();

Return Value

TRUE숨기기 조건이 충족되면 이고, 그렇지 않으면 . FALSE

설명

프레임워크는 타이머를 사용하여 자동 숨기기 도킹 가능 창을 숨길지 여부를 주기적으로 확인합니다. 이 메서드는 창이 활성화되지 않고, 창의 크기가 조정되지 않고, 마우스 포인터가 창 위에 있지 않을 때 반환 TRUE 됩니다.

이전 조건이 모두 충족되면 프레임워크는 창을 숨기도록 호출 CDockablePane::Slide 합니다.

CDockablePane::CheckStopSlideCondition

자동 숨기기 도킹 창이 슬라이딩을 중지해야 하는 시기를 결정합니다.

virtual BOOL CheckStopSlideCondition(BOOL bDirection);

매개 변수

bDirection
[in] TRUE 창이 표시되면 FALSE 창이 숨겨져 있으면

Return Value

TRUE중지 조건이 충족되면 이고, 그렇지 않으면 . FALSE

설명

도킹 가능한 창이 자동 숨기기 모드로 설정된 경우 프레임워크는 슬라이딩 효과를 사용하여 창을 표시하거나 숨깁니다. 프레임워크는 창이 슬라이딩되는 경우 이 함수를 호출합니다. CheckStopSlideCondition 는 창이 완전히 표시되거나 완전히 숨겨지면 반환 TRUE 됩니다.

파생 클래스에서 이 메서드를 재정의하여 사용자 지정 자동 숨기기 효과를 구현합니다.

CDockablePane::CopyState

도킹 가능한 창의 상태를 복사합니다.

virtual void CopyState(CDockablePane* pOrgBar);

매개 변수

pOrgBar
[in] 도킹 가능한 창에 대한 포인터입니다.

설명

CDockablePane::CopyState 는 다음 메서드를 호출하여 현재 창의 상태를 pOrgBar 복사합니다.

CDockablePane::Create

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

virtual BOOL Create(
    LPCTSTR lpszCaption,
    CWnd* pParentWnd,
    const RECT& rect,
    BOOL bHasGripper,
    UINT nID,
    DWORD dwStyle,
    DWORD dwTabbedStyle = AFX_CBRS_REGULAR_TABS,
    DWORD dwControlBarStyle = AFX_DEFAULT_DOCKING_PANE_STYLE,
    CCreateContext* pContext = NULL);

virtual BOOL Create(
    LPCTSTR lpszWindowName,
    CWnd* pParentWnd,
    CSize sizeDefault,
    BOOL bHasGripper,
    UINT nID,
    DWORD dwStyle = WS_CHILD|WS_VISIBLE|CBRS_TOP|CBRS_HIDE_INPLACE,
    DWORD dwTabbedStyle = AFX_CBRS_REGULAR_TABS,
    DWORD dwControlBarStyle = AFX_DEFAULT_DOCKING_PANE_STYLE);

매개 변수

lpszCaption
[in] 창 이름을 지정합니다.

pParentWnd
[in, out] 부모 창을 지정합니다.

rect
[in] 창의 크기와 위치를 클라이언트 좌표로 지정합니다 pParentWnd.

bHasGripper
[in] TRUE 캡션이 있는 창을 만들려면 입니다. 그렇지 않으면 . FALSE

nID
[in] 자식 창의 ID를 지정합니다. 이 도킹 창의 도킹 상태를 저장하려면 이 값이 고유해야 합니다.

dwStyle
[in] 창 스타일 특성을 지정합니다.

dwTabbedStyle
[in] 사용자가 이 창의 캡션에서 창을 끌 때 만들어지는 탭 창의 탭 스타일을 지정합니다.

dwControlBarStyle
[in] 추가 스타일 특성을 지정합니다.

pContext
[in, out] 창의 만들기 컨텍스트를 지정합니다.

lpszWindowName
[in] 창 이름을 지정합니다.

sizeDefault
[in] 창의 크기를 지정합니다.

Return Value

TRUE도킹 가능한 창이 성공적으로 만들어지면 이고, 그렇지 않으면 . FALSE

설명

Windows 창을 만들어 개체에 CDockablePane 연결합니다.

창 스타일에 dwStyle 플래그가 있는 CBRS_FLOAT_MULTI 경우 미니프레임 창은 미니프레임 창의 다른 창과 함께 부동할 수 있습니다. 기본적으로 도킹 창은 개별적으로만 부동할 수 있습니다.

매개 변수에 dwTabbedStyle 플래그가 AFX_CBRS_OUTLOOK_TABS 지정된 경우 다른 창이 메서드를 사용하여 CDockablePane::AttachToTabWnd 이 창에 연결되면 창에서 Outlook 스타일 탭 창을 만듭니다. 기본적으로 도킹 가능한 창은 형식 CTabbedPane의 일반 탭 창을 만듭니다.

CDockablePane::CreateDefaultPaneDivider

틀 창에 도킹할 때 창의 기본 구분선이 만들어집니다.

static CPaneDivider* __stdcall CreateDefaultPaneDivider(
    DWORD dwAlignment,
    CWnd* pParent,
    CRuntimeClass* pSliderRTC = NULL);

매개 변수

dwAlignment
[in] 창이 도킹되는 주 프레임의 측면을 지정합니다. 또는 플래그를 CBRS_ALIGN_LEFT 포함하는 경우 dwAlignment 이 메서드는 세로(CPaneDivider::SS_VERT) 구분자를 만들고, 그렇지 않으면 이 메서드는 가로(CPaneDivider::SS_HORZ) 구분자를 만듭니다.CBRS_ALIGN_RIGHT

pParent
[in] 부모 프레임에 대한 포인터입니다.

pSliderRTC
[in] 사용되지 않습니다.

Return Value

이 메서드는 새로 만든 구분선에 대한 포인터를 반환하거나 NULL 나누기 만들기가 실패하는 경우 반환합니다.

설명

dwAlignment 은 다음 값 중 어느 것이든 될 수 있습니다.

설명
CBRS_ALIGN_TOP 창이 프레임 창의 클라이언트 영역 맨 위에 도킹되고 있습니다.
CBRS_ALIGN_BOTTOM 창이 프레임 창의 클라이언트 영역 아래쪽에 도킹되고 있습니다.
CBRS_ALIGN_LEFT 창이 프레임 창의 클라이언트 영역 왼쪽에 도킹되고 있습니다.
CBRS_ALIGN_RIGHT 창이 프레임 창의 클라이언트 영역 오른쪽에 도킹되고 있습니다.

CDockablePane::CreateEx

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

virtual BOOL CreateEx(
    DWORD dwStyleEx,
    LPCTSTR lpszCaption,
    CWnd* pParentWnd,
    const RECT& rect,
    BOOL bHasGripper,
    UINT nID,
    DWORD dwStyle,
    DWORD dwTabbedStyle = AFX_CBRS_REGULAR_TABS,
    DWORD dwControlBarStyle = AFX_DEFAULT_DOCKING_PANE_STYLE,
    CCreateContext* pContext = NULL);

매개 변수

dwStyleEx
[in] 새 창의 확장 스타일 특성을 지정합니다.

lpszCaption
[in] 창 이름을 지정합니다.

pParentWnd
[in, out] 부모 창을 지정합니다.

rect
[in] 창의 크기와 위치를 클라이언트 좌표로 지정합니다 pParentWnd.

bHasGripper
[in] TRUE 캡션이 있는 창을 만들려면 입니다. 그렇지 않으면 . FALSE

nID
[in] 자식 창의 ID를 지정합니다. 이 도킹 창의 도킹 상태를 저장하려면 이 값이 고유해야 합니다.

dwStyle
[in] 창 스타일 특성을 지정합니다.

dwTabbedStyle
[in] 사용자가 이 창의 캡션에서 창을 끌 때 만들어지는 탭 창의 탭 스타일을 지정합니다.

dwControlBarStyle
[in] 추가 스타일 특성을 지정합니다.

pContext
[in, out] 창의 만들기 컨텍스트를 지정합니다.

Return Value

TRUE도킹 가능한 창이 성공적으로 만들어지면 이고, 그렇지 않으면 . FALSE

설명

Windows 창을 만들어 개체에 CDockablePane 연결합니다.

창 스타일에 dwStyle 플래그가 있는 CBRS_FLOAT_MULTI 경우 미니프레임 창은 미니프레임 창의 다른 창과 함께 부동할 수 있습니다. 기본적으로 도킹 창은 개별적으로만 부동할 수 있습니다.

매개 변수에 dwTabbedStyle 플래그가 AFX_CBRS_OUTLOOK_TABS 지정된 경우 다른 창이 메서드를 사용하여 CDockablePane::AttachToTabWnd 이 창에 연결되면 창에서 Outlook 스타일 탭 창을 만듭니다. 기본적으로 도킹 가능한 창은 형식 CTabbedPane의 일반 탭 창을 만듭니다.

CDockablePane::CreateTabbedPane

현재 창에서 탭 창을 만듭니다.

virtual CTabbedPane* CreateTabbedPane();

Return Value

새 탭 창 또는 NULL 만들기 작업이 실패한 경우

설명

프레임워크는 이 창을 바꾸기 위해 탭 창을 만들 때 이 메서드를 호출합니다. 자세한 내용은 CDockablePane::AttachToTabWnd를 참조하세요.

탭 창을 만들고 초기화하는 방법을 사용자 지정하려면 파생 클래스에서 이 메서드를 재정의합니다.

탭 창은 메서드에 의해 초기화되는 멤버에 m_pTabbedControlBarRTC 저장된 런타임 클래스 정보에 따라 CDockablePane::CreateEx 만들어집니다.

CDockablePane::DockPaneContainer

컨테이너를 창에 도킹합니다.

virtual BOOL DockPaneContainer(
    CPaneContainerManager& barContainerManager,
    DWORD dwAlignment,
    AFX_DOCK_METHOD dockMethod);

매개 변수

barContainerManager
[in] 도킹 중인 컨테이너의 컨테이너 관리자에 대한 참조입니다.

dwAlignment
[in] DWORD 컨테이너가 도킹되는 창의 측면을 지정하는 입니다.

dockMethod
[in] 사용되지 않습니다.

Return Value

TRUE컨테이너가 창에 성공적으로 도킹되었으면 이고, 그렇지 않으면 . FALSE

설명

dwAlignment 은 다음 값 중 어느 것이든 될 수 있습니다.

설명
CBRS_ALIGN_TOP 컨테이너가 창의 맨 위에 도킹되고 있습니다.
CBRS_ALIGN_BOTTOM 컨테이너가 창 아래쪽에 도킹되고 있습니다.
CBRS_ALIGN_LEFT 컨테이너가 창의 왼쪽에 도킹되고 있습니다.
CBRS_ALIGN_RIGHT 컨테이너가 창의 오른쪽에 도킹되고 있습니다.

CDockablePane::DockPaneStandard

개요(표준) 도킹을 사용하여 창을 도킹합니다.

virtual CPane* DockPaneStandard(BOOL& bWasDocked);

매개 변수

bWasDocked
[in] 메서드가 반환될 때 이 값은 창이 성공적으로 도킹되었는지를 포함하고 TRUE , 그렇지 않으면 포함됩니다 FALSE.

Return Value

창이 탭 창에 도킹되었거나 도킹의 결과로 탭 창이 만들어진 경우 이 메서드는 탭 창에 대한 포인터를 반환합니다. 창이 성공적으로 도킹된 경우 이 메서드는 포인터를 반환합니다 this . 도킹에 실패하면 이 메서드는 .를 반환합니다 NULL.

CDockablePane::DockToRecentPos

창을 저장된 도킹 위치에 도킹합니다.

BOOL CDockablePane::DockToRecentPos();

Return Value

TRUE창이 성공적으로 도킹되면 이고, 그렇지 않으면 . FALSE

설명

도킹 가능한 창은 개체에 CRecentDockSiteInfo 최근 도킹 정보를 저장합니다.

CDockablePane::DockToWindow

한 도킹 창을 다른 도킹 창에 도킹합니다.

virtual BOOL DockToWindow(
    CDockablePane* pTargetWindow,
    DWORD dwAlignment,
    LPCRECT lpRect = NULL);

매개 변수

pTargetWindow
[in, out] 이 창을 도킹할 도킹 가능한 창을 지정합니다.

dwAlignment
[in] 창의 도킹 맞춤을 지정합니다. , , CBRS_ALIGN_BOTTOM CBRS_ALIGN_TOPCBRS_ALIGN_RIGHT또는 CBRS_ALIGN_ANY. 중 CBRS_ALIGN_LEFT하나일 수 있습니다. (.에 afxres.h정의됨)

lpRect
[in] 창의 도킹 사각형을 지정합니다.

Return Value

TRUE창이 성공적으로 도킹되었으면 이고, 그렇지 않으면 . FALSE

설명

이 메서드를 호출하여 지정한 맞춤 dwAlignment으로 한 창을 다른 창에 도킹합니다.

CDockablePane::DrawCaption

도킹 창의 캡션(그리기라고도 함)을 그립니다.

virtual void DrawCaption(
    CDC* pDC,
    CRect rectCaption);

매개 변수

pDC
[in] 그리기에 사용되는 디바이스 컨텍스트를 나타냅니다.

rectCaption
[in] 창 캡션의 경계 사각형을 지정합니다.

설명

프레임워크는 이 메서드를 호출하여 도킹 가능한 창의 캡션을 그립니다.

파생 클래스에서 이 메서드를 재정의하여 캡션의 모양을 사용자 지정합니다.

CDockablePane::EnableAutohideAll

이 창 및 컨테이너의 다른 창에 대해 자동 숨기기 모드를 사용하거나 사용하지 않도록 설정합니다.

void EnableAutohideAll(BOOL bEnable = TRUE);

매개 변수

bEnable
[in] TRUE 도킹 가능한 창에 대한 모든 기능 자동 숨기기를 사용하도록 설정하려면 그렇지 않으면 . FALSE

설명

사용자가 Ctrl 키를 누른 상태에서 고정 단추를 클릭하여 창을 자동 숨기기 모드로 전환하면 동일한 컨테이너의 다른 모든 창도 자동 숨기기 모드로 전환됩니다.

특정 창에 대해 이 기능을 사용하지 않도록 설정하려면 FALSE 이 메서드 bEnable 를 설정하여 호출합니다.

CDockablePane::EnableGripper

캡션(그리퍼라고도 함)을 표시하거나 숨깁니다.

virtual void EnableGripper(BOOL bEnable);

매개 변수

bEnable
[in] TRUE 캡션을 사용하도록 설정하려면 다음을 실행합니다. 그렇지 않으면 . FALSE

설명

프레임워크에서 도킹 가능한 창을 만들 때 지정한 경우에도 창 스타일이 WS_STYLE 없습니다. 즉, 창의 캡션은 프레임워크에서 제어하는 비 클라이언트 영역이지만 이 영역은 표준 창 캡션과 다릅니다.

언제든지 캡션을 표시하거나 숨길 수 있습니다. 창이 탭 창에 탭으로 추가되거나 창이 미니프레임 창에 부동될 때 프레임워크는 캡션을 숨깁니다.

CDockablePane::GetAHRestoredRect

자동 숨기기 모드에서 창의 위치를 지정합니다.

CRect GetAHRestoredRect() const;

Return Value

CRect 자동 숨기기 모드에 있을 때 창의 위치를 포함하는 개체입니다.

설명

CDockablePane::GetAHSlideMode

창의 슬라이드 자동 숨기기 모드를 검색합니다.

virtual UINT GetAHSlideMode() const;

Return Value

UINT 창의 슬라이드 자동 숨기기 모드를 지정하는 A입니다. 반환 값은 둘 중 하나 AFX_AHSM_MOVEAFX_AHSM_STRETCH수 있지만 구현에서만 사용합니다 AFX_AHSM_MOVE.

설명

CDockablePane::GetCaptionHeight

현재 캡션의 높이를 픽셀 단위로 반환합니다.

virtual int GetCaptionHeight() const;

Return Value

캡션의 높이(픽셀)입니다.

설명

메서드에서 캡션을 숨기거나 창에 CDockablePane::EnableGripper 캡션이 없는 경우 캡션 높이는 0입니다.

CDockablePane::GetDefaultPaneDivider

창 컨테이너의 기본 창 나누기를 반환합니다.

CPaneDivider* GetDefaultPaneDivider() const;

Return Value

도킹 가능한 창이 주 프레임 창에 도킹되거나 도킹 가능한 창 NULL 이 도킹되지 않았거나 부동 개체인 경우 유효한 CPaneDivider 개체입니다.

설명

창 구분선에 대한 자세한 내용은 클래스를 참조 CPaneDivider 하세요.

CDockablePane::GetDockingStatus

제공된 포인터 위치에 따라 창이 도킹되는 기능을 결정합니다.

virtual AFX_CS_STATUS GetDockingStatus(
    CPoint pt,
    int nSensitivity);

매개 변수

pt
[in] 화면 좌표에 있는 포인터의 위치입니다.

nSensitivity
[in] 도킹을 사용하도록 설정하려면 포인터가 사각형 가장자리에서 픽셀 단위로 떨어져 있어야 합니다.

Return Value

다음 상태 값 중 하나입니다.

AFX_CS_STATUS 의미
CS_NOTHING 포인터가 도크 사이트에 있지 않습니다. 프레임워크는 창을 고정하지 않습니다.
CS_DOCK_IMMEDIATELY 포인터는 즉시 모드로 도킹 사이트 위에 있습니다(창은 도킹 모드를 DT_IMMEDIATE 사용함). 프레임워크는 창을 즉시 도킹합니다.
CS_DELAY_DOCK 포인터는 다른 도킹 창이거나 주 프레임의 가장자리인 도킹 사이트 위에 있습니다. 프레임워크는 지연 후 창을 도킹합니다. 이 지연에 대한 자세한 내용은 설명 섹션을 참조하세요.
CS_DELAY_DOCK_TO_TAB 포인터는 창이 탭 창에 도킹되도록 하는 도크 사이트 위에 있습니다. 이는 포인터가 다른 도킹 창의 캡션 위에 있거나 탭 창의 탭 영역 위에 있을 때 발생합니다.

설명

프레임워크는 이 메서드를 호출하여 부동 창의 도킹을 처리합니다.

도킹 모드를 사용하는 DT_IMMEDIATE 부동 도구 모음 또는 도킹 창의 경우 도킹이 발생하기 전에 사용자가 부모 프레임의 클라이언트 영역에서 창을 이동할 수 있도록 도킹 명령을 지연합니다. 지연의 길이는 밀리초 단위로 측정되며 데이터 멤버에 CDockingManager::m_nTimeOutBeforeToolBarDock 의해 제어됩니다. CDockingManager::m_nTimeOutBeforeToolBarDock의 기본값은 200입니다. 이 동작은 Microsoft Word 2007의 도킹 동작을 에뮬레이트합니다.

지연된 도킹 상태(CS_DELAY_DOCKCS_DELAY_DOCK_TO_TAB)의 경우 사용자가 마우스 단추를 놓을 때까지 프레임워크에서 도킹을 수행하지 않습니다. 창에서 도킹 모드를 DT_STANDARD 사용하는 경우 프레임워크는 프로젝팅된 도킹 위치에 사각형을 표시합니다. 창에서 도킹 모드를 DT_SMART 사용하는 경우 프레임워크는 프로젝팅된 도킹 위치에 스마트 도킹 표식과 반투명 사각형을 표시합니다. 창에 대한 도킹 모드를 지정하려면 메서드를 호출합니다 CBasePane::SetDockingMode . 스마트 도킹에 대한 자세한 내용은 다음을 참조하세요 CDockingManager::GetSmartDockingParams.

CDockablePane::GetDragSensitivity

도킹 창의 끌기 민감도를 반환합니다.

static const CSize& GetDragSensitivity();

Return Value

CSize 끌기 지점을 중심으로 사각형의 너비와 높이를 픽셀 단위로 포함하는 개체입니다. 마우스 포인터가 이 사각형 밖으로 이동할 때까지 끌기 작업이 시작되지 않습니다.

CDockablePane::GetLastPercentInPaneContainer

창이 컨테이너( CPaneContainer 클래스)에서 차지하는 공간의 백분율을 검색합니다.

int GetLastPercentInPaneContainer() const;

Return Value

int 창이 컨테이너에 차지하는 공간의 백분율을 지정하는 값입니다.

설명

이 메서드는 컨테이너가 레이아웃을 조정할 때 사용됩니다.

CDockablePane::GetTabArea

창의 탭 영역을 검색합니다.

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

매개 변수

rectTabAreaTop
[in] GetTabArea 탭이 창의 맨 위에 있는 경우 이 변수를 탭 영역으로 채웁니다. 탭이 창 아래쪽에 있는 경우 이 변수는 빈 사각형으로 채워집니다.

rectTabAreaBottom
[in] GetTabArea 탭이 창 아래쪽에 있는 경우 이 변수를 탭 영역으로 채웁니다. 탭이 창 맨 위에 있는 경우 이 변수는 빈 사각형으로 채워집니다.

설명

이 메서드는 파생되고 탭이 있는 클래스에서 CDockablePane 만 사용됩니다. 자세한 내용은 CTabbedPane::GetTabAreaCMFCOutlookBar::GetTabArea를 참조하세요.

CDockablePane::GetTabbedPaneRTC

다른 창이 현재 창에 도킹될 때 만들어지는 탭 창에 대한 런타임 클래스 정보를 반환합니다.

CRuntimeClass* GetTabbedPaneRTC() const;

Return Value

도킹 가능한 창에 대한 런타임 클래스 정보입니다.

설명

동적으로 만들어진 탭 창에 대한 런타임 클래스 정보를 검색하려면 이 메서드를 호출합니다. 이는 사용자가 한 창을 다른 창의 캡션으로 끌거나 메서드를 호출 CDockablePane::AttachToTabWnd 하여 두 개의 도킹 가능한 창에서 탭 창을 프로그래밍 방식으로 만드는 경우에 발생할 수 있습니다.

메서드를 호출 CDockablePane::SetTabbedPaneRTC 하여 런타임 클래스 정보를 설정할 수 있습니다.

CDockablePane::HasAutoHideMode

도킹 창을 자동 숨기기 모드로 전환할 수 있는지 여부를 지정합니다.

virtual BOOL HasAutoHideMode() const;

Return Value

TRUE도킹 가능한 창을 자동 숨기기 모드로 전환할 수 있으면 이고, 그렇지 않으면 . FALSE

설명

파생 클래스에서 이 메서드를 재정의하여 특정 도킹 가능한 창에 자동 숨기기 모드를 사용하지 않도록 설정합니다.

CDockablePane::HitTest

사용자가 마우스를 클릭할 창의 위치를 지정합니다.

virtual int HitTest(
    CPoint point,
    BOOL bDetectCaption = FALSE);

매개 변수

point
[in] 테스트할 지점을 지정합니다.

bDetectCaption
[in] TRUE 창의 캡션에 점이 있으면 반환되어야 하면 HTCAPTION />이고, FALSE그렇지 않으면 .

Return Value

다음의 값 중 하나입니다.

  • HTNOWHERE 도킹 가능한 창에 없으면 point 입니다.

  • HTCLIENT 도킹 가능한 창의 클라이언트 영역에 있으면 point />입니다.

  • HTCAPTION 도킹 가능한 창의 캡션 영역에 있으면 point />입니다.

  • AFX_HTCLOSE 가 닫기 단추에 있으면 point 입니다.

  • HTMAXBUTTON 고정 단추에 있으면 point />입니다.

CDockablePane::IsAutohideAllEnabled

컨테이너의 도킹 창과 다른 모든 창을 자동 숨기기 모드로 전환할 수 있는지 여부를 나타냅니다.

virtual BOOL IsAutohideAllEnabled() const;

Return Value

TRUE도킹 가능한 창과 컨테이너의 다른 모든 창을 자동 숨기기 모드로 전환할 수 있으면 이고, 그렇지 않으면 . FALSE

설명

사용자가 Ctrl 키를 누른 상태에서 도킹 핀 단추를 클릭하여 자동 숨기기 모드를 사용하도록 설정합니다.

이 동작을 사용하거나 사용하지 않도록 설정하려면 메서드를 호출합니다 CDockablePane::EnableAutohideAll .

CDockablePane::IsAutoHideMode

창이 자동 숨기기 모드인지 여부를 확인합니다.

virtual BOOL IsAutoHideMode() const;

Return Value

TRUE도킹 가능한 창이 자동 숨기기 모드이면 이고, 그렇지 않으면 . FALSE

CDockablePane::IsDocked

현재 창이 도킹되었는지 여부를 확인합니다.

virtual BOOL IsDocked() const;

Return Value

TRUE 도킹 가능한 창이 미니프레임 창에 속하지 않거나 다른 창이 있는 미니프레임 창에 부동하는 경우 FALSE 창이 미니프레임 창의 자식이고 미니프레임 창에 속하는 다른 창이 없으면 입니다.

설명

창이 주 프레임 창에 도킹되는지 여부를 확인하려면 .를 호출합니다 CDockablePane::GetDefaultPaneDivider. 메서드가 비NULL 포인터를 반환하면 창이 주 프레임 창에 도킹됩니다.

CDockablePane::IsHideInAutoHideMode

호출 CDockablePane::ShowPane하여 표시되거나 숨겨진 경우 자동 숨기기 모드에 있는 창의 동작을 결정합니다.

virtual BOOL IsHideInAutoHideMode() const;

Return Value

TRUE자동 숨기기 모드에서 도킹 가능한 창을 숨겨야 하면 이고, 그렇지 않으면 . FALSE

설명

도킹 가능한 창이 자동 숨기기 모드인 경우 창을 숨기거나 표시하도록 호출 ShowPane 할 때 다르게 동작합니다. 이 동작은 정적 멤버 CDockablePane::m_bHideInAutoHideMode에 의해 제어됩니다. 이 멤버인 TRUE경우 도킹 가능한 창과 관련 자동 숨기기 도구 모음 또는 자동 숨기기 단추가 숨겨지거나 호출 ShowPane할 때 표시됩니다. 그렇지 않으면 도킹 가능한 창이 활성화되거나 비활성화되고 관련 자동 숨기기 도구 모음 또는 자동 숨기기 단추가 항상 표시됩니다.

개별 창의 기본 동작을 변경하려면 파생 클래스에서 이 메서드를 재정의합니다.

m_bHideInAutoHideMode 의 기본값은 FALSE입니다.

CDockablePane::IsInFloatingMultiPaneFrameWnd

창이 다중 창 프레임 창( CMultiPaneFrameWnd Class)에 있는지 여부를 지정합니다.

virtual BOOL IsInFloatingMultiPaneFrameWnd() const;

Return Value

TRUE창이 다중 창 프레임 창에 있으면 이고, 그렇지 않으면 . FALSE

설명

CDockablePane::IsResizable

창의 크기 조정 가능 여부를 지정합니다.

virtual BOOL IsResizable() const;

Return Value

TRUE창의 크기가 조정 가능한 경우 그렇지 않으면 . FALSE

설명

기본적으로 도킹 가능한 창의 크기는 조정 가능합니다. 크기 조정을 방지하려면 파생 클래스에서 이 메서드를 재정의하고 반환 FALSE합니다. 값은 FALSE 실패 ASSERT CPane::DockPane로 이어집니다. 대신 부모 프레임 내에 창을 도킹하는 데 사용합니다 CDockingManager::AddPane .

크기를 조정할 수 없는 창은 부동 모드로 전환하거나 자동 숨기기 모드로 전환할 수 없으며 항상 부모 프레임의 바깥 쪽 가장자리에 있습니다.

CDockablePane::IsTabLocationBottom

탭이 창의 위쪽 또는 아래쪽에 있는지 여부를 지정합니다.

virtual BOOL IsTabLocationBottom() const;

Return Value

TRUE 탭이 창 아래쪽에 있으면 이고, FALSE 탭이 창의 맨 위에 있으면 입니다.

설명

자세한 내용은 CTabbedPane::IsTabLocationBottom를 참조하세요.

CDockablePane::IsTracked

사용자가 창을 이동할지 여부를 지정합니다.

BOOL IsTracked() const;

Return Value

TRUE창이 이동 중이면 그렇지 않으면 . FALSE

CDockablePane::IsVisible

현재 창이 표시되는지 여부를 확인합니다.

virtual BOOL IsVisible() const;

Return Value

TRUE도킹 가능한 창이 표시되면 이고, 그렇지 않으면 . FALSE

설명

이 메서드를 호출하여 도킹 가능한 창이 표시되는지 여부를 확인합니다. 스타일을 호출 CWnd::IsWindowVisible 하거나 테스트하는 대신 이 메서드를 WS_VISIBLE 사용할 수 있습니다. 반환된 표시 유형 상태는 자동 숨기기 모드를 사용할지 또는 사용하지 않도록 설정했는지 여부와 속성 값 CDockablePane::IsHideInAutoHideMode 에 따라 달라집니다.

도킹 가능한 창이 자동 숨기기 모드 IsHideInAutoHideMode 이고 표시 유형 상태가 항상 FALSE반환 FALSE 되는 경우 .

도킹 가능한 창이 자동 숨기기 모드 IsHideInAutoHideMode 이고 표시 상태를 반환 TRUE 하는 경우 관련 자동 숨기기 도구 모음의 표시 유형 상태에 따라 달라집니다.

도킹 가능한 창이 자동 숨기기 모드가 아닌 경우 표시 유형 상태는 메서드에 CBasePane::IsVisible 의해 결정됩니다.

## CDockablePane::LoadState

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

virtual BOOL LoadState(
   LPCTSTR lpszProfileName = NULL,
   int nIndex = -1,
   UINT uiID = (UINT) -1
);

CDockablePane::m_bDisableAnimation

도킹 가능한 창의 자동 숨기기 애니메이션을 사용하지 않도록 설정할지 여부를 지정합니다.

AFX_IMPORT_DATA static BOOL m_bDisableAnimation;

CDockablePane::m_bHideInAutoHideMode

창이 자동 숨기기 모드일 때 창의 동작을 결정합니다.

AFX_IMPORT_DATA static BOOL m_bHideInAutoHideMode;

설명

이 값은 애플리케이션의 모든 도킹 창에 영향을 줍니다.

이 멤버를 TRUE설정하면 도킹 가능한 창이 숨겨지거나 호출 CDockablePane::ShowPane할 때 관련 자동 숨기기 도구 모음 및 단추와 함께 표시됩니다.

이 멤버를 FALSE설정하면 호출 CDockablePane::ShowPane할 때 도킹 가능한 창이 활성화되거나 비활성화됩니다.

CDockablePane::m_nSlideSteps

자동 숨기기 모드인 경우 창의 애니메이션 속도를 지정합니다.

AFX_IMPORT_DATA static int m_nSlideSteps;

설명

더 빠른 애니메이션 효과를 얻으려면 이 값을 줄입니다. 애니메이션 효과가 느리려면 이 값을 늘립니다.

CDockablePane::OnAfterChangeParent

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

virtual void OnAfterChangeParent(CWnd* pWndOldParent);

매개 변수

[in] pWndOldParent\

설명

CDockablePane::OnAfterDockFromMiniFrame

부동 도킹 막대가 프레임 창에 도킹되면 프레임워크에서 호출됩니다.

virtual void OnAfterDockFromMiniFrame();

설명

기본적으로 이 메서드는 아무것도 수행하지 않습니다.

CDockablePane::OnBeforeChangeParent

프레임워크는 창의 부모를 변경하기 전에 이 메서드를 호출합니다.

virtual void OnBeforeChangeParent(
    CWnd* pWndNewParent,
    BOOL bDelay = FALSE);

매개 변수

pWndNewParent
[in] 새 부모 창에 대한 포인터입니다.

bDelay
[in] 창이 도킹 해제된 경우 도킹 레이아웃의 다시 계산을 연기할지 여부를 지정하는 BOOL입니다. 자세한 내용은 CDockablePane::UndockPane를 참조하세요.

설명

창이 도킹되고 새 부모가 도킹을 허용하지 않는 경우 이 메서드는 창을 도킹 해제합니다.

창이 탭 문서로 변환되는 경우 이 메서드는 최근 도킹 위치를 저장합니다. 프레임워크는 최근 도킹 위치를 사용하여 도킹된 상태로 다시 변환될 때 창의 위치를 복원합니다.

CDockablePane::OnBeforeFloat

프레임워크는 창이 부동 상태로 전환되기 전에 이 메서드를 호출합니다.

virtual BOOL OnBeforeFloat(
    CRect& rectFloat,
    AFX_DOCK_METHOD dockMethod);

매개 변수

rectFloat
[in] 창이 부동 상태일 때 창의 위치와 크기를 지정합니다.

dockMethod
[in] 도킹 메서드를 지정합니다. 가능한 값 목록은 참조 CPane::DockPane 하세요.

Return Value

TRUE창을 부동할 수 있으면 이고, 그렇지 않으면 . FALSE

설명

이 메서드는 창이 부동하려고 할 때 프레임워크에서 호출됩니다. 창이 부동하기 전에 처리를 수행하려는 경우 파생 클래스에서 이 메서드를 재정의할 수 있습니다.

CDockablePane::OnPressButtons

사용자가 및 AFX_HTMAXBUTTON 단추 이외의 AFX_HTCLOSE 캡션 단추를 누를 때 호출됩니다.

virtual void OnPressButtons(UINT nHit);

매개 변수

nHit
[in] 이 매개 변수는 사용되지 않습니다.

설명

도킹 가능한 창의 캡션에 사용자 지정 단추를 추가하는 경우 사용자가 단추를 누를 때 알림을 받도록 이 메서드를 재정의합니다.

CDockablePane::OnSlide

자동 숨기기 모드에 있을 때 창에 애니메이션 효과를 주도록 프레임워크에서 호출됩니다.

virtual void OnSlide(BOOL bSlideOut);

매개 변수

bSlideOut
[in] TRUE 창을 표시하려면 다음을 실행합니다. FALSE 창을 숨깁니다.

설명

파생 클래스에서 이 메서드를 재정의하여 사용자 지정 자동 숨기기 효과를 구현합니다.

CDockablePane::RemoveFromDefaultPaneDividier

프레임워크는 창이 도킹 취소될 때 이 메서드를 호출합니다.

void RemoveFromDefaultPaneDividier();

설명

이 메서드는 기본 창 나누기를 설정 하 NULL 고 해당 컨테이너에서 창을 제거 합니다.

CDockablePane::ReplacePane

창을 지정된 창으로 바꿉니다.

BOOL ReplacePane(
    CDockablePane* pBarToReplaceWith,
    AFX_DOCK_METHOD dockMethod,
    BOOL bRegisterWithFrame = FALSE);

매개 변수

pBarToReplaceWith
[in] 도킹 가능한 창에 대한 포인터입니다.

dockMethod
[in] 사용되지 않습니다.

bRegisterWithFrame
[in] 이 경우 TRUE새 창이 이전 창의 부모 도킹 관리자에 등록됩니다. 새 창은 도킹 관리자가 유지 관리하는 창 목록의 이전 창 인덱스에 삽입됩니다.

Return Value

TRUE교체에 성공하면 FALSE

CDockablePane::RestoreDefaultPaneDivider

창이 역직렬화되면 프레임워크는 이 메서드를 호출하여 기본 창 구분자를 복원합니다.

void RestoreDefaultPaneDivider();

설명

복원된 기본 창 나누기가 있는 경우 현재 기본 창 나누기를 바꿉니다.

CDockablePane::SetAutoHideMode

도킹 창을 표시 모드와 자동 숨기기 모드 간에 전환합니다.

virtual CMFCAutoHideBar* SetAutoHideMode(
    BOOL bMode,
    DWORD dwAlignment,
    CMFCAutoHideBar* pCurrAutoHideBar = NULL,
    BOOL bUseTimer = TRUE);

매개 변수

bMode
[in] TRUE 자동 숨기기 모드를 사용하도록 설정하려면 FALSE 일반 도킹 모드를 사용하도록 설정합니다.

dwAlignment
[in] 만들 자동 숨기기 창의 맞춤을 지정합니다.

pCurrAutoHideBar
[in, out] 현재 자동 숨기기 도구 모음에 대한 포인터입니다. NULL일 수 있습니다.

bUseTimer
[in] 사용자가 창을 자동 숨기기 모드로 전환하거나 창을 즉시 숨길 때 자동 숨기기 효과를 사용할지 여부를 지정합니다.

Return Value

자동 숨기기 모드로 전환한 결과로 만들어진 자동 숨기기 도구 모음 또는 NULL.

설명

프레임워크는 사용자가 고정 단추를 클릭하여 도킹 가능한 창을 자동 숨기기 모드 또는 일반 도킹 모드로 전환할 때 이 메서드를 호출합니다.

프로그래밍 방식으로 자동 숨기기 모드로 도킹 가능한 창을 전환하려면 이 메서드를 호출합니다. 창은 주 프레임 창에 도킹되어야 합니다( CDockablePane::GetDefaultPaneDivider 유효한 포인터 CPaneDivider를 반환해야 합니다).

CDockablePane::SetAutoHideParents

창의 자동 숨기기 단추와 자동 숨기기 도구 모음을 설정합니다.

void SetAutoHideParents(
    CMFCAutoHideBar* pToolBar,
    CMFCAutoHideButton* pBtn);

매개 변수

pToolBar
[in] 자동 숨기기 도구 모음에 대한 포인터입니다.

pBtn
[in] 자동 숨기기 단추에 대한 포인터입니다.

CDockablePane::SetLastPercentInPaneContainer

창이 컨테이너에 차지하는 공간의 백분율을 설정합니다.

void SetLastPercentInPaneContainer(int n);

매개 변수

n
[in] int 창이 컨테이너에 차지하는 공간의 백분율을 지정하는 값입니다.

설명

프레임워크는 레이아웃을 다시 계산할 때 새 값을 사용하도록 창을 조정합니다.

CDockablePane::SetRestoredDefaultPaneDivider

복원된 기본 창 나누기를 설정합니다.

void SetRestoredDefaultPaneDivider(HWND hRestoredSlider);

매개 변수

hRestoredSlider
[in] 창 나누기(슬라이더)에 대한 핸들입니다.

설명

복원된 기본 창 구분선은 창이 역직렬화될 때 가져옵니다. 자세한 내용은 CDockablePane::RestoreDefaultPaneDivider를 참조하세요.

CDockablePane::SetTabbedPaneRTC

두 창이 함께 도킹될 때 만들어지는 탭 창에 대한 런타임 클래스 정보를 설정합니다.

void SetTabbedPaneRTC(CRuntimeClass* pRTC);

매개 변수

pRTC
[in] 탭 창에 대한 런타임 클래스 정보입니다.

설명

동적으로 만들어진 탭 창에 대한 런타임 클래스 정보를 설정하려면 이 메서드를 호출합니다. 이는 사용자가 한 창을 다른 창의 캡션으로 끌거나 메서드를 호출 CDockablePane::AttachToTabWnd 하여 두 개의 도킹 가능한 창에서 탭 창을 프로그래밍 방식으로 만드는 경우에 발생할 수 있습니다.

기본 런타임 클래스는 및 .의 CDockablePane::Create 매개 변수에 dwTabbedStyle 따라 설정됩니다CDockablePane::CreateEx. 새 탭 창을 사용자 지정하려면 다음 클래스 중 하나에서 클래스를 파생합니다.

그런 다음 런타임 클래스 정보에 대한 포인터를 사용하여 이 메서드를 호출합니다.

CDockablePane::ShowPane

창을 표시하거나 숨깁니다.

virtual void ShowPane(
    BOOL bShow,
    BOOL bDelay,
    BOOL bActivate);

매개 변수

bShow
[in] TRUE 창을 표시하려면 다음을 실행합니다. FALSE 창을 숨깁니다.

bDelay
[in] TRUE 도킹 레이아웃 조정을 지연하려면 FALSE 도킹 레이아웃을 즉시 조정합니다.

bActivate
[in] TRUE 표시된 경우 창을 활성화합니다. 그렇지 않으면 . FALSE

설명

도킹 가능한 창을 표시하거나 숨길 때 대신 CWnd::ShowWindow 이 메서드를 호출합니다.

CDockablePane::Slide

자동 숨기기 모드에 있는 창에 애니메이션 효과를 둡니다.

virtual void Slide(
    BOOL bSlideOut,
    BOOL bUseTimer = TRUE);

매개 변수

bSlideOut
[in] TRUE 창을 표시하려면 다음을 실행합니다. FALSE 창을 숨깁니다.

bUseTimer
[in] TRUE 자동 숨기기 효과를 사용하여 창을 표시하거나 숨기려면 입니다. FALSE 창을 즉시 표시하거나 숨깁니다.

설명

프레임워크는 자동 숨기기 모드의 창에 애니메이션 효과를 주도록 이 메서드를 호출합니다.

이 메서드는 CDockablePane::m_nSlideDefaultTimeOut 값을 사용하여 슬라이드 효과의 제한 시간을 결정합니다. 제한 시간의 기본값은 1입니다. 자동 숨기기 알고리즘을 사용자 지정하는 경우 이 멤버를 수정하여 시간 초과를 변경합니다.

CDockablePane::ToggleAutoHide

항상 표시되는 모드와 자동 숨기기 모드 간에 창을 전환합니다.

virtual void ToggleAutoHide();

설명

이 메서드는 호출 CDockablePane::SetAutoHideMode하여 창에 대한 자동 숨기기 모드를 전환합니다.

CDockablePane::UndockPane

주 프레임 창 또는 미니프레임 창 컨테이너에서 창을 도킹 해제합니다.

virtual void UndockPane(BOOL bDelay = FALSE);

매개 변수

bDelay
[in] TRUE 도킹 레이아웃 계산을 지연하려면 FALSE 도킹 레이아웃을 즉시 다시 계산합니다.

설명

이 메서드를 호출하여 주 프레임 창 또는 다중 미니 프레임 창 컨테이너(다른 창이 있는 단일 미니프레임 창에 부동 창)에서 창을 도킹 해제합니다.

에서 수행 CDockingManager하지 않는 외부 작업을 수행하기 전에 창의 도킹을 취소해야 합니다. 예를 들어 한 위치에서 다른 위치로 프로그래밍 방식으로 이동하려면 창을 도킹 해제해야 합니다.

프레임워크는 제거되기 전에 창을 자동으로 도킹 해제합니다.

참고 항목

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