다음을 통해 공유


CBasePane 클래스

MFC의 모든 창에 대한 기본 클래스입니다.

구문

class CBasePane : public CWnd

멤버

공용 생성자

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

공용 메서드

이름 설명
CBasePane::accHitTest 화면의 지정된 지점에서 자식 요소나 자식 개체를 검색하기 위해 프레임워크에서 호출됩니다. (재정의 CWnd::accHitTest.)
CBasePane::accLocation 지정된 개체의 현재 화면 위치를 검색하기 위해 프레임워크에서 호출됩니다. (재정의 CWnd::accLocation.)
CBasePane::AccNotifyObjectFocusEvent CBasePane 이 메서드를 사용하지 않습니다.
CBasePane::accSelect 선택 영역을 수정하거나 지정된 개체의 키보드 포커스를 이동하기 위해 프레임워크에서 호출됩니다. (재정의 CWnd::accSelect.)
CBasePane::AddPane 도킹 관리자에 창을 추가합니다.
CBasePane::AdjustDockingLayout 도킹 관리자에 대한 호출을 리디렉션하여 도킹 레이아웃을 조정합니다.
CBasePane::AdjustLayout 창이 내부 레이아웃을 조정해야 하는 경우 프레임워크에서 호출됩니다.
CBasePane::CalcFixedLayout 컨트롤 막대의 가로 크기를 계산합니다.
CBasePane::CanAcceptPane 다른 창을 창에 도킹할 수 있는지 여부를 결정합니다.
CBasePane::CanAutoHide 창에서 자동 숨기기 모드를 지원하는지 여부를 결정합니다.
CBasePane::CanBeAttached 창을 다른 창에 도킹할 수 있는지 여부를 결정합니다.
CBasePane::CanBeClosed 창을 닫을 수 있는지 여부를 결정합니다.
CBasePane::CanBeDocked 창을 다른 창에 도킹할 수 있는지 여부를 결정합니다.
CBasePane::CanBeResized 창의 크기를 조정할 수 있는지 여부를 결정합니다.
CBasePane::CanBeTabbedDocument 창을 MDI 탭 문서로 변환할 수 있는지 여부를 지정합니다.
CBasePane::CanFloat 창이 부동할 수 있는지 여부를 결정합니다.
CBasePane::CanFocus 창에서 포커스를 받을 수 있는지 여부를 지정합니다.
CBasePane::CopyState 지정된 창의 상태를 복사합니다.
CBasePane::CreateDefaultMiniframe 창이 부동할 수 있는 경우 미니 프레임 창을 만듭니다.
CBasePane::CreateEx 창 컨트롤을 만듭니다.
CBasePane::D ockPane 창을 다른 창이나 프레임 창에 도킹합니다.
CBasePane::D ockPaneUsingRTTI 런타임 형식 정보를 사용하여 창을 도킹합니다.
CBasePane::D ockToFrameWindow 고정 가능한 창을 프레임에 도킹합니다.
CBasePane::D oesAllowDynInsertBefore 이 창과 부모 프레임 사이에 다른 창을 동적으로 삽입할 수 있는지 여부를 결정합니다.
CBasePane::EnableDocking 창을 주 프레임에 도킹할 수 있습니다.
CBasePane::EnableGripper 그리퍼를 사용하거나 사용하지 않도록 설정합니다. 그리퍼를 사용하도록 설정하면 사용자가 끌어 창의 위치를 변경할 수 있습니다.
CBasePane::FillWindowRect 내부적으로 사용됩니다.
CBasePane::FloatPane 창을 부동합니다.
CBasePane::get_accChild 지정된 자식의 IDispatch 인터페이스 주소를 검색하기 위해 프레임워크에서 호출됩니다. (재정의 CWnd::get_accChild.)
CBasePane::get_accChildCount 이 개체에 속하는 자식 수를 검색하기 위해 프레임워크에서 호출됩니다. (재정의 CWnd::get_accChildCount.)
CBasePane::get_accDefaultAction 개체의 기본 동작을 설명하는 문자열을 검색하기 위해 프레임워크에서 호출됩니다. (재정의 CWnd::get_accDefaultAction.)
CBasePane::get_accDescription 지정한 개체의 모양을 설명하는 문자열을 검색하기 위해 프레임워크에서 호출됩니다. (재정의 CWnd::get_accDescription.)
CBasePane::get_accFocus 키보드 포커스가 있는 개체를 검색하기 위해 프레임워크에서 호출됩니다. (재정의 CWnd::get_accFocus.)
CBasePane::get_accHelp 개체에 대한 도움말 속성 문자열을 검색하기 위해 프레임워크에서 호출됩니다. (재정의 CWnd::get_accHelp.)
CBasePane::get_accHelpTopic 지정된 개체와 연결된 WinHelp 파일의 전체 경로와 해당 파일에 있는 해당 항목의 식별자를 검색하기 위해 프레임워크에서 호출됩니다. (재정의 CWnd::get_accHelpTopic.)
CBasePane::get_accKeyboardShortcut 개체에 대해 지정된 바로 가기 키를 검색하기 위해 프레임워크에서 호출됩니다. (재정의 CWnd::get_accKeyboardShortcut.)
CBasePane::get_accName 지정된 개체의 이름을 검색하기 위해 프레임워크에서 호출됩니다. (재정의 CWnd::get_accName.)
CBasePane::get_accParent 개체의 부모에 대한 인터페이스를 IDispatch 검색하기 위해 프레임워크에서 호출됩니다. (재정의 CWnd::get_accParent.)
CBasePane::get_accRole 지정된 개체의 역할을 설명하는 정보를 검색하기 위해 프레임워크에서 호출됩니다. (재정의 CWnd::get_accRole.)
CBasePane::get_accSelection 이 개체의 선택된 자식 개체를 검색하기 위해 프레임워크에서 호출됩니다. (재정의 CWnd::get_accSelection.)
CBasePane::get_accState 지정된 개체의 현재 상태를 검색하기 위해 프레임워크에서 호출됩니다. (재정의 CWnd::get_accState.)
CBasePane::get_accValue 지정된 개체의 값을 검색하기 위해 프레임워크에서 호출됩니다. (재정의 CWnd::get_accValue.)
CBasePane::GetCaptionHeight 캡션 높이를 반환합니다.
CBasePane::GetControlBarStyle 컨트롤 막대 스타일을 반환합니다.
CBasePane::GetCurrentAlignment 현재 창 맞춤을 반환합니다.
CBasePane::GetDockingMode 창의 현재 도킹 모드를 반환합니다.
CBasePane::GetDockSiteFrameWnd 창의 도크 사이트인 창에 대한 포인터를 반환합니다.
CBasePane::GetEnabledAlignment 창에 적용되는 CBRS_ALIGN_ 스타일을 반환합니다.
CBasePane::GetMFCStyle MFC와 관련된 창 스타일을 반환합니다.
CBasePane::GetPaneIcon 창 아이콘에 대한 핸들을 반환합니다.
CBasePane::GetPaneRect 내부적으로 사용됩니다.
CBasePane::GetPaneRow 창이 도킹된 CDockingPanesRow개체에 대한 포인터를 반환합니다.
CBasePane::GetPaneStyle 창 스타일을 반환합니다.
CBasePane::GetParentDockSite 부모 도크 사이트에 대한 포인터를 반환합니다.
CBasePane::GetParentMiniFrame 부모 미니 프레임 창에 대한 포인터를 반환합니다.
CBasePane::GetParentTabbedPane 부모 탭 창에 대한 포인터를 반환합니다.
CBasePane::GetParentTabWnd 탭 내에 있는 부모 창에 대한 포인터를 반환합니다.
CBasePane::GetRecentVisibleState 프레임워크는 보관 파일에서 창을 복원할 때 이 메서드를 호출합니다.
CBasePane::HideInPrintPreviewMode 인쇄 미리 보기에서 창을 숨길지 여부를 지정합니다.
CBasePane::InsertPane 지정한 창을 도킹 관리자에 등록합니다.
CBasePane::IsAccessibilityCompatible 창에서 활성 접근성을 지원하는지 여부를 지정합니다.
CBasePane::IsAutoHideMode 창이 자동 숨기기 모드인지 여부를 확인합니다.
CBasePane::IsDialogControl 창이 대화 상자 컨트롤인지 여부를 지정합니다.
CBasePane::IsDocked 창이 도킹되었는지 여부를 확인합니다.
CBasePane::IsFloating 창이 부동인지 여부를 확인합니다.
CBasePane::IsHorizontal 창이 가로로 도킹되는지 여부를 확인합니다.
CBasePane::IsInFloatingMultiPaneFrameWnd 창이 다중 창 프레임 창에 있는지 여부를 지정합니다.
CBasePane::IsMDITabbed 창이 탭 문서로 MDI 자식 창에 추가되었는지 여부를 확인합니다.
CBasePane::IsPaneVisible 창에 WS_VISIBLE 플래그를 설정할지 여부를 지정합니다.
CBasePane::IsPointNearDockSite 지정된 지점이 Dock 사이트 근처에 있는지 여부를 확인합니다.
CBasePane::IsResizable 창의 크기를 조정할 수 있는지 여부를 결정합니다.
CBasePane::IsRestoredFromRegistry 레지스트리에서 창을 복원할지 여부를 결정합니다.
CBasePane::IsTabbed 창이 탭 창의 탭 컨트롤에 삽입되었는지 여부를 확인합니다.
CBasePane::IsTooltipTopmost 내부적으로 사용됩니다.
CBasePane::IsVisible 창이 표시되는지 여부를 확인합니다.
CBasePane::LoadState 레지스트리에서 창 상태를 로드합니다.
CBasePane::MoveWindow 창을 이동합니다.
CBasePane::OnAfterChangeParent 창의 부모가 변경되었을 때 프레임워크에서 호출됩니다.
CBasePane::OnBeforeChangeParent 창이 부모 창을 변경하기 직전에 프레임워크에서 호출됩니다.
CBasePane::OnDrawCaption 프레임워크는 캡션이 그려질 때 이 메서드를 호출합니다.
CBasePane::OnMovePaneDivider 이 메서드는 현재 사용되지 않습니다.
CBasePane::OnPaneContextMenu 창 목록이 있는 메뉴를 빌드할 때 프레임워크에서 호출됩니다.
CBasePane::OnRemoveFromMiniFrame 부모 미니 프레임 창에서 창을 제거할 때 프레임워크에서 호출됩니다.
CBasePane::OnSetAccData CBasePane 이 메서드를 사용하지 않습니다.
CBasePane::OnUpdateCmdUI 내부적으로 사용됩니다.
CBasePane::P aneFromPoint 지정된 점을 포함하는 창을 반환합니다.
CBasePane::PreTranslateMessage 창 메시지가 TranslateMessageDispatchMessage Windows 함수로 디스패치되기 전에 CWinApp 클래스가 이 메시지를 해석하는 데 사용됩니다. ( CWnd::PreTranslateMessage를 재정의합니다.)
CBasePane::RecalcLayout CBasePane 이 메서드를 사용하지 않습니다.
CBasePane::RemovePaneFromDockManager 창을 등록 취소하고 도킹 관리자의 목록에서 제거합니다.
CBasePane::SaveState 레지스트리에 창의 상태를 저장합니다.
CBasePane::SelectDefaultFont 지정된 디바이스 컨텍스트에 대한 기본 글꼴을 선택합니다.
CBasePane::Serialize 이 개체를 보관 저장소에서 읽어오거나 보관 저장소에 씁니다. ( CObject::Serialize를 재정의합니다.)
CBasePane::SetControlBarStyle 컨트롤 막대 스타일을 설정합니다.
CBasePane::SetDockingMode 창의 도킹 모드를 설정합니다.
CBasePane::SetMDITabbed 내부적으로 사용됩니다.
CBasePane::SetPaneAlignment 창의 맞춤을 설정합니다.
CBasePane::SetPaneRect 내부적으로 사용됩니다.
CBasePane::SetPaneStyle 창의 스타일을 설정합니다.
CBasePane::SetRestoredFromRegistry 내부적으로 사용됩니다.
CBasePane::SetWindowPos 창의 크기, 위치 및 Z 순서를 변경합니다.
CBasePane::ShowPane 창을 표시하거나 숨깁니다.
CBasePane::StretchPane 창을 가로 또는 세로로 확장합니다.
CBasePane::UndockPane 현재 도킹된 도크 사이트, 기본 슬라이더 또는 미니 프레임 창에서 창을 제거합니다.

보호된 메서드

속성 설명
CBasePane::D oPaint 창의 배경을 채웁니다.

설명

MFC에서 사용할 수 있는 확장된 도킹 기능을 지원하는 창 클래스를 만들려면 CPane 클래스에서 또는 CPane 클래스에서 CBasePane 파생해야 합니다.

사용자 지정 팁

다음 사용자 지정 팁은 상속된 CBasePane Class 클래스 및 클래스와 관련이 있습니다.

  • 창을 만들 때 다음과 같은 몇 가지 새 스타일을 적용할 수 있습니다.

    • AFX_CBRS_FLOAT 창을 부동으로 만듭니다.

    • AFX_CBRS_AUTOHIDE 자동 숨기기 모드를 사용하도록 설정합니다.

    • AFX_CBRS_CLOSE 창을 닫을 수 있습니다(숨김).

    비트 OR 연산과 결합할 수 있는 플래그입니다.

CBasePane 에서는 이러한 플래그 를 반영하는 가상 부울 메서드를 구현합니다. CBasePane::CanBeClosed, CBasePane::CanAutoHide, CBasePane::CanFloat. 파생 클래스에서 재정의하여 동작을 사용자 지정할 수 있습니다.

  • CBasePane::CanAcceptPane을 재정의하여 도킹 동작을 사용자 지정할 수 있습니다. 다른 창이 도킹되지 않도록 이 메서드에서 창이 FALSE를 반환하도록 합니다.

  • 부동할 수 없고 다른 창이 앞에 도킹되지 않도록 하는 정적 창을 만들려면(OutlookDemo 예제의 Outlook 표시줄과 유사) 부동이 아닌 창으로 만들고 CBasePane::D oesAllowDynInsertBefore를 재정의 하여 FALSE를 반환합니다. 창이 AFX_CBRS_FLOAT 스타일 없이 만들어지면 기본 구현은 FALSE를 반환합니다.

  • -1 이외의 ID를 사용하여 모든 창을 만듭니다.

  • 창 표시 여부를 확인하려면 CBasePane::IsVisible을 사용합니다. 탭 모드 및 자동 숨기기 모드에서 표시 상태를 올바르게 처리합니다.

  • 부동 크기 조정이 불가능한 창을 만들려면 AFX_CBRS_FLOAT 스타일 없이 만들고 CFrameWnd::D ockControlBar를 호출합니다.

  • 도킹 레이아웃에서 창을 제외하거나 도킹 막대에서 도구 모음을 제거하려면 CBasePane::UndockPane을 호출합니다. 자동 숨기기 모드의 창이나 탭 창 탭에 있는 창에는 이 메서드를 호출하지 마세요.

  • 자동 숨기기 모드에 있는 창을 부동 또는 도킹 해제하려면 CBasePane::FloatPane 또는 CBasePane::UndockPane을 호출하기 전에 FALSE를 사용하여 CDockablePane::SetAutoHideMode를 첫 번째 인수로 호출해야 합니다.

예시

다음 예제에서는 CBasePane 클래스에서 다양한 메서드를 사용하는 방법을 보여 줍니다. 이 예제에서는 클래스에서 CFrameWndEx 창을 검색하는 방법과 도킹 모드, 창 맞춤 및 창 스타일을 설정하는 방법을 보여 줍니다. 코드는 Word Pad 샘플에서 가져옵니다.

// This CMainFrame class extends the CFrameWndEx class.
// GetPane is a method in the CFrameWndEx class which
// Returns a pointer to the pane that has the specified ID.
CBasePane *pBar = GetPane(ID_VIEW_FORMATBAR);
if (pBar != NULL)
{
    // Set the docking mode, the pane alignment, and the pane style.
    pBar->SetDockingMode(DT_STANDARD);
    pBar->SetPaneAlignment(CBRS_ALIGN_LEFT);
    pBar->SetPaneStyle(pBar->GetCurrentAlignment() | CBRS_TOOLTIPS);
    pBar->ShowPane(TRUE, FALSE, FALSE);
}

상속 계층 구조

CObject

CCmdTarget

CWnd

CBasePane

요구 사항

헤더: afxbasepane.h

CBasePane::AccNotifyObjectFocusEvent

CBasePane 이 메서드를 사용하지 않습니다.

virtual void AccNotifyObjectFocusEvent(int);

매개 변수

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

CBasePane::AddPane

도킹 관리자에 창을 추가합니다.

void AddPane(CBasePane* pBar);

매개 변수

pBar
[in] 추가할 창에 대한 포인터입니다.

설명

이는 도킹 관리자에 창을 추가하는 편리한 방법입니다. 이 메서드를 사용하면 부모 프레임의 형식을 분석하는 코드를 작성할 필요가 없습니다.

자세한 내용은 CDockingManager 클래스CMDIFrameWndEx::AddPane을 참조하세요.

CBasePane::AdjustDockingLayout

도킹 관리자에 대한 호출을 리디렉션하여 도킹 레이아웃을 조정합니다.

virtual void AdjustDockingLayout(HDWP hdwp=NULL);

매개 변수

hdwp
[out] 여러 창 위치를 포함하는 구조체에 대한 핸들입니다.

설명

이는 도킹 레이아웃을 조정하는 편리한 방법입니다. 이 메서드를 사용하면 부모 프레임의 형식을 분석하는 코드를 작성할 필요가 없습니다.

자세한 내용은 CDockingManager::AdjustDockingLayout을 참조 하세요.

CBasePane::AdjustLayout

창의 내부 레이아웃을 조정하기 위해 프레임워크에서 호출됩니다.

virtual void AdjustLayout();

설명

프레임워크는 창이 내부 레이아웃을 조정해야 하는 경우 이 메서드를 호출합니다. 기본 구현은 아무 작업도 수행하지 않습니다.

CBasePane::CalcFixedLayout

컨트롤 막대의 가로 크기를 계산합니다.

virtual CSize CalcFixedLayout(
    BOOL bStretch,
    BOOL bHorz);

매개 변수

bStretch
[in] 막대를 프레임 크기로 확장해야 하는지 여부를 나타냅니다. bStretch 매개 변수는 막대가 도킹 막대(도킹에 사용할 수 없음)가 아니고 도킹 또는 부동(도킹에 사용 가능)이면 0이 아닌 경우 0이 아닙니다.

bHorz
[in] 막대가 가로 또는 세로 방향임을 나타냅니다. 가로 방향이면 bHorz 매개 변수가 0이 아니고 세로 방향이면 0입니다.

Return Value

개체의 컨트롤 막대 크기(픽셀)입니다 CSize .

설명

CControlBar::CalcFixedLayout의 설명 섹션을 참조하세요.

CBasePane::CanAcceptPane

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

virtual BOOL CanAcceptPane(const CBasePane* pBar) const;

매개 변수

pBar
[in] 도킹할 창에 대한 포인터입니다.

Return Value

다른 창을 수락할 수 있으면 TRUE입니다. 그렇지 않으면 FALSE입니다.

설명

프레임워크는 pBar로 지정된 창을 현재 창에 도킹하기 전에 이 메서드를 호출합니다.

이 메서드와 CBasePane::CanBeDocked 메서드를 사용하여 창이 애플리케이션의 다른 창에 도킹되는 방식을 제어할 수 있습니다.

기본 구현은 FALSE를 반환합니다.

CBasePane::CanAutoHide

창에서 자동 숨기기 모드를 지원하는지 여부를 결정합니다.

virtual BOOL CanAutoHide() const;

Return Value

이 창에서 자동 숨기기 모드를 지원하는 경우 TRUE입니다. 그렇지 않으면 FALSE입니다.

설명

프레임워크는 이 함수를 호출하여 창이 자동 숨기기 모드를 지원하는지 여부를 확인합니다.

생성하는 동안 CBasePane::CreateEx에 AFX_CBRS_AUTOHIDE 플래그를 전달하여 이 기능을 설정할 수 있습니다.

기본 구현은 AFX_CBRS_AUTOHIDE 플래그를 확인합니다. 파생 클래스에서 이 메서드를 재정의하여 이 동작을 사용자 지정합니다.

CBasePane::CanBeAttached

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

virtual BOOL CanBeAttached() const;

Return Value

창을 다른 창이나 프레임 창에 도킹할 수 있으면 TRUE입니다. 그렇지 않으면 FALSE입니다.

설명

기본 구현은 FALSE를 반환합니다. CBasePane::EnableDocking을 호출 하지 않고 도킹 기능을 사용하거나 사용하지 않도록 설정하려면 파생 클래스에서 이 메서드를 재정의합니다.

CBasePane::CanBeClosed

창을 닫을 수 있는지 여부를 결정합니다.

virtual BOOL CanBeClosed() const;

Return Value

창을 닫을 수 있으면 TRUE입니다. 그렇지 않으면 FALSE입니다.

설명

프레임워크는 이 메서드를 호출하여 창을 닫을 수 있는지 여부를 결정합니다. 메서드가 TRUE 를 반환하면 창의 제목 표시줄에 닫기 단추가 추가되거나 창이 부동하는 경우 창의 미니프레임 창의 제목 표시줄에 추가됩니다.

생성하는 동안 CBasePane::CreateEx에 AFX_CBRS_CLOSE 플래그를 전달하여 이 기능을 설정할 수 있습니다.

기본 구현은 AFX_CBRS_CLOSE 플래그를 확인합니다.

CBasePane::CanBeDocked

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

virtual BOOL CanBeDocked(CBasePane* pDockBar) const;

매개 변수

pDockBar
[in] 다른 창에 대한 포인터입니다.

Return Value

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

설명

프레임워크는 pDockBar로 지정된 창을 현재 창에 도킹하기 전에 이 메서드를 호출합니다.

이 메서드와 CBasePane::CanAcceptPane 메서드를 사용하여 창이 애플리케이션의 다른 창에 도킹되는 방식을 제어합니다.

기본 구현은 FALSE를 반환합니다.

CBasePane::CanBeResized

창의 크기를 조정할 수 있는지 여부를 결정합니다.

virtual BOOL CanBeResized() const;

Return Value

창의 크기를 조정할 수 있으면 TRUE입니다. 그렇지 않으면 FALSE입니다.

설명

이 메서드는 기본적으로 지정되는 AFX_CBRS_RESIZE 플래그를 확인합니다 CBasePane::OnCreate. 이 플래그를 지정하지 않으면 도킹 관리자는 창을 도킹하는 대신 내부적으로 이동 불가능으로 플래그를 지정합니다.

CBasePane::CanBeTabbedDocument

창을 MDI 탭 문서로 변환할 수 있는지 여부를 지정합니다.

virtual BOOL CanBeTabbedDocument() const;

Return Value

창이 탭 문서로 변환될 수 있으면 TRUE입니다. 그렇지 않으면 FALSE입니다. CBasePane::CanBeTabbedDocument 항상 FALSE를 반환합니다.

설명

CDockablePane 클래스와 같은 특정 CBasePane파생 형식의 개체만 탭 문서로 변환할 수 있습니다.

CBasePane::CanFloat

창이 부동할 수 있는지 여부를 결정합니다.

virtual BOOL CanFloat() const;

Return Value

창이 부동할 수 있으면 TRUE입니다. 그렇지 않으면 FALSE입니다.

설명

프레임워크는 이 메서드를 호출하여 창이 부동할 수 있는지 여부를 결정합니다.

생성하는 동안 CBasePane::CreateEx에 AFX_CBRS_FLOAT 플래그를 전달하여 이 기능을 설정할 수 있습니다.

참고 항목

프레임워크는 부동 창이 아닌 창이 정적이며 도킹 상태를 변경할 수 없다고 가정합니다. 따라서 프레임워크는 부동 창이 아닌 창의 도킹 상태를 저장하지 않습니다.

기본 구현은 AFX_CBRS_FLOAT 스타일을 확인합니다.

CBasePane::CanFocus

창에서 포커스를 받을 수 있는지 여부를 지정합니다.

virtual BOOL CanFocus() const;

Return Value

창에서 포커스를 받을 수 있으면 TRUE입니다. 그렇지 않으면 FALSE입니다.

설명

파생 클래스에서 이 메서드를 재정의하여 포커스를 제어합니다. 예를 들어 도구 모음에서 포커스를 받을 수 없으므로 이 메서드는 도구 모음 개체에서 호출될 때 FALSE를 반환합니다.

프레임워크는 창이 도킹되거나 부동될 때 입력 포커스를 설정하려고 합니다.

CBasePane::CopyState

지정된 창의 상태를 복사합니다.

virtual void CopyState(CBasePane* pOrgBar);

매개 변수

pOrgBar
[in] 다른 창에 대한 포인터입니다.

설명

이 메서드는 pOrgBar에서 이 창으로 상태를 복사합니다.

CBasePane::CreateDefaultMiniframe

창이 부동할 수 있는 경우 이 메서드는 미니 프레임 창을 만듭니다.

virtual CPaneFrameWnd* CreateDefaultMiniframe(CRect rectInitial);

매개 변수

rectInitial
[in] 미니 프레임 창의 초기 좌표를 지정합니다.

Return Value

새 미니 프레임 창에 대한 포인터이거나, 생성에 실패한 경우 NULL입니다.

설명

프레임워크는 창이 부동 상태로 전환할 때 이 메서드를 호출합니다. 이 메서드는 미니 프레임 창을 만들고 창을 이 창에 연결합니다.

기본 구현은 NULL을 반환합니다.

CBasePane::CreateEx

창 컨트롤을 만듭니다.

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

매개 변수

dwStyleEx
[in] 확장된 스타일(자세한 내용은 CWnd::CreateEx 참조).

lpszClassName
[in] 창 클래스 이름입니다.

lpszWindowName
[in] 창 이름입니다.

dwStyle
[in] 창 스타일(CWnd::CreateEx 참조 )입니다.

rect
[in] 초기 사각형입니다.

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

nID
[in] 창 ID를 지정합니다. 고유해야 합니다.

dwControlBarStyle
[in] 창의 스타일 플래그입니다.

pContext
[in] 에 대한 포인터 CcreateContext

Return Value

창이 성공적으로 만들어지면 TRUE이고, 그렇지 않으면 FALSE입니다.

설명

클래스 lpszClassName의 창을 만듭니다. WS_CAPTION 지정하면 라이브러리에서 캡션이 있는 창을 지원하지 않으므로 이 메서드는 WS_CAPTION 스타일 비트를 지우고 TRUE로 설정합니다 CBasePane::m_bHasCaption .

자식 창 스타일과 MFC 컨트롤 바(CBRS_) 스타일의 조합을 사용할 수 있습니다.

라이브러리는 창에 대한 몇 가지 새 스타일을 추가합니다. 다음 표에서는 새 스타일에 대해 설명합니다.

스타일 설명
AFX_CBRS_FLOAT 창이 부동할 수 있습니다.
AFX_CBRS_AUTOHIDE 창에서 자동 숨기기 모드를 지원합니다.
AFX_CBRS_RESIZE 창의 크기를 조정할 수 있습니다. 중요: 이 스타일은 구현되지 않습니다.
AFX_CBRS_CLOSE 창을 닫을 수 있습니다.
AFX_CBRS_AUTO_ROLLUP 창이 떠 있을 때 롤업할 수 있습니다.
AFX_CBRS_REGULAR_TABS 한 창이 이 스타일이 있는 다른 창에 도킹되면 일반 탭 창이 만들어집니다. (자세한 내용은 를 참조하세요 .CTabbedPane 클래스.)
AFX_CBRS_OUTLOOK_TABS 한 창이 이 스타일이 있는 다른 창에 도킹되면 Outlook 스타일 탭 창이 만들어집니다. (자세한 내용은 를 참조하세요 .CMFCOutlookBar 클래스.)

새 스타일을 사용하려면 dwControlBarStyle에서 지정합니다.

CBasePane::D ockPane

창을 다른 창이나 프레임 창에 도킹합니다.

virtual BOOL DockPane(
    CBasePane* pDockBar,
    LPCRECT lpRect,
    AFX_DOCK_METHOD dockMethod);

매개 변수

pDockBar
[in] 다른 창에 대한 포인터입니다.

lpRect
[in] 대상 사각형을 지정합니다.

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

Return Value

컨트롤 막대가 성공적으로 도킹되었으면 TRUE입니다. 그렇지 않으면 FALSE입니다.

설명

이 함수를 호출하여 창을 pDockBar로 지정된 다른 창이나 도크 바(CDockSite 클래스)에 도킹하거나 pDockBar가 NULL인 경우 주 프레임에 도킹합니다.

dockMethod 는 창이 도킹되는 방법을 지정합니다. 가능한 값 목록은 CPane::D ockPane을 참조하세요.

CBasePane::D ockPaneUsingRTTI

런타임 형식 정보를 사용하여 창을 도킹합니다.

void DockPaneUsingRTTI(BOOL bUseDockSite);

매개 변수

bUseDockSite
[in] TRUE이면 도킹 사이트에 도킹합니다. FALSE이면 부모 프레임에 도킹합니다.

CBasePane::D ockToFrameWindow

고정 가능한 창을 프레임에 도킹합니다.

virtual BOOL DockToFrameWindow(
    DWORD dwAlignment,
    LPCRECT lpRect = NULL,
    DWORD dwDockFlags = DT_DOCK_LAST,
    CBasePane* pRelativeBar = NULL,
    int nRelativeIndex = -1,
    BOOL bOuterEdge = FALSE);

매개 변수

dwAlignment
[in] 창을 도킹할 부모 프레임의 측면입니다.

lpRect
[in] 원하는 크기입니다.

dwDockFlags
[in] 무시됩니다.

pRelativeBar
[in] 무시됩니다.

nRelativeIndex
[in] 무시됩니다.

bOuterEdge
[in] TRUE이고 dwAlignment로 지정된 측면에 다른 도킹 가능한 창이 있는 경우 창은 부모 프레임의 가장자리에 가까운 다른 창 외부에 도킹됩니다. FALSE이면 창이 클라이언트 영역의 가운데에 더 가깝게 도킹됩니다.

Return Value

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

설명

창 구분선( CPaneDivider 클래스)을 만들 수 없으면 이 메서드가 실패합니다. 그렇지 않으면 항상 TRUE를 반환합니다.

CBasePane::D oesAllowDynInsertBefore

이 창과 부모 프레임 사이에 다른 창을 동적으로 삽입할 수 있는지 여부를 결정합니다.

virtual BOOL DoesAllowDynInsertBefore() const;

Return Value

TRUE이면 사용자가 다른 창을 삽입할 수 있습니다. 그렇지 않으면 FALSE입니다.

설명

프레임워크는 이 메서드를 호출하여 사용자가 이 창 앞에 창을 동적으로 삽입할 수 있는지 여부를 결정합니다.

예를 들어 애플리케이션이 프레임의 왼쪽에 고정된 창(예: Outlook 표시줄)을 만든다고 가정합니다. 사용자가 첫 번째 창의 왼쪽에 다른 창을 도킹하지 못하도록 하려면 이 메서드를 재정의하고 FALSE를 반환합니다.

CDockablePane 클래스에서 파생된 부동이 아닌 창에 대해 이 메서드를 재정의하고 FALSE를 반환하는 것이 좋습니다.

기본 구현은 TRUE를 반환합니다.

CBasePane::D oPaint

창의 배경을 채웁니다.

virtual void DoPaint(CDC* pDC);

매개 변수

pDC
[in] 디바이스 컨텍스트에 대한 포인터입니다.

설명

기본 구현은 현재 시각적 관리자를 호출하여 배경을 채웁니다( CMFCVisualManager::OnFillBarBackground).

CBasePane::EnableDocking

창을 주 프레임에 도킹할 수 있습니다.

virtual void EnableDocking(DWORD dwAlignment);

매개 변수

dwAlignment
[in] 사용하도록 설정할 도킹 맞춤을 지정합니다.

설명

주 프레임에 대한 도킹 맞춤을 사용하도록 설정하려면 이 메서드를 호출합니다. CBRS_ALIGN_ 플래그의 조합을 전달할 수 있습니다(자세한 내용은 CControlBar::EnableDocking 참조).

EnableDocking 는 내부 플래그 CBasePane::m_dwEnabledAlignment 를 설정하고 프레임워크는 창이 도킹될 때 이 플래그를 확인합니다.

CBasePane::GetEnabledAlignment를 호출하여 창의 도킹 맞춤을 확인합니다.

CBasePane::EnableGripper

그리퍼를 사용하거나 사용하지 않도록 설정합니다. 그리퍼를 사용하도록 설정하면 사용자가 끌어 창의 위치를 변경할 수 있습니다.

virtual void EnableGripper(BOOL bEnable);

매개 변수

bEnable
[in] 그리퍼를 사용하도록 설정하려면 TRUE입니다. FALSE를 사용하여 사용하지 않도록 설정합니다.

설명

프레임워크는 이 메서드를 사용하여 WS_CAPTION 스타일을 사용하는 대신 그리퍼를 사용하도록 설정합니다.

CBasePane::FloatPane

창을 부동합니다.

virtual BOOL FloatPane(
    CRect rectFloat,
    AFX_DOCK_METHOD dockMethod=DM_UNKNOWN,
    bool bShow=true);

매개 변수

rectFloat
[in] 부동 창이 나타나는 화면 좌표를 지정합니다.

dockMethod
[in] 창을 부동하는 데 사용할 dock 메서드를 지정합니다.

bShow
[in] 부동 창이 표시되는지(TRUE) 또는 숨김(FALSE)인지를 지정합니다.

Return Value

창이 성공적으로 부동된 경우 TRUE입니다. 그렇지 않으면 FALSE입니다.

설명

rectFloat으로 지정된 화면 위치에 창을 부동하려면 이 메서드를 호출합니다.

CBasePane::get_accHelpTopic

프레임워크는 이 메서드를 호출하여 지정된 개체와 연결된 WinHelp 파일의 전체 경로와 해당 파일에 있는 해당 항목의 식별자를 검색합니다.

virtual HRESULT get_accHelpTopic(
    BSTR* pszHelpFile,
    VARIANT varChild,
    long* pidTopic);

매개 변수

pszHelpFile
[in] 지정된 개체와 연결된 WinHelp 파일의 전체 경로(있는 경우)를 수신하는 BSTR의 주소입니다.

varChild
[in] 검색할 도움말 항목이 개체의 항목인지 아니면 개체의 자식 요소 중 하나인지를 지정합니다. 이 매개 변수는 CHILDID_SELF(개체에 대한 도움말 항목을 가져오기 위해) 또는 자식 ID(개체의 자식 요소 중 하나에 대한 도움말 항목을 가져오기 위해)일 수 있습니다.

pidTopic
[in] 지정된 개체와 연결된 도움말 파일 항목을 식별합니다.

Return Value

CBasePane 이 메서드를 구현하지 않습니다. 따라서 CBasePane::get_accHelpTopic 항상 S_FALSE 반환합니다.

설명

이 함수는 MFC의 활성 접근성 지원의 일부입니다. 파생 클래스에서 이 함수를 재정의하여 개체에 대한 도움말 정보를 제공합니다.

CBasePane::get_accSelection

프레임워크는 이 메서드를 호출하여 이 개체의 선택한 자식을 검색합니다.

virtual HRESULT get_accSelection(VARIANT* pvarChildren);

매개 변수

pvarChildren
[in] 선택한 자식을 식별하는 정보를 받습니다.

Return Value

CBasePane 이 메서드를 구현하지 않습니다. pvarChildren가 NULL이면 이 메서드는 E_INVALIDARG 반환합니다. 그렇지 않으면 이 메서드는 DISP_E_MEMBERNOTFOUND 반환합니다.

설명

이 함수는 MFC의 활성 접근성 지원의 일부입니다. 창 없는 ActiveX 컨트롤 이외의 창이 없는 사용자 인터페이스 요소가 있는 경우 파생 클래스에서 이 함수를 재정의합니다.

CBasePane::GetCaptionHeight

캡션 높이를 반환합니다.

virtual int GetCaptionHeight() const;

Return Value

캡션 높이입니다.

CBasePane::GetControlBarStyle

컨트롤 막대 스타일을 반환합니다.

virtual DWORD GetControlBarStyle() const

Return Value

AFX_CBRS_ 플래그의 비트 OR 조합입니다.

설명

반환 값은 다음과 같은 가능한 값의 조합입니다.

스타일 설명
AFX_CBRS_FLOAT 컨트롤 막대를 부동으로 만듭니다.
AFX_CBRS_AUTOHIDE 자동 숨기기 모드를 사용하도록 설정합니다.
AFX_CBRS_RESIZE 컨트롤 막대의 크기를 조정할 수 있습니다. 이 플래그를 설정하면 컨트롤 막대를 도킹 가능한 창에 배치할 수 있습니다.
AFX_CBRS_CLOSE 컨트롤 막대를 숨길 수 있습니다.

CBasePane::GetCurrentAlignment

현재 창 맞춤을 반환합니다.

virtual DWORD GetCurrentAlignment() const;

Return Value

컨트롤 막대의 현재 맞춤입니다. 다음 표에는 가능한 값이 나와 있습니다.

맞춤
CBRS_ALIGN_LEFT 왼쪽 맞춤입니다.
CBRS_ALIGN_RIGHT 오른쪽 맞춤.
CBRS_ALIGN_TOP 위쪽 맞춤입니다.
CBRS_ALIGN_BOTTOM 아래쪽 맞춤입니다.

CBasePane::GetDockingMode

창의 현재 도킹 모드를 반환합니다.

virtual AFX_DOCK_TYPE GetDockingMode() const;

Return Value

DT_STANDARD 끌어온 사각형으로 창이 화면에 표시되는지 여부를 나타냅니다. 창의 내용을 끌면 DT_IMMEDIATE.

설명

프레임워크는 이 메서드를 호출하여 창의 현재 도킹 모드를 확인합니다.

정의되지 않은 경우 CBasePane::m_dockMode (DT_UNDEFINED) 도킹 모드는 전역 도킹 모드(AFX_GLOBAL_DATA::m_dockModeGlobal)에서 가져옵니다.

m_dockMode 설정하거나 재정의하면 GetDockingMode 각 창의 도킹 모드를 제어할 수 있습니다.

CBasePane::GetDockSiteFrameWnd

창이 도킹된 CDockingPanesRow개체에 대한 포인터를 반환합니다.

virtual CWnd* GetDockSiteFrameWnd() const;

Return Value

창의 도크 사이트에 대한 포인터입니다.

설명

창의 도크 사이트에 대한 포인터를 검색하려면 이 메서드를 호출합니다. 도크 사이트는 창이 주 프레임에 도킹된 경우 주 프레임 창이거나, 창이 부동하는 경우 미니 프레임 창일 수 있습니다.

CBasePane::GetEnabledAlignment

창에 적용되는 CBRS_ALIGN_ 스타일을 반환합니다.

virtual DWORD GetEnabledAlignment() const;

Return Value

CBRS_ALIGN_ 스타일의 조합입니다. 다음 표에서는 가능한 스타일을 보여 줍니다.

Flag 맞춤 사용
CBRS_ALIGN_LEFT 왼쪽.
CBRS_ALIGN_RIGHT 맞아요.
CBRS_ALIGN_TOP Top.
CBRS_ALIGN_BOTTOM 밑바닥.
CBRS_ALIGN_ANY 모든 플래그의 조합입니다.

설명

창에 대해 활성화된 맞춤을 확인하려면 이 메서드를 호출합니다. 맞춤이 사용됨은 창을 도킹할 수 있는 주 프레임 창의 측면을 의미합니다.

CBasePane::EnableDocking을 사용하여 도킹 맞춤을 사용하도록 설정합니다.

CBasePane::GetMFCStyle

MFC와 관련된 창 스타일을 반환합니다.

virtual DWORD GetMFCStyle() const;

Return Value

라이브러리별(AFX_CBRS_) 창 스타일의 조합입니다.

CBasePane::GetPaneIcon

창 아이콘에 대한 핸들을 반환합니다.

virtual HICON GetPaneIcon(BOOL bBigIcon);

매개 변수

bBigIcon
[in] TRUE인 경우 32픽셀 x 32픽셀 아이콘을 지정합니다. 는 FALSE인 경우 16픽셀 x 16픽셀 아이콘을 지정합니다.

Return Value

창 아이콘에 대한 핸들입니다. 실패하면 NULL을 반환합니다.

설명

기본 구현에서는 CWnd::GetIcon을 호출합니다.

CBasePane::GetPaneRow

창이 도킹된 CDockingPanesRow개체에 대한 포인터를 반환합니다.

CDockingPanesRow* GetPaneRow();

Return Value

창이 도킹되었는지에 대한 CDockingPanesRow 포인터이거나, 부동 창이 있는 경우 NULL입니다.

설명

창이 도킹된 행에 액세스하려면 이 메서드를 호출합니다. 예를 들어 특정 행에서 창을 정렬하려면 CDockingPanesRow::ArrangePanes를 호출 GetPaneRow 한 다음 호출 합니다.

CBasePane::GetPaneStyle

창 스타일을 반환합니다.

virtual DWORD GetPaneStyle() const;

Return Value

생성 시 CBasePane::SetPaneStyle 메서드에 의해 설정된 컨트롤 막대 스타일(CBRS_ 스타일 포함)의 조합입니다.

CBasePane::GetParentDockSite

부모 도크 사이트에 대한 포인터를 반환합니다.

virtual CDockSite* GetParentDockSite() const;

Return Value

부모 도크 사이트입니다.

CBasePane::GetParentMiniFrame

부모 미니 프레임 창에 대한 포인터를 반환합니다.

virtual CPaneFrameWnd* GetParentMiniFrame(BOOL bNoAssert=FALSE) const;

매개 변수

bNoAssert
[in] TRUE이면 이 메서드는 유효하지 않은 포인터를 확인하지 않습니다. 애플리케이션이 종료되면 이 메서드를 호출하는 경우 이 매개 변수를 TRUE로 설정합니다.

Return Value

창이 부동하는 경우 부모 미니 프레임 창에 대한 유효한 포인터입니다. 그렇지 않으면 NULL입니다.

설명

부모 미니 프레임 창에 대한 포인터를 검색하려면 이 함수를 호출합니다. 이 메서드는 모든 부모를 반복하고 CPaneFrameWnd 클래스에서 파생된 개체를 확인합니다.

창이 부동인지 여부를 확인하는 데 사용합니다 GetParentMiniFrame .

CBasePane::GetParentTabbedPane

부모 탭 창에 대한 포인터를 반환합니다.

CBaseTabbedPane* GetParentTabbedPane() const;

Return Value

부모 탭 창에 대한 포인터(있는 경우)입니다. 그렇지 않으면 NULL입니다.

CBasePane::GetParentTabWnd

탭 내에 있는 부모 창에 대한 포인터를 반환합니다.

CMFCBaseTabCtrl* GetParentTabWnd(HWND& hWndTab) const;

매개 변수

hWndTab
[out] 반환 값이 NULL이 아닌 경우 이 매개 변수는 부모 탭 창에 대한 핸들을 포함합니다.

Return Value

부모 탭 창 또는 NULL에 대한 유효한 포인터입니다.

설명

이 함수를 사용하여 부모 탭 창에 대한 포인터를 검색합니다. 창이 도킹 래퍼(CDockablePaneAdapter 클래스) 내부 또는 창 어댑터(CDockablePaneAdapter 클래스) 내부에 있을 수 있으므로 호출GetParent하기에 충분하지 않은 경우가 있습니다. 이러한 GetParentTabWnd 경우(부모가 탭 창이라고 가정) 유효한 포인터를 검색할 수 있습니다.

CBasePane::GetRecentVisibleState

프레임워크는 보관 파일에서 창을 복원할 때 이 메서드를 호출합니다.

virtual BOOL GetRecentVisibleState() const;

Return Value

최근 표시되는 상태를 지정하는 BOOL입니다. TRUE이면 serialize할 때 창이 표시되고 복원될 때 표시되어야 합니다. FALSE이면 직렬화할 때 창이 숨겨졌으며 복원할 때 숨겨야 합니다.

CBasePane::HideInPrintPreviewMode

인쇄 미리 보기에서 창을 숨길지 여부를 지정합니다.

virtual BOOL HideInPrintPreviewMode() const;

Return Value

인쇄 미리 보기에 창이 표시되지 않으면 TRUE입니다. 그렇지 않으면 FALSE입니다.

설명

기본 창은 인쇄 미리 보기에 표시되지 않습니다. 따라서 이 메서드는 항상 TRUE를 반환합니다.

CBasePane::InsertPane

지정한 창을 도킹 관리자에 등록합니다.

BOOL InsertPane(
    CBasePane* pControlBar,
    CBasePane* pTarget,
    BOOL bAfter = TRUE);

매개 변수

pControlBar
[in] 삽입할 창에 대한 포인터입니다.

pTarget
[in] 인접한 창에 대한 포인터입니다.

bAfter
[in] TRUE이면 pTarget 뒤에 pControlBar가 삽입됩니다. FALSE이면 pTarget 앞에 pControlBar가 삽입됩니다.

Return Value

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

CBasePane::IsAccessibilityCompatible

창에서 활성 접근성을 지원하는지 여부를 지정합니다.

virtual BOOL IsAccessibilityCompatible();

Return Value

창에서 활성 접근성을 지원하는 경우 TRUE입니다. 그렇지 않으면 FALSE입니다.

CBasePane::IsAutoHideMode

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

virtual BOOL IsAutoHideMode() const;

Return Value

창이 자동 숨기기 모드인 경우 TRUE입니다. 그렇지 않으면 FALSE입니다.

설명

기본 창은 자동으로 숨길 수 없습니다. 이 메서드는 항상 FALSE를 반환합니다.

CBasePane::IsDialogControl

창이 대화 상자 컨트롤인지 여부를 지정합니다.

BOOL IsDialogControl() const;

Return Value

창이 대화 상자 컨트롤이면 TRUE이고, 그렇지 않으면 FALSE입니다.

설명

프레임워크는 이 메서드를 사용하여 모든 창에 대한 레이아웃 일관성을 보장합니다.

CBasePane::IsDocked

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

virtual BOOL IsDocked() const;

Return Value

창의 부모가 미니 프레임이 아니거나 창이 다른 창을 사용하여 미니 프레임에 부동하는 경우 TRUE입니다. 그렇지 않으면 FALSE입니다.

CBasePane::IsFloating

창이 부동인지 여부를 확인합니다.

virtual BOOL IsFloating() const;

Return Value

창이 부동하는 경우 TRUE입니다. 그렇지 않으면 FALSE입니다.

설명

이 메서드는 CBasePane::IsDocked반대 값을 반환합니다.

CBasePane::IsHorizontal

창이 가로로 도킹되는지 여부를 확인합니다.

virtual BOOL IsHorizontal() const;

Return Value

창이 가로로 도킹되면 TRUE이고, 그렇지 않으면 FALSE입니다.

설명

기본 구현은 현재 도킹 맞춤에서 CBRS_ORIENT_HORZ 확인합니다.

CBasePane::IsInFloatingMultiPaneFrameWnd

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

virtual BOOL IsInFloatingMultiPaneFrameWnd() const;

Return Value

창이 다중 창 프레임 창에 있는 경우 TRUE입니다. 그렇지 않으면 FALSE입니다.

설명

도킹 가능한 창만 다중 창 프레임 창에 부동할 수 있습니다. 따라서 CBasePane::IsInFloatingMultiPaneFrameWnd 항상 FALSE를 반환합니다.

CBasePane::IsMDITabbed

창이 탭 문서로 MDI 자식 창에 추가되었는지 여부를 확인합니다.

virtual BOOL IsMDITabbed() const;

Return Value

창이 탭 문서로 MDI 자식 창에 추가된 경우 TRUE입니다. 그렇지 않으면 FALSE입니다.

CBasePane::IsPaneVisible

창에 WS_VISIBLE 플래그를 설정할지 여부를 지정합니다.

BOOL IsPaneVisible() const;

Return Value

true이면 WS_VISIBLE 설정됩니다. 그렇지 않으면 FALSE입니다.

설명

CBasePane::IsVisible을 사용하여 창 표시 여부를 확인합니다.

CBasePane::IsPointNearDockSite

지정된 지점이 Dock 사이트 근처에 있는지 여부를 확인합니다.

BOOL IsPointNearDockSite(
    CPoint point,
    DWORD& dwBarAlignment,
    BOOL& bOuterEdge) const;

매개 변수

point
[in] 지정된 지점입니다.

dwBarAlignment
[out] 점이 가까운 가장자리를 지정합니다. 가능한 값은 CBRS_ALIGN_LEFT, CBRS_ALIGN_RIGHT, CBRS_ALIGN_TOP 및 CBRS_ALIGN_BOTTOM

bOuterEdge
[out] 지점이 도크 사이트의 바깥 테두리 근처에 있으면 TRUE이고, 그렇지 않으면 FALSE입니다.

Return Value

지점이 도크 사이트 근처에 있으면 TRUE입니다. 그렇지 않으면 FALSE입니다.

설명

지점은 도킹 관리자의 민감도 집합 내에 있을 때 도킹 사이트 근처에 있습니다. 기본 민감도는 15픽셀입니다.

CBasePane::IsResizable

창의 크기를 조정할 수 있는지 여부를 결정합니다.

virtual BOOL IsResizable() const;

Return Value

사용자가 창의 크기를 조정할 수 있으면 TRUE입니다. 그렇지 않으면 FALSE입니다.

설명

CDockablePane 클래스창 크기를 조정할 수 있습니다.

상태 표시줄( CMFCStatusBar 클래스) 및 도크 막대( CDockSite 클래스)의 크기를 조정할 수 없습니다.

CBasePane::IsRestoredFromRegistry

레지스트리에서 창을 복원할지 여부를 결정합니다.

virtual BOOL IsRestoredFromRegistry() const;

Return Value

레지스트리에서 창이 복원되면 TRUE입니다. 그렇지 않으면 FALSE입니다.

CBasePane::IsTabbed

창이 탭 창의 탭 컨트롤에 삽입되었는지 여부를 확인합니다.

virtual BOOL IsTabbed() const;

Return Value

탭 창의 탭에 컨트롤 막대가 삽입되면 TRUE이고, 그렇지 않으면 FALSE입니다.

설명

이 메서드는 직접 부모에 대한 포인터를 검색하고 부모의 런타임 클래스가 CMFCBaseTabCtrl 클래스인지 확인합니다.

CBasePane::IsVisible

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

virtual BOOL IsVisible() const;

Return Value

창이 표시되면 TRUE이고, 그렇지 않으면 FALSE입니다.

설명

이 메서드를 사용하여 창의 표시 여부를 확인합니다. ::IsWindowVisible는 사용하지 마세요.

창이 탭되지 않은 경우(CBasePane::IsTabbed 참조 ) 이 메서드는 WS_VISIBLE 스타일을 확인합니다. 창이 탭된 경우 이 메서드는 부모 탭 창의 표시 유형을 확인합니다. 부모 창이 표시되면 함수는 CMFCBaseTabCtrl::IsTabVisible을 사용하여 창 탭의 표시 유형을 확인합니다.

CBasePane::LoadState

레지스트리에서 창의 상태를 로드합니다.

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

매개 변수

lpszProfileName
[in] 프로필 이름입니다.

nIndex
[in] 프로필 인덱스입니다.

uiID
[in] 창 ID입니다.

Return Value

창 상태가 성공적으로 로드되었으면 TRUE입니다. 그렇지 않으면 FALSE입니다.

설명

프레임워크는 이 메서드를 호출하여 레지스트리에서 창 상태를 로드합니다. CBasePane::SaveState에서 저장 한 추가 정보를 로드하려면 파생 클래스에서 재정의합니다.

CBasePane::MoveWindow

창을 이동합니다.

virtual HDWP MoveWindow(
    CRect& rect,
    BOOL bRepaint = TRUE,
    HDWP hdwp = NULL);

매개 변수

rect
[in] 창의 새 위치와 크기를 지정하는 사각형입니다.

bRepaint
[in] TRUE이면 창이 다시 그려집니다. FALSE이면 창이 다시 그려지지 않습니다.

hdwp
[in] 지연된 창 위치 구조에 대한 핸들입니다.

Return Value

지연된 창 위치 구조 또는 NULL에 대한 핸들입니다.

설명

NULL을 hdwp 매개 변수로 전달하는 경우 이 메서드는 창을 정상적으로 이동합니다. 핸들을 전달하는 경우 이 메서드는 지연된 창 이동을 수행합니다. BeginDeferWindowPos를 호출하거나 이 메서드에 대한 이전 호출의 반환 값을 저장하여 핸들을 가져올 수 있습니다.

CBasePane::OnAfterChangeParent

창의 부모가 변경된 후 프레임워크에서 호출됩니다.

virtual void OnAfterChangeParent(CWnd* pWndOldParent);

매개 변수

pWndOldParent
[in] 이전 부모에 대한 포인터입니다.

설명

프레임워크는 일반적으로 도킹 또는 부동 작업으로 인해 창의 부모가 변경된 후 이 메서드를 호출합니다.

기본 구현은 아무 작업도 수행하지 않습니다.

CBasePane::OnBeforeChangeParent

창이 부모 창을 변경하기 직전에 프레임워크에서 호출됩니다.

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

매개 변수

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

bDelay
[in] 레이아웃 조정을 연기해야 하는지 여부를 지정합니다.

설명

프레임워크는 일반적으로 도킹, 부동 또는 자동 숨기기 작업으로 인해 창의 부모가 변경되기 직전에 이 메서드를 호출합니다.

기본 구현은 아무 작업도 수행하지 않습니다.

CBasePane::OnDrawCaption

프레임워크는 캡션이 그려질 때 이 메서드를 호출합니다.

virtual void OnDrawCaption();

설명

이 메서드에는 클래스에 대한 CBasePane 기능이 없습니다.

CBasePane::OnMovePaneDivider

이 메서드는 현재 사용되지 않습니다.

virtual void OnMovePaneDivider(CPaneDivider* /* unused */);

매개 변수

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

CBasePane::OnPaneContextMenu

창 목록이 있는 메뉴를 빌드할 때 프레임워크에서 호출됩니다.

virtual void OnPaneContextMenu(
    CWnd* pParentFrame,
    CPoint point);

매개 변수

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

point
[in] 바로 가기 메뉴의 위치를 지정합니다.

설명

OnPaneContextMenu 는 현재 프레임 창에 속하는 창 목록을 유지 관리하는 도킹 관리자를 호출합니다. 이 메서드는 바로 가기 메뉴에 창의 이름을 추가하고 표시합니다. 메뉴의 명령은 개별 창을 표시하거나 숨깁니다.

이 동작을 사용자 지정하려면 이 메서드를 재정의합니다.

CBasePane::OnRemoveFromMiniFrame

부모 미니 프레임 창에서 창을 제거할 때 프레임워크에서 호출됩니다.

virtual void OnRemoveFromMiniFrame(CPaneFrameWnd* pMiniFrame);

매개 변수

pMiniFrame
[in] 창이 제거되는 미니 프레임 창에 대한 포인터입니다.

설명

프레임워크는 부모 미니 프레임 창에서 창이 제거될 때(예: 도킹의 결과로) 이 메서드를 호출합니다.

기본 구현은 아무 작업도 수행하지 않습니다.

CBasePane::OnSetAccData

CBasePane 이 메서드를 사용하지 않습니다.

virtual BOOL OnSetAccData(long lVal);

매개 변수

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

Return Value

이 메서드는 항상 TRUE를 반환합니다.

설명

CBasePane::P aneFromPoint

지정된 점을 포함하는 창을 반환합니다.

CBasePane* PaneFromPoint(
    CPoint point,
    int nSensitivity,
    bool bExactBar = false,
    CRuntimeClass* pRTCBarType = NULL) const;

매개 변수

point
[in] 확인할 점을 화면 좌표로 지정합니다.

nSensitivity
[in] 검색 영역을 이 크기만큼 늘입니다. 지정된 지점이 증가된 영역에 속하는 경우 창이 검색 조건을 충족합니다.

bExactBar
[in] nSensitivity 매개 변수를 무시하려면 TRUE이고, 그렇지 않으면 FALSE입니다 .

pRTCBarType
[in] NULL이 아닌 경우 메서드는 지정된 형식의 창만 검색합니다.

Return Value

CBasePane지정된 지점을 포함하는 파생 개체이거나, 창이 없으면 NULL입니다.

CBasePane::RecalcLayout

CBasePane 이 메서드를 사용하지 않습니다.

virtual void RecalcLayout();

CBasePane::RemovePaneFromDockManager

창을 등록 취소하고 도킹 관리자의 목록에서 제거합니다.

void RemovePaneFromDockManager(
    CBasePane* pBar,
    BOOL bDestroy = TRUE,
    BOOL bAdjustLayout = FALSE,
    BOOL bAutoHide = FALSE,
    CBasePane* pBarReplacement = NULL);

매개 변수

pBar
[in] 제거할 창에 대한 포인터입니다.

bDestroy
[in] TRUE이면 제거된 창이 제거됩니다.

bAdjustLayout
[in] TRUE이면 도킹 레이아웃을 즉시 조정합니다.

bAutoHide
[in] TRUE이면 도킹 레이아웃이 자동 숨기기 막대 목록과 관련이 있습니다. FALSE이면 도킹 레이아웃이 일반 창 목록과 관련이 있습니다.

pBarReplacement
[in] 제거된 창을 대체하는 창에 대한 포인터입니다.

CBasePane::SaveState

레지스트리에 창의 상태를 저장합니다.

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

매개 변수

lpszProfileName
[in] 프로필 이름입니다.

nIndex
[in] 프로필 인덱스입니다.

uiID
[in] 창 ID입니다.

Return Value

상태가 성공적으로 저장되었으면 TRUE입니다. 그렇지 않으면 FALSE입니다.

설명

프레임워크는 창의 상태를 레지스트리에 저장할 때 이 메서드를 호출합니다. 파생 클래스에서 재정 SaveState 의하여 추가 정보를 저장합니다.

CBasePane::SelectDefaultFont

지정된 디바이스 컨텍스트에 대한 기본 글꼴을 선택합니다.

CFont* SelectDefaultFont(CDC* pDC);

매개 변수

pDC
[in] 디바이스 컨텍스트입니다.

Return Value

기본 CFont 클래스 개체에 대한 포인터입니다.

CBasePane::SetControlBarStyle

컨트롤 막대 스타일을 설정합니다.

virtual void SetControlBarStyle(DWORD dwNewStyle);

매개 변수

dwNewStyle
[in] 다음과 같은 가능한 값의 비트 OR 조합입니다.

스타일 설명
AFX_CBRS_FLOAT 컨트롤 막대를 부동으로 만듭니다.
AFX_CBRS_AUTOHIDE 자동 숨기기 모드를 사용하도록 설정합니다.
AFX_CBRS_RESIZE 컨트롤 막대의 크기를 조정할 수 있습니다. 이 플래그를 설정하면 컨트롤 막대를 도킹 가능한 창에 배치할 수 있습니다.
AFX_CBRS_CLOSE 컨트롤 막대를 숨길 수 있습니다.

CBasePane::SetDockingMode

창의 도킹 모드를 설정합니다.

void SetDockingMode(AFX_DOCK_TYPE dockModeNew);

매개 변수

dockModeNew
[in] 창의 새 도킹 모드를 지정합니다.

설명

프레임워크는 표준 및 즉시의 두 가지 도킹 모드를 지원합니다.

표준 도킹 모드에서 창과 미니 프레임 창은 끌기 사각형을 사용하여 이동합니다. 즉시 도킹 모드에서는 컨트롤 막대 및 미니 프레임 창이 컨텍스트와 함께 즉시 이동됩니다.

처음에 도킹 모드는 CDockingManager::m_dockModeGlobal 의해 전역적으로 정의됩니다. 메서드를 사용하여 각 창에 대한 도킹 모드를 SetDockingMode 개별적으로 설정할 수 있습니다.

CBasePane::SetPaneAlignment

창의 맞춤을 설정합니다.

virtual void SetPaneAlignment(DWORD dwAlignment);

매개 변수

dwAlignment
[in] 새 맞춤을 지정합니다.

설명

일반적으로 프레임워크는 기본 프레임의 한 쪽에서 다른 프레임으로 창이 도킹될 때 이 메서드를 호출합니다.

다음 표에서는 dwAlignment에 사용할 수 있는 값을 보여줍니다.

맞춤
CBRS_ALIGN_LEFT 왼쪽 맞춤입니다.
CBRS_ALIGN_RIGHT 오른쪽 맞춤.
CBRS_ALIGN_TOP 위쪽 맞춤입니다.
CBRS_ALIGN_BOTTOM 아래쪽 맞춤입니다.

CBasePane::SetPaneStyle

창의 스타일을 설정합니다.

virtual void SetPaneStyle(DWORD dwNewStyle);

매개 변수

dwNewStyle
[in] 설정할 새 스타일을 지정합니다.

설명

이 메서드는 afxres.h에 정의된 CBRS_ 스타일을 설정하는 데 사용할 수 있습니다. 창 스타일과 창 맞춤은 함께 저장되므로 다음과 같이 현재 맞춤과 결합하여 새 스타일을 설정합니다.

pPane->SetPaneStyle (pPane->GetCurrentAlignment() | CBRS_TOOLTIPS);

CBasePane::SetWindowPos

창의 크기, 위치 및 Z 순서를 변경합니다.

virtual HDWP SetWindowPos(
    const CWnd* pWndInsertAfter,
    int x,
    int y,
    int cx,
    int cy,
    UINT nFlags,
    HDWP hdwp = NULL);

매개 변수

pWndInsertAfter
[in] Z 순서로 CWndCWnd 개체 앞에 오는 개체를 식별합니다. 자세한 내용은 CWnd::SetWindowPos를 참조하세요.

x
[in] 창의 왼쪽 위치를 지정합니다.

y
[in] 창의 위쪽 위치를 지정합니다.

cx
[in] 창의 너비를 지정합니다.

cy
[in] 창의 높이를 지정합니다.

nFlags
[in] 크기 및 위치 옵션을 지정합니다. 자세한 내용은 CWnd::SetWindowPos를 참조하세요.

hdwp
[in] 하나 이상의 창에 대한 크기 및 위치 정보를 포함하는 구조체에 대한 핸들입니다.

Return Value

업데이트된 지연된 창 위치 구조 또는 NULL에 대한 핸들입니다.

설명

pWndInsertAfter가 NULL이면 이 메서드는 CWnd::SetWindowPos를 호출합니다. pWndInsertAfter가 NULL이 아닌 경우 이 메서드는 .를 호출합니다DeferWindowPos.

CBasePane::ShowPane

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

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

매개 변수

bShow
[in] 창을 표시할지(TRUE) 숨기거나 숨길지(FALSE)를 지정합니다.

bDelay
[in] TRUE이면 도킹 레이아웃 다시 계산이 지연됩니다.

bActivate
[in] TRUE이면 창이 표시되면 활성화됩니다.

설명

이 메서드는 창을 표시하거나 숨깁니다. 이 메서드는 관련 도킹 관리자에게 창의 ShowWindow 표시 유형 변경 내용을 알리기 때문에 대신 이 메서드를 사용합니다.

CBasePane::IsVisible을 사용하여 창의 현재 표시 여부를 확인합니다.

CBasePane::StretchPane

창을 가로 또는 세로로 확장합니다.

virtual CSize StretchPane(
    int nLength,
    BOOL bVert);

매개 변수

nLength
[in] 창을 늘일 길이입니다.

bVert
[in] TRUE이면 창을 세로로 늘입니다. FALSE이면 창을 가로로 늘입니다.

Return Value

확장된 창의 크기입니다.

CBasePane::UndockPane

현재 도킹된 도크 사이트, 기본 슬라이더 또는 미니 프레임 창에서 창을 제거합니다.

virtual void UndockPane(BOOL bDelay=FALSE);

매개 변수

bDelay
TRUE이면 도킹 레이아웃이 즉시 다시 계산되지 않습니다.

설명

이 메서드를 호출하여 창 상태를 조작하거나 도킹 레이아웃에서 창을 제외합니다.

이 창을 계속 사용하려면 이 메서드를 호출하기 전에 CBasePane::D ockPane 또는 CBasePane::FloatPane을 호출합니다.

참고 항목

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