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::EnableDocking
CBasePane::DockPane
하여 창 개체를 설정합니다.
다음 팁은 개체에 CDockablePane
적용됩니다.
탭이 없는 도킹 가능한 두 창을 호출
CDockablePane::AttachToTabWnd
하면 탭 창에 대한 포인터가 매개 변수에ppTabbedControlBar
반환됩니다. 이 매개 변수를 사용하여 탭 창에 탭을 계속 추가할 수 있습니다.만든
CDockablePane::AttachToTabWnd
탭 창의 종류는 매개 변수의 개체pTabControlBarAttachTo
에CDockablePane
의해 결정됩니다. 호출CDockablePane::SetTabbedPaneRTC
하여 만들 탭 창CDockablePane
의 종류를 설정할 수 있습니다. 기본 형식은 처음 만들 때의dwTabbedStyle
CDockablePane::Create
형식에 따라 결정됩니다CDockablePane
. 기본 형식CMFCOutlookBar
이AFX_CBRS_OUTLOOK_TABS
클래스이면dwTabbedStyle
클래스이고, 기본 형식이AFX_CBRS_REGULAR_TABS
면dwTabbedStyle
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());
pParentBar->EnableAutohideAll();
pParentBar->EnableGripper(true);
pParentBar->SetAutoHideMode(true, CBRS_ALIGN_LEFT);
pParentBar->ShowPane(true, false, true);
pParentBar->Slide(true);
머리글: afxDockablePane.h
현재 창을 대상 창에 연결하여 탭 창을 만듭니다.
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] 연결 작업으로 인한 탭 창을 포함합니다.
탭 창이 아닌 경우 현재 창에 대한 포인터입니다. 그렇지 않으면 연결 작업으로 인한 탭 창에 대한 포인터입니다. 반환 값은 NULL
현재 창을 연결할 수 없거나 오류가 발생하는 경우입니다.
이 메서드를 사용하여 하나의 도킹 가능한 창이 다른 창에 연결되면 다음이 발생합니다.
프레임워크는 대상 창
pTabControlBarAttachTo
이 일반 도킹 창인지 또는 파생되었는지CBaseTabbedPane
확인합니다.대상 창이 탭 창인 경우 프레임워크는 현재 창을 탭으로 추가합니다.
대상 창이 일반 도킹 창인 경우 프레임워크는 탭 창을 만듭니다.
프레임워크에서 .를 호출합니다
pTabControlBarAttachTo->CreateTabbedPane
. 새 탭 창의 스타일은 멤버에m_pTabbedControlBarRTC
따라 달라집니다. 기본적으로 이 멤버는 .의CTabbedPane
런타임 클래스로 설정됩니다. 스타일을 매개 변수로 메서드에dwTabbedStyle
CDockablePane::Create
전달AFX_CBRS_OUTLOOK_TABS
하면 런타임 클래스 개체가 런타임 클래스로CMFCOutlookBar
설정됩니다. 언제든지 이 멤버를 변경하여 새 창의 스타일을 변경할 수 있습니다.이 메서드가 탭 창을 만들 때 프레임워크는 포인터를
pTabControlBarAttachTo
새 탭 창에 대한 포인터로 바꿉니다(창이 도킹되거나 다중 미니프레임 창에 부동하는 경우).프레임워크는 탭 창에 창을 첫 번째 탭으로 추가합니다
pTabControlBarAttachTo
. 그런 다음 프레임워크는 현재 창을 두 번째 탭으로 추가합니다.
현재 창이 파생된
CBaseTabbedPane
경우 모든 탭이 이동pTabControlBarAttachTo
되고 현재 창이 제거됩니다. 따라서 현재 창에 대한 포인터가 메서드가 반환될 때 유효하지 않을 수 있으므로 이 메서드를 호출할 때는 주의해야 합니다.
도킹 레이아웃을 빌드할 때 한 창을 다른 창에 연결하는 경우 .로 DM_SHOW
설정합니다dockMethod
.
다른 창을 연결하기 전에 첫 번째 창을 도킹해야 합니다.
창 사각형의 크기를 반환합니다.
virtual CSize CalcFixedLayout(
BOOL bStretch,
BOOL bHorz);
bStretch
[in] 사용되지 않습니다.
bHorz
[in] 사용되지 않습니다.
CSize
창 사각형의 크기를 포함하는 개체입니다.
지정된 미니 프레임을 창에 도킹할 수 있는지 여부를 결정합니다.
virtual BOOL CanAcceptMiniFrame(CPaneFrameWnd* pMiniFrame) const;
pMiniFrame
[in] 개체에 대한 포인터입니다 CPaneFrameWnd
.
TRUE
창에 도킹할 수 있으면 pMiniFrame
이고, FALSE
그렇지 않으면 .입니다.
다른 창을 현재 창에 도킹할 수 있는지 여부를 결정합니다.
virtual BOOL CanAcceptPane(const CBasePane* pBar) const;
pBar
[in] 현재 창에 도킹할 창을 지정합니다.
TRUE
지정된 창을 이 창에 도킹할 수 있으면 이고, 그렇지 않으면 . FALSE
프레임워크는 창이 현재 창에 도킹되기 전에 이 메서드를 호출합니다.
특정 창에 도킹을 사용하거나 사용하지 않도록 설정하려면 파생 클래스에서 이 함수를 재정의합니다.
기본적으로 이 메서드는 부모 중 하나 pBar
또는 해당 부모가 형식CDockablePane
이면 반환 TRUE
됩니다.
창이 자동으로 숨겨질 수 있는지 여부를 결정합니다.
virtual BOOL CanAutoHide() const;
TRUE
창이 자동으로 숨겨질 수 있으면 이고, 그렇지 않으면 . FALSE
CDockablePane::CanAutoHide
는 다음과 같은 경우에 반환 FALSE
됩니다.
창에 부모가 없습니다.
도킹 관리자는 창을 자동으로 숨기는 것을 허용하지 않습니다.
창이 도킹되지 않습니다.
현재 창을 다른 창에 도킹할 수 있는지 여부를 결정합니다.
virtual BOOL CanBeAttached() const;
TRUE
도킹 가능한 창을 다른 창이나 주 프레임 창에 도킹할 수 있으면 이고, 그렇지 않으면 . FALSE
기본적으로 이 메서드는 항상 .TRUE
호출 CBasePane::EnableDocking
하지 않고 도킹을 사용하거나 사용하지 않도록 설정하려면 파생 클래스에서 이 메서드를 재정의합니다.
CDockablePane
개체를 생성하고 초기화합니다.
CDockablePane();
도킹 가능한 창 개체를 생성한 후 호출 CDockablePane::Create
하거나 CDockablePane::CreateEx
만듭니다.
하나 이상의 도킹 가능한 창을 MDI 탭 문서로 변환합니다.
virtual void ConvertToTabbedDocument(BOOL bActiveTabOnly = TRUE);
bActiveTabOnly
[in] 변환할 CTabbedPane
때 활성 탭만 변환하도록 지정 TRUE
합니다. 창의 모든 탭을 변환하려면 지정 FALSE
하십시오.
도킹 창이 숨겨져 있는지 여부를 확인합니다(자동 숨기기 모드라고도 함).
virtual BOOL CheckAutoHideCondition();
TRUE
숨기기 조건이 충족되면 이고, 그렇지 않으면 . FALSE
프레임워크는 타이머를 사용하여 자동 숨기기 도킹 가능 창을 숨길지 여부를 주기적으로 확인합니다. 이 메서드는 창이 활성화되지 않고, 창의 크기가 조정되지 않고, 마우스 포인터가 창 위에 있지 않을 때 반환 TRUE
됩니다.
이전 조건이 모두 충족되면 프레임워크는 창을 숨기도록 호출 CDockablePane::Slide
합니다.
자동 숨기기 도킹 창이 슬라이딩을 중지해야 하는 시기를 결정합니다.
virtual BOOL CheckStopSlideCondition(BOOL bDirection);
bDirection
[in] TRUE
창이 표시되면 FALSE
창이 숨겨져 있으면
TRUE
중지 조건이 충족되면 이고, 그렇지 않으면 . FALSE
도킹 가능한 창이 자동 숨기기 모드로 설정된 경우 프레임워크는 슬라이딩 효과를 사용하여 창을 표시하거나 숨깁니다. 프레임워크는 창이 슬라이딩되는 경우 이 함수를 호출합니다. CheckStopSlideCondition
는 창이 완전히 표시되거나 완전히 숨겨지면 반환 TRUE
됩니다.
파생 클래스에서 이 메서드를 재정의하여 사용자 지정 자동 숨기기 효과를 구현합니다.
도킹 가능한 창의 상태를 복사합니다.
virtual void CopyState(CDockablePane* pOrgBar);
pOrgBar
[in] 도킹 가능한 창에 대한 포인터입니다.
CDockablePane::CopyState
는 다음 메서드를 호출하여 현재 창의 상태를 pOrgBar
복사합니다.
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] 창의 크기를 지정합니다.
TRUE
도킹 가능한 창이 성공적으로 만들어지면 이고, 그렇지 않으면 . FALSE
Windows 창을 만들어 개체에 CDockablePane
연결합니다.
창 스타일에 dwStyle
플래그가 있는 CBRS_FLOAT_MULTI
경우 미니프레임 창은 미니프레임 창의 다른 창과 함께 부동할 수 있습니다. 기본적으로 도킹 창은 개별적으로만 부동할 수 있습니다.
매개 변수에 dwTabbedStyle
플래그가 AFX_CBRS_OUTLOOK_TABS
지정된 경우 다른 창이 메서드를 사용하여 CDockablePane::AttachToTabWnd
이 창에 연결되면 창에서 Outlook 스타일 탭 창을 만듭니다. 기본적으로 도킹 가능한 창은 형식 CTabbedPane
의 일반 탭 창을 만듭니다.
틀 창에 도킹할 때 창의 기본 구분선이 만들어집니다.
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] 사용되지 않습니다.
이 메서드는 새로 만든 구분선에 대한 포인터를 반환하거나 NULL
나누기 만들기가 실패하는 경우 반환합니다.
dwAlignment
은 다음 값 중 어느 것이든 될 수 있습니다.
값 | 설명 |
---|---|
CBRS_ALIGN_TOP |
창이 프레임 창의 클라이언트 영역 맨 위에 도킹되고 있습니다. |
CBRS_ALIGN_BOTTOM |
창이 프레임 창의 클라이언트 영역 아래쪽에 도킹되고 있습니다. |
CBRS_ALIGN_LEFT |
창이 프레임 창의 클라이언트 영역 왼쪽에 도킹되고 있습니다. |
CBRS_ALIGN_RIGHT |
창이 프레임 창의 클라이언트 영역 오른쪽에 도킹되고 있습니다. |
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] 창의 만들기 컨텍스트를 지정합니다.
TRUE
도킹 가능한 창이 성공적으로 만들어지면 이고, 그렇지 않으면 . FALSE
Windows 창을 만들어 개체에 CDockablePane
연결합니다.
창 스타일에 dwStyle
플래그가 있는 CBRS_FLOAT_MULTI
경우 미니프레임 창은 미니프레임 창의 다른 창과 함께 부동할 수 있습니다. 기본적으로 도킹 창은 개별적으로만 부동할 수 있습니다.
매개 변수에 dwTabbedStyle
플래그가 AFX_CBRS_OUTLOOK_TABS
지정된 경우 다른 창이 메서드를 사용하여 CDockablePane::AttachToTabWnd
이 창에 연결되면 창에서 Outlook 스타일 탭 창을 만듭니다. 기본적으로 도킹 가능한 창은 형식 CTabbedPane
의 일반 탭 창을 만듭니다.
현재 창에서 탭 창을 만듭니다.
virtual CTabbedPane* CreateTabbedPane();
새 탭 창 또는 NULL
만들기 작업이 실패한 경우
프레임워크는 이 창을 바꾸기 위해 탭 창을 만들 때 이 메서드를 호출합니다. 자세한 내용은 CDockablePane::AttachToTabWnd
를 참조하세요.
탭 창을 만들고 초기화하는 방법을 사용자 지정하려면 파생 클래스에서 이 메서드를 재정의합니다.
탭 창은 메서드에 의해 초기화되는 멤버에 m_pTabbedControlBarRTC
저장된 런타임 클래스 정보에 따라 CDockablePane::CreateEx
만들어집니다.
컨테이너를 창에 도킹합니다.
virtual BOOL DockPaneContainer(
CPaneContainerManager& barContainerManager,
DWORD dwAlignment,
AFX_DOCK_METHOD dockMethod);
barContainerManager
[in] 도킹 중인 컨테이너의 컨테이너 관리자에 대한 참조입니다.
dwAlignment
[in] DWORD
컨테이너가 도킹되는 창의 측면을 지정하는 입니다.
dockMethod
[in] 사용되지 않습니다.
TRUE
컨테이너가 창에 성공적으로 도킹되었으면 이고, 그렇지 않으면 . FALSE
dwAlignment
은 다음 값 중 어느 것이든 될 수 있습니다.
값 | 설명 |
---|---|
CBRS_ALIGN_TOP |
컨테이너가 창의 맨 위에 도킹되고 있습니다. |
CBRS_ALIGN_BOTTOM |
컨테이너가 창 아래쪽에 도킹되고 있습니다. |
CBRS_ALIGN_LEFT |
컨테이너가 창의 왼쪽에 도킹되고 있습니다. |
CBRS_ALIGN_RIGHT |
컨테이너가 창의 오른쪽에 도킹되고 있습니다. |
개요(표준) 도킹을 사용하여 창을 도킹합니다.
virtual CPane* DockPaneStandard(BOOL& bWasDocked);
bWasDocked
[in] 메서드가 반환될 때 이 값은 창이 성공적으로 도킹되었는지를 포함하고 TRUE
, 그렇지 않으면 포함됩니다 FALSE
.
창이 탭 창에 도킹되었거나 도킹의 결과로 탭 창이 만들어진 경우 이 메서드는 탭 창에 대한 포인터를 반환합니다. 창이 성공적으로 도킹된 경우 이 메서드는 포인터를 반환합니다 this
. 도킹에 실패하면 이 메서드는 .를 반환합니다 NULL
.
창을 저장된 도킹 위치에 도킹합니다.
BOOL CDockablePane::DockToRecentPos();
TRUE
창이 성공적으로 도킹되면 이고, 그렇지 않으면 . FALSE
도킹 가능한 창은 개체에 CRecentDockSiteInfo
최근 도킹 정보를 저장합니다.
한 도킹 창을 다른 도킹 창에 도킹합니다.
virtual BOOL DockToWindow(
CDockablePane* pTargetWindow,
DWORD dwAlignment,
LPCRECT lpRect = NULL);
pTargetWindow
[in, out] 이 창을 도킹할 도킹 가능한 창을 지정합니다.
dwAlignment
[in] 창의 도킹 맞춤을 지정합니다. , , CBRS_ALIGN_BOTTOM
CBRS_ALIGN_TOP
CBRS_ALIGN_RIGHT
또는 CBRS_ALIGN_ANY
. 중 CBRS_ALIGN_LEFT
하나일 수 있습니다. (.에 afxres.h
정의됨)
lpRect
[in] 창의 도킹 사각형을 지정합니다.
TRUE
창이 성공적으로 도킹되었으면 이고, 그렇지 않으면 . FALSE
이 메서드를 호출하여 지정한 맞춤 dwAlignment
으로 한 창을 다른 창에 도킹합니다.
도킹 창의 캡션(그리기라고도 함)을 그립니다.
virtual void DrawCaption(
CDC* pDC,
CRect rectCaption);
pDC
[in] 그리기에 사용되는 디바이스 컨텍스트를 나타냅니다.
rectCaption
[in] 창 캡션의 경계 사각형을 지정합니다.
프레임워크는 이 메서드를 호출하여 도킹 가능한 창의 캡션을 그립니다.
파생 클래스에서 이 메서드를 재정의하여 캡션의 모양을 사용자 지정합니다.
이 창 및 컨테이너의 다른 창에 대해 자동 숨기기 모드를 사용하거나 사용하지 않도록 설정합니다.
void EnableAutohideAll(BOOL bEnable = TRUE);
bEnable
[in] TRUE
도킹 가능한 창에 대한 모든 기능 자동 숨기기를 사용하도록 설정하려면 그렇지 않으면 . FALSE
사용자가 Ctrl 키를 누른 상태에서 고정 단추를 클릭하여 창을 자동 숨기기 모드로 전환하면 동일한 컨테이너의 다른 모든 창도 자동 숨기기 모드로 전환됩니다.
특정 창에 대해 이 기능을 사용하지 않도록 설정하려면 FALSE
이 메서드 bEnable
를 설정하여 호출합니다.
캡션(그리퍼라고도 함)을 표시하거나 숨깁니다.
virtual void EnableGripper(BOOL bEnable);
bEnable
[in] TRUE
캡션을 사용하도록 설정하려면 다음을 실행합니다. 그렇지 않으면 . FALSE
프레임워크에서 도킹 가능한 창을 만들 때 지정한 경우에도 창 스타일이 WS_STYLE
없습니다. 즉, 창의 캡션은 프레임워크에서 제어하는 비 클라이언트 영역이지만 이 영역은 표준 창 캡션과 다릅니다.
언제든지 캡션을 표시하거나 숨길 수 있습니다. 창이 탭 창에 탭으로 추가되거나 창이 미니프레임 창에 부동될 때 프레임워크는 캡션을 숨깁니다.
자동 숨기기 모드에서 창의 위치를 지정합니다.
CRect GetAHRestoredRect() const;
CRect
자동 숨기기 모드에 있을 때 창의 위치를 포함하는 개체입니다.
창의 슬라이드 자동 숨기기 모드를 검색합니다.
virtual UINT GetAHSlideMode() const;
UINT
창의 슬라이드 자동 숨기기 모드를 지정하는 A입니다. 반환 값은 둘 중 하나 AFX_AHSM_MOVE
일 AFX_AHSM_STRETCH
수 있지만 구현에서만 사용합니다 AFX_AHSM_MOVE
.
현재 캡션의 높이를 픽셀 단위로 반환합니다.
virtual int GetCaptionHeight() const;
캡션의 높이(픽셀)입니다.
메서드에서 캡션을 숨기거나 창에 CDockablePane::EnableGripper
캡션이 없는 경우 캡션 높이는 0입니다.
창 컨테이너의 기본 창 나누기를 반환합니다.
CPaneDivider* GetDefaultPaneDivider() const;
도킹 가능한 창이 주 프레임 창에 도킹되거나 도킹 가능한 창 NULL
이 도킹되지 않았거나 부동 개체인 경우 유효한 CPaneDivider
개체입니다.
창 구분선에 대한 자세한 내용은 클래스를 참조 CPaneDivider
하세요.
제공된 포인터 위치에 따라 창이 도킹되는 기능을 결정합니다.
virtual AFX_CS_STATUS GetDockingStatus(
CPoint pt,
int nSensitivity);
pt
[in] 화면 좌표에 있는 포인터의 위치입니다.
nSensitivity
[in] 도킹을 사용하도록 설정하려면 포인터가 사각형 가장자리에서 픽셀 단위로 떨어져 있어야 합니다.
다음 상태 값 중 하나입니다.
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_DOCK
및 CS_DELAY_DOCK_TO_TAB
)의 경우 사용자가 마우스 단추를 놓을 때까지 프레임워크에서 도킹을 수행하지 않습니다. 창에서 도킹 모드를 DT_STANDARD
사용하는 경우 프레임워크는 프로젝팅된 도킹 위치에 사각형을 표시합니다. 창에서 도킹 모드를 DT_SMART
사용하는 경우 프레임워크는 프로젝팅된 도킹 위치에 스마트 도킹 표식과 반투명 사각형을 표시합니다. 창에 대한 도킹 모드를 지정하려면 메서드를 호출합니다 CBasePane::SetDockingMode
. 스마트 도킹에 대한 자세한 내용은 다음을 참조하세요 CDockingManager::GetSmartDockingParams
.
도킹 창의 끌기 민감도를 반환합니다.
static const CSize& GetDragSensitivity();
CSize
끌기 지점을 중심으로 사각형의 너비와 높이를 픽셀 단위로 포함하는 개체입니다. 마우스 포인터가 이 사각형 밖으로 이동할 때까지 끌기 작업이 시작되지 않습니다.
창이 컨테이너( CPaneContainer
클래스)에서 차지하는 공간의 백분율을 검색합니다.
int GetLastPercentInPaneContainer() const;
int
창이 컨테이너에 차지하는 공간의 백분율을 지정하는 값입니다.
이 메서드는 컨테이너가 레이아웃을 조정할 때 사용됩니다.
창의 탭 영역을 검색합니다.
virtual void GetTabArea(
CRect& rectTabAreaTop,
CRect& rectTabAreaBottom) const;
rectTabAreaTop
[in] GetTabArea
탭이 창의 맨 위에 있는 경우 이 변수를 탭 영역으로 채웁니다. 탭이 창 아래쪽에 있는 경우 이 변수는 빈 사각형으로 채워집니다.
rectTabAreaBottom
[in] GetTabArea
탭이 창 아래쪽에 있는 경우 이 변수를 탭 영역으로 채웁니다. 탭이 창 맨 위에 있는 경우 이 변수는 빈 사각형으로 채워집니다.
이 메서드는 파생되고 탭이 있는 클래스에서 CDockablePane
만 사용됩니다. 자세한 내용은 CTabbedPane::GetTabArea
및 CMFCOutlookBar::GetTabArea
를 참조하세요.
다른 창이 현재 창에 도킹될 때 만들어지는 탭 창에 대한 런타임 클래스 정보를 반환합니다.
CRuntimeClass* GetTabbedPaneRTC() const;
도킹 가능한 창에 대한 런타임 클래스 정보입니다.
동적으로 만들어진 탭 창에 대한 런타임 클래스 정보를 검색하려면 이 메서드를 호출합니다. 이는 사용자가 한 창을 다른 창의 캡션으로 끌거나 메서드를 호출 CDockablePane::AttachToTabWnd
하여 두 개의 도킹 가능한 창에서 탭 창을 프로그래밍 방식으로 만드는 경우에 발생할 수 있습니다.
메서드를 호출 CDockablePane::SetTabbedPaneRTC
하여 런타임 클래스 정보를 설정할 수 있습니다.
도킹 창을 자동 숨기기 모드로 전환할 수 있는지 여부를 지정합니다.
virtual BOOL HasAutoHideMode() const;
TRUE
도킹 가능한 창을 자동 숨기기 모드로 전환할 수 있으면 이고, 그렇지 않으면 . FALSE
파생 클래스에서 이 메서드를 재정의하여 특정 도킹 가능한 창에 자동 숨기기 모드를 사용하지 않도록 설정합니다.
사용자가 마우스를 클릭할 창의 위치를 지정합니다.
virtual int HitTest(
CPoint point,
BOOL bDetectCaption = FALSE);
point
[in] 테스트할 지점을 지정합니다.
bDetectCaption
[in] TRUE
창의 캡션에 점이 있으면 반환되어야 하면 FALSE
그렇지 않으면 .
다음의 값 중 하나입니다.
HTNOWHERE
도킹 가능한 창에 없으면point
입니다.HTCLIENT
도킹 가능한 창의 클라이언트 영역에 있으면point
/>입니다.HTCAPTION
도킹 가능한 창의 캡션 영역에 있으면point
/>입니다.AFX_HTCLOSE
가 닫기 단추에 있으면point
입니다.HTMAXBUTTON
고정 단추에 있으면point
/>입니다.
컨테이너의 도킹 창과 다른 모든 창을 자동 숨기기 모드로 전환할 수 있는지 여부를 나타냅니다.
virtual BOOL IsAutohideAllEnabled() const;
TRUE
도킹 가능한 창과 컨테이너의 다른 모든 창을 자동 숨기기 모드로 전환할 수 있으면 이고, 그렇지 않으면 . FALSE
사용자가 Ctrl 키를 누른 상태에서 도킹 핀 단추를 클릭하여 자동 숨기기 모드를 사용하도록 설정합니다.
이 동작을 사용하거나 사용하지 않도록 설정하려면 메서드를 호출합니다 CDockablePane::EnableAutohideAll
.
창이 자동 숨기기 모드인지 여부를 확인합니다.
virtual BOOL IsAutoHideMode() const;
TRUE
도킹 가능한 창이 자동 숨기기 모드이면 이고, 그렇지 않으면 . FALSE
현재 창이 도킹되었는지 여부를 확인합니다.
virtual BOOL IsDocked() const;
TRUE
도킹 가능한 창이 미니프레임 창에 속하지 않거나 다른 창이 있는 미니프레임 창에 부동하는 경우 FALSE
창이 미니프레임 창의 자식이고 미니프레임 창에 속하는 다른 창이 없으면 입니다.
창이 주 프레임 창에 도킹되는지 여부를 확인하려면 .를 호출합니다 CDockablePane::GetDefaultPaneDivider
. 메서드가 비NULL
포인터를 반환하면 창이 주 프레임 창에 도킹됩니다.
호출 CDockablePane::ShowPane
하여 표시되거나 숨겨진 경우 자동 숨기기 모드에 있는 창의 동작을 결정합니다.
virtual BOOL IsHideInAutoHideMode() const;
TRUE
자동 숨기기 모드에서 도킹 가능한 창을 숨겨야 하면 이고, 그렇지 않으면 . FALSE
도킹 가능한 창이 자동 숨기기 모드인 경우 창을 숨기거나 표시하도록 호출 ShowPane
할 때 다르게 동작합니다. 이 동작은 정적 멤버 CDockablePane::m_bHideInAutoHideMode
에 의해 제어됩니다. 이 멤버인 TRUE
경우 도킹 가능한 창과 관련 자동 숨기기 도구 모음 또는 자동 숨기기 단추가 숨겨지거나 호출 ShowPane
할 때 표시됩니다. 그렇지 않으면 도킹 가능한 창이 활성화되거나 비활성화되고 관련 자동 숨기기 도구 모음 또는 자동 숨기기 단추가 항상 표시됩니다.
개별 창의 기본 동작을 변경하려면 파생 클래스에서 이 메서드를 재정의합니다.
m_bHideInAutoHideMode
의 기본값은 FALSE
입니다.
창이 다중 창 프레임 창( CMultiPaneFrameWnd Class
)에 있는지 여부를 지정합니다.
virtual BOOL IsInFloatingMultiPaneFrameWnd() const;
TRUE
창이 다중 창 프레임 창에 있으면 이고, 그렇지 않으면 . FALSE
창의 크기 조정 가능 여부를 지정합니다.
virtual BOOL IsResizable() const;
TRUE
창의 크기가 조정 가능한 경우 그렇지 않으면 . FALSE
기본적으로 도킹 가능한 창의 크기는 조정 가능합니다. 크기 조정을 방지하려면 파생 클래스에서 이 메서드를 재정의하고 반환 FALSE
합니다. 값은 FALSE
실패 ASSERT
CPane::DockPane
로 이어집니다. 대신 부모 프레임 내에 창을 도킹하는 데 사용합니다 CDockingManager::AddPane
.
크기를 조정할 수 없는 창은 부동 모드로 전환하거나 자동 숨기기 모드로 전환할 수 없으며 항상 부모 프레임의 바깥 쪽 가장자리에 있습니다.
탭이 창의 위쪽 또는 아래쪽에 있는지 여부를 지정합니다.
virtual BOOL IsTabLocationBottom() const;
TRUE
탭이 창 아래쪽에 있으면 이고, FALSE
탭이 창의 맨 위에 있으면 입니다.
자세한 내용은 CTabbedPane::IsTabLocationBottom
를 참조하세요.
사용자가 창을 이동할지 여부를 지정합니다.
BOOL IsTracked() const;
TRUE
창이 이동 중이면 그렇지 않으면 . FALSE
현재 창이 표시되는지 여부를 확인합니다.
virtual BOOL IsVisible() const;
TRUE
도킹 가능한 창이 표시되면 이고, 그렇지 않으면 . FALSE
이 메서드를 호출하여 도킹 가능한 창이 표시되는지 여부를 확인합니다. 스타일을 호출 CWnd::IsWindowVisible
하거나 테스트하는 대신 이 메서드를 WS_VISIBLE
사용할 수 있습니다. 반환된 표시 유형 상태는 자동 숨기기 모드를 사용할지 또는 사용하지 않도록 설정했는지 여부와 속성 값 CDockablePane::IsHideInAutoHideMode
에 따라 달라집니다.
도킹 가능한 창이 자동 숨기기 모드 IsHideInAutoHideMode
이고 표시 유형 상태가 항상 FALSE
반환 FALSE
되는 경우 .
도킹 가능한 창이 자동 숨기기 모드 IsHideInAutoHideMode
이고 표시 상태를 반환 TRUE
하는 경우 관련 자동 숨기기 도구 모음의 표시 유형 상태에 따라 달라집니다.
도킹 가능한 창이 자동 숨기기 모드가 아닌 경우 표시 유형 상태는 메서드에 CBasePane::IsVisible
의해 결정됩니다.
내부 전용. 자세한 내용은 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
);
도킹 가능한 창의 자동 숨기기 애니메이션을 사용하지 않도록 설정할지 여부를 지정합니다.
AFX_IMPORT_DATA static BOOL m_bDisableAnimation;
창이 자동 숨기기 모드일 때 창의 동작을 결정합니다.
AFX_IMPORT_DATA static BOOL m_bHideInAutoHideMode;
이 값은 애플리케이션의 모든 도킹 창에 영향을 줍니다.
이 멤버를 TRUE
설정하면 도킹 가능한 창이 숨겨지거나 호출 CDockablePane::ShowPane
할 때 관련 자동 숨기기 도구 모음 및 단추와 함께 표시됩니다.
이 멤버를 FALSE
설정하면 호출 CDockablePane::ShowPane
할 때 도킹 가능한 창이 활성화되거나 비활성화됩니다.
자동 숨기기 모드인 경우 창의 애니메이션 속도를 지정합니다.
AFX_IMPORT_DATA static int m_nSlideSteps;
더 빠른 애니메이션 효과를 얻으려면 이 값을 줄입니다. 애니메이션 효과가 느리려면 이 값을 늘립니다.
자세한 내용은 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
\
부동 도킹 막대가 프레임 창에 도킹되면 프레임워크에서 호출됩니다.
virtual void OnAfterDockFromMiniFrame();
기본적으로 이 메서드는 아무것도 수행하지 않습니다.
프레임워크는 창의 부모를 변경하기 전에 이 메서드를 호출합니다.
virtual void OnBeforeChangeParent(
CWnd* pWndNewParent,
BOOL bDelay = FALSE);
pWndNewParent
[in] 새 부모 창에 대한 포인터입니다.
bDelay
[in] 창이 도킹 해제된 경우 도킹 레이아웃의 다시 계산을 연기할지 여부를 지정하는 BOOL입니다. 자세한 내용은 CDockablePane::UndockPane
를 참조하세요.
창이 도킹되고 새 부모가 도킹을 허용하지 않는 경우 이 메서드는 창을 도킹 해제합니다.
창이 탭 문서로 변환되는 경우 이 메서드는 최근 도킹 위치를 저장합니다. 프레임워크는 최근 도킹 위치를 사용하여 도킹된 상태로 다시 변환될 때 창의 위치를 복원합니다.
프레임워크는 창이 부동 상태로 전환되기 전에 이 메서드를 호출합니다.
virtual BOOL OnBeforeFloat(
CRect& rectFloat,
AFX_DOCK_METHOD dockMethod);
rectFloat
[in] 창이 부동 상태일 때 창의 위치와 크기를 지정합니다.
dockMethod
[in] 도킹 메서드를 지정합니다. 가능한 값 목록은 참조 CPane::DockPane
하세요.
TRUE
창을 부동할 수 있으면 이고, 그렇지 않으면 . FALSE
이 메서드는 창이 부동하려고 할 때 프레임워크에서 호출됩니다. 창이 부동하기 전에 처리를 수행하려는 경우 파생 클래스에서 이 메서드를 재정의할 수 있습니다.
사용자가 및 AFX_HTMAXBUTTON
단추 이외의 AFX_HTCLOSE
캡션 단추를 누를 때 호출됩니다.
virtual void OnPressButtons(UINT nHit);
nHit
[in] 이 매개 변수는 사용되지 않습니다.
도킹 가능한 창의 캡션에 사용자 지정 단추를 추가하는 경우 사용자가 단추를 누를 때 알림을 받도록 이 메서드를 재정의합니다.
자동 숨기기 모드에 있을 때 창에 애니메이션 효과를 주도록 프레임워크에서 호출됩니다.
virtual void OnSlide(BOOL bSlideOut);
bSlideOut
[in] TRUE
창을 표시하려면 다음을 실행합니다. FALSE
창을 숨깁니다.
파생 클래스에서 이 메서드를 재정의하여 사용자 지정 자동 숨기기 효과를 구현합니다.
프레임워크는 창이 도킹 취소될 때 이 메서드를 호출합니다.
void RemoveFromDefaultPaneDividier();
이 메서드는 기본 창 나누기를 설정 하 NULL
고 해당 컨테이너에서 창을 제거 합니다.
창을 지정된 창으로 바꿉니다.
BOOL ReplacePane(
CDockablePane* pBarToReplaceWith,
AFX_DOCK_METHOD dockMethod,
BOOL bRegisterWithFrame = FALSE);
pBarToReplaceWith
[in] 도킹 가능한 창에 대한 포인터입니다.
dockMethod
[in] 사용되지 않습니다.
bRegisterWithFrame
[in] 이 경우 TRUE
새 창이 이전 창의 부모 도킹 관리자에 등록됩니다. 새 창은 도킹 관리자가 유지 관리하는 창 목록의 이전 창 인덱스에 삽입됩니다.
TRUE
교체에 성공하면
창이 역직렬화되면 프레임워크는 이 메서드를 호출하여 기본 창 구분자를 복원합니다.
void RestoreDefaultPaneDivider();
복원된 기본 창 나누기가 있는 경우 현재 기본 창 나누기를 바꿉니다.
도킹 창을 표시 모드와 자동 숨기기 모드 간에 전환합니다.
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] 사용자가 창을 자동 숨기기 모드로 전환하거나 창을 즉시 숨길 때 자동 숨기기 효과를 사용할지 여부를 지정합니다.
자동 숨기기 모드로 전환한 결과로 만들어진 자동 숨기기 도구 모음 또는 NULL
.
프레임워크는 사용자가 고정 단추를 클릭하여 도킹 가능한 창을 자동 숨기기 모드 또는 일반 도킹 모드로 전환할 때 이 메서드를 호출합니다.
프로그래밍 방식으로 자동 숨기기 모드로 도킹 가능한 창을 전환하려면 이 메서드를 호출합니다. 창은 주 프레임 창에 도킹되어야 합니다( CDockablePane::GetDefaultPaneDivider
유효한 포인터 CPaneDivider
를 반환해야 합니다).
창의 자동 숨기기 단추와 자동 숨기기 도구 모음을 설정합니다.
void SetAutoHideParents(
CMFCAutoHideBar* pToolBar,
CMFCAutoHideButton* pBtn);
pToolBar
[in] 자동 숨기기 도구 모음에 대한 포인터입니다.
pBtn
[in] 자동 숨기기 단추에 대한 포인터입니다.
창이 컨테이너에 차지하는 공간의 백분율을 설정합니다.
void SetLastPercentInPaneContainer(int n);
n
[in] int
창이 컨테이너에 차지하는 공간의 백분율을 지정하는 값입니다.
프레임워크는 레이아웃을 다시 계산할 때 새 값을 사용하도록 창을 조정합니다.
복원된 기본 창 나누기를 설정합니다.
void SetRestoredDefaultPaneDivider(HWND hRestoredSlider);
hRestoredSlider
[in] 창 나누기(슬라이더)에 대한 핸들입니다.
복원된 기본 창 구분선은 창이 역직렬화될 때 가져옵니다. 자세한 내용은 CDockablePane::RestoreDefaultPaneDivider
를 참조하세요.
두 창이 함께 도킹될 때 만들어지는 탭 창에 대한 런타임 클래스 정보를 설정합니다.
void SetTabbedPaneRTC(CRuntimeClass* pRTC);
pRTC
[in] 탭 창에 대한 런타임 클래스 정보입니다.
동적으로 만들어진 탭 창에 대한 런타임 클래스 정보를 설정하려면 이 메서드를 호출합니다. 이는 사용자가 한 창을 다른 창의 캡션으로 끌거나 메서드를 호출 CDockablePane::AttachToTabWnd
하여 두 개의 도킹 가능한 창에서 탭 창을 프로그래밍 방식으로 만드는 경우에 발생할 수 있습니다.
기본 런타임 클래스는 및 .의 CDockablePane::Create
매개 변수에 dwTabbedStyle
따라 설정됩니다CDockablePane::CreateEx
. 새 탭 창을 사용자 지정하려면 다음 클래스 중 하나에서 클래스를 파생합니다.
그런 다음 런타임 클래스 정보에 대한 포인터를 사용하여 이 메서드를 호출합니다.
창을 표시하거나 숨깁니다.
virtual void ShowPane(
BOOL bShow,
BOOL bDelay,
BOOL bActivate);
bShow
[in] TRUE
창을 표시하려면 다음을 실행합니다. FALSE
창을 숨깁니다.
bDelay
[in] TRUE
도킹 레이아웃 조정을 지연하려면 FALSE
도킹 레이아웃을 즉시 조정합니다.
bActivate
[in] TRUE
표시된 경우 창을 활성화합니다. 그렇지 않으면 . FALSE
도킹 가능한 창을 표시하거나 숨길 때 대신 CWnd::ShowWindow
이 메서드를 호출합니다.
자동 숨기기 모드에 있는 창에 애니메이션 효과를 둡니다.
virtual void Slide(
BOOL bSlideOut,
BOOL bUseTimer = TRUE);
bSlideOut
[in] TRUE
창을 표시하려면 다음을 실행합니다. FALSE
창을 숨깁니다.
bUseTimer
[in] TRUE
자동 숨기기 효과를 사용하여 창을 표시하거나 숨기려면 입니다. FALSE
창을 즉시 표시하거나 숨깁니다.
프레임워크는 자동 숨기기 모드의 창에 애니메이션 효과를 주도록 이 메서드를 호출합니다.
이 메서드는 CDockablePane::m_nSlideDefaultTimeOut
값을 사용하여 슬라이드 효과의 제한 시간을 결정합니다. 제한 시간의 기본값은 1입니다. 자동 숨기기 알고리즘을 사용자 지정하는 경우 이 멤버를 수정하여 시간 초과를 변경합니다.
항상 표시되는 모드와 자동 숨기기 모드 간에 창을 전환합니다.
virtual void ToggleAutoHide();
이 메서드는 호출 CDockablePane::SetAutoHideMode
하여 창에 대한 자동 숨기기 모드를 전환합니다.
주 프레임 창 또는 미니프레임 창 컨테이너에서 창을 도킹 해제합니다.
virtual void UndockPane(BOOL bDelay = FALSE);
bDelay
[in] TRUE
도킹 레이아웃 계산을 지연하려면 FALSE
도킹 레이아웃을 즉시 다시 계산합니다.
이 메서드를 호출하여 주 프레임 창 또는 다중 미니 프레임 창 컨테이너(다른 창이 있는 단일 미니프레임 창에 부동 창)에서 창을 도킹 해제합니다.
에서 수행 CDockingManager
하지 않는 외부 작업을 수행하기 전에 창의 도킹을 취소해야 합니다. 예를 들어 한 위치에서 다른 위치로 프로그래밍 방식으로 이동하려면 창을 도킹 해제해야 합니다.
프레임워크는 제거되기 전에 창을 자동으로 도킹 해제합니다.