CMDIChildWndEx 클래스

이 클래스는 CMDIChildWndEx Windows MDI(다중 문서 인터페이스) 자식 창의 기능을 제공합니다. CMDIChildWnd 클래스의 기능을 확장합니다. MDI 애플리케이션에서 특정 MFC 클래스를 사용하면 프레임워크에 이 클래스가 필요합니다.

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

구문

class CMDIChildWndEx : public CMDIChildWnd

멤버

공용 메서드

이름	설명
CMDIChildWndEx::ActivateTopLevelFrame	애플리케이션이 작업 표시줄 탭에서 활성화되어야 하는 경우 최상위 프레임을 활성화하기 위해 프레임워크에서 내부적으로 호출됩니다.
CMDIChildWndEx::AddDockSite	이 메서드는 사용되거나 구현되지 않습니다.
CMDIChildWndEx::AddPane	창을 추가합니다.
CMDIChildWndEx::AddTabbedPane	탭 창을 추가합니다.
CMDIChildWndEx::AdjustDockingLayout	도킹 레이아웃을 조정합니다.
CMDIChildWndEx::CanShowOnMDITabs
CMDIChildWndEx::CanShowOnTaskBarTabs	이 MDI 자식이 Windows 7 작업 표시줄 탭에 표시될 수 있는지 여부를 프레임워크에 알립니다.
CMDIChildWndEx::CanShowOnWindowsList	CMFCWindowsManagerDialog 클래스 대화 상자에 MDI 자식 창 이름을 표시할 수 있으면 TRUE를 반환합니다. 그러지 않으면 FALSE를 반환합니다.
CMDIChildWndEx::CreateObject	이 클래스 형식의 동적 인스턴스를 만들기 위해 프레임워크에서 호출됩니다.
CMDIChildWndEx::D ockPane	창을 도킹합니다.
CMDIChildWndEx::D ockPaneLeftOf	창을 다른 창의 왼쪽에 도킹합니다.
CMDIChildWndEx::EnableAutoHidePanes	창이 창의 지정된 측면에 도킹될 때 자동 숨기기 모드를 사용하도록 설정합니다.
CMDIChildWndEx::EnableDocking	자식 창을 주 프레임에 도킹할 수 있습니다.
CMDIChildWndEx::EnableTaskbarThumbnailClipRect	작업 표시줄에서 창의 축소판 그림으로 표시할 창의 클라이언트 영역 일부를 자동으로 선택하거나 사용하지 않도록 설정합니다.
CMDIChildWndEx::GetDockingManager
CMDIChildWndEx::GetDocumentName	MDI 자식 창에 표시되는 문서의 이름을 반환합니다.
CMDIChildWndEx::GetFrameIcon	MDI 자식 창 아이콘을 검색하기 위해 프레임워크에서 호출됩니다.
CMDIChildWndEx::GetFrameText	MDI 자식 창의 텍스트를 검색하기 위해 프레임워크에서 호출됩니다.
CMDIChildWndEx::GetPane	지정된 컨트롤 ID로 창을 찾습니다.
CMDIChildWndEx::GetRelatedTabGroup
CMDIChildWndEx::GetTabbedPane	탭 문서로 변환된 포함된 도킹 창에 대한 포인터를 반환합니다.
CMDIChildWndEx::GetTabProxyWnd	Windows 7 작업 표시줄 탭에 실제로 등록된 탭 프록시 창을 반환합니다.
CMDIChildWndEx::GetTaskbarPreviewWnd	Windows 7 작업 표시줄 탭 미리 보기에 표시할 자식 창(일반적으로 보기 또는 분할자 창)을 가져와야 하는 경우 프레임워크에서 호출됩니다.
CMDIChildWndEx::GetTaskbarThumbnailClipRect	작업 표시줄에서 해당 창의 축소판 그림으로 표시할 창의 클라이언트 영역 일부를 선택해야 하는 경우 프레임워크에서 호출됩니다.
CMDIChildWndEx::GetThisClass	이 클래스 형식과 연결된 CRuntimeClass 개체에 대한 포인터를 가져오기 위해 프레임워크에서 호출됩니다.
CMDIChildWndEx::GetToolbarButtonToolTipText	도구 모음 단추에 대한 도구 설명을 검색하기 위해 프레임워크에서 호출됩니다.
CMDIChildWndEx::InsertPane	지정한 창을 도킹 관리자에 등록합니다.
CMDIChildWndEx::InvalidateIconicBitmaps	MDI 자식의 아이콘 비트맵 표현을 무효화합니다.
CMDIChildWndEx::IsPointNearDockSite	지정된 지점이 Dock 사이트 근처에 있는지 여부를 확인합니다.
CMDIChildWndEx::IsReadOnly	자식 창에 표시되는 문서가 읽기 전용이면 TRUE를 반환합니다. 그러지 않으면 FALSE를 반환합니다.
CMDIChildWndEx::IsRegisteredWithTaskbarTabs	MDI 자식이 Windows 7 작업 표시줄 탭에 성공적으로 등록되면 TRUE를 반환합니다.
CMDIChildWndEx::IsTabbedPane	MDI 자식 창에 도킹 창이 포함된 경우 TRUE를 반환합니다. 그러지 않으면 FALSE를 반환합니다.
CMDIChildWndEx::IsTaskbarTabsSupportEnabled	MDI 자식이 Windows 7 작업 표시줄 탭에 나타날 수 있는지 여부를 알려줍니다.
CMDIChildWndEx::IsTaskbarThumbnailClipRectEnabled	작업 표시줄에서 해당 창의 축소판 그림으로 표시할 창의 클라이언트 영역 일부를 자동으로 선택할 수 있는지 여부를 지정합니다.
CMDIChildWndEx::m_dwDefaultTaskbarTabPropertyFlags	탭(MDI 자식)이 Windows 7 작업 표시줄 탭에 등록될 때 프레임워크에서 SetTaskbarTabProperties 메서드에 전달하는 플래그의 조합입니다. 기본 조합은 .입니다 STPF_USEAPPTHUMBNAILWHENACTIVE | STPF_USEAPPPEEKWHENACTIVE.
CMDIChildWndEx::OnGetIconicLivePreviewBitmap	MDI 자식의 라이브 미리 보기에 대한 비트맵을 가져와야 하는 경우 프레임워크에서 호출됩니다.
CMDIChildWndEx::OnGetIconicThumbnail	MDI 자식의 상징적인 축소판 그림에 대한 비트맵을 가져와야 하는 경우 프레임워크에서 호출됩니다.
CMDIChildWndEx::OnMoveMiniFrame	미니 프레임 창을 이동하기 위해 프레임워크에서 호출됩니다.
CMDIChildWndEx::OnPressTaskbarThmbnailCloseButton	사용자가 작업 표시줄 탭 미리 보기에서 닫기 단추를 누를 때 프레임워크에서 호출됩니다.
CMDIChildWndEx::OnSetPreviewMode	인쇄 미리 보기 모드를 입력하거나 종료하기 위해 프레임워크에서 호출됩니다.
CMDIChildWndEx::OnTaskbarTabThumbnailActivate	작업 표시줄 탭 미리 보기에서 WM_ACTIVATE 메시지를 처리해야 하는 경우 프레임워크에서 호출됩니다.
CMDIChildWndEx::OnTaskbarTabThumbnailMouseActivate	작업 표시줄 탭 미리 보기에서 WM_MOUSEACTIVATE 메시지를 처리해야 하는 경우 프레임워크에서 호출됩니다.
CMDIChildWndEx::OnTaskbarTabThumbnailStretch	MDI 자식의 Windows 7 작업 표시줄 탭 미리 보기에 대한 비트맵을 확장해야 하는 경우 프레임워크에서 호출됩니다.
CMDIChildWndEx::OnUpdateFrameTitle	프레임 제목을 업데이트하기 위해 프레임워크에서 호출됩니다. ( CMDIChildWnd::OnUpdateFrameTitle을 재정의합니다.)
CMDIChildWndEx::P aneFromPoint	지정된 점을 포함하는 창을 반환합니다.
CMDIChildWndEx::PreTranslateMessage	창 메시지가 TranslateMessage 및 DispatchMessage Windows 함수로 디스패치되기 전에 CWinApp 클래스가 이 메시지를 해석하는 데 사용됩니다. ( CWnd::PreTranslateMessage를 재정의합니다.)
CMDIChildWndEx::RecalcLayout	창의 레이아웃을 다시 계산합니다.
CMDIChildWndEx::RegisterTaskbarTab	Windows 7 작업 표시줄 탭에 MDI 자식 등록
CMDIChildWndEx::RemovePaneFromDockManager	도킹 관리자에서 창을 제거합니다.
CMDIChildWndEx::SetRelatedTabGroup
CMDIChildWndEx::SetTaskbarTabActive	해당 Windows 7 작업 표시줄 탭을 활성화합니다.
CMDIChildWndEx::SetTaskbarTabOrder	Windows 7 작업 표시줄 탭에서 지정된 창 앞에 MDI 자식 항목을 삽입합니다.
CMDIChildWndEx::SetTaskbarTabProperties	Windows 7 작업 표시줄 탭에 대한 속성을 설정합니다.
CMDIChildWndEx::SetTaskbarThumbnailClipRect	작업 표시줄에서 해당 창의 축소판 그림으로 표시할 창의 클라이언트 영역 일부를 선택하도록 클리핑 사각형을 설정하기 위해 프레임워크에서 내부적으로 호출합니다.
CMDIChildWndEx::ShowPane
CMDIChildWndEx::UnregisterTaskbarTab	Windows 7 작업 표시줄 탭에서 MDI 자식 제거
CMDIChildWndEx::UpdateTaskbarTabIcon	Windows 7 작업 표시줄 탭 아이콘을 업데이트합니다.

설명

MDI 애플리케이션에서 확장된 도킹 기능을 활용하려면 CMDIChildWnd 대신 애플리케이션 CMDIChildWndEx 의 MDI 자식 창 클래스를 파생합니다.

예시

다음 예제에서는 .에서 CMDIChildWndEx클래스를 파생합니다. 이 코드 조각은 VisualStudioDemo 샘플: MFC Visual Studio 애플리케이션에서 제공됩니다.

class CChildFrame : public CMDIChildWndEx
{
   DECLARE_DYNCREATE(CChildFrame)
public:
   CChildFrame();

   // Overrides
public:
   virtual BOOL PreCreateWindow(CREATESTRUCT &cs);
   virtual void ActivateFrame(int nCmdShow = -1);

   virtual BOOL IsReadOnly();
   virtual LPCTSTR GetDocumentName(CObject **pObj);

   // Implementation
public:
   virtual ~CChildFrame();
#ifdef _DEBUG
   virtual void AssertValid() const;
   virtual void Dump(CDumpContext &dc) const;
#endif

protected:
   afx_msg int OnCreate(LPCREATESTRUCT lpCreateStruct);

   DECLARE_MESSAGE_MAP()
};

상속 계층 구조

CObject

CCmdTarget

CWnd

CFrameWnd

CMDIChildWnd

CMDIChildWndEx

요구 사항

헤더: afxMDIChildWndEx.h

CMDIChildWndEx::AddPane

창을 추가합니다.

BOOL AddPane(
    CBasePane* pControlBar,
    BOOL bTail = TRUE);

매개 변수

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

bTail
[in] TRUE이면 도킹 관리자의 창 목록 끝에 창을 추가합니다. 그렇지 않으면 FALSE입니다.

Return Value

창이 도킹 관리자에 성공적으로 등록되었으면 TRUE입니다. 그렇지 않으면 FALSE입니다.

CMDIChildWndEx::AddTabbedPane

탭 창을 추가합니다.

void AddTabbedPane(CDockablePane* pControlBar);

매개 변수

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

CMDIChildWndEx::AdjustDockingLayout

도킹 레이아웃을 조정합니다.

virtual void AdjustDockingLayout(HDWP hdwp = NULL);

매개 변수

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

CMDIChildWndEx::CanShowOnMDITabs

virtual BOOL CanShowOnMDITabs();

Return Value

설명

CMDIChildWndEx::CanShowOnWindowsList

CMFCWindowsManagerDialog 클래스 대화 상자에 MDI 자식 창 이름을 표시할 수 있는지 여부를 지정합니다.

virtual BOOL CanShowOnWindowsList();

Return Value

창이 Windows 대화 상자에 표시될 수 있으면 TRUE이고, 그렇지 않으면 FALSE입니다.

설명

파생 클래스에서 이 메서드를 재정의하고 창이 Windows 대화 상자에 표시되지 않아야 하는 경우 FALSE를 반환합니다. 이 함수는 .에서 CMFCWindowsManagerDialog호출됩니다.

CMDIChildWndEx::D ockPane

창을 도킹합니다.

void DockPane(
    CBasePane* pBar,
    UINT nDockBarID = 0,
    LPCRECT lpRect = NULL);

매개 변수

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

nDockBarID
[in] 창의 ID입니다.

lpRect
[in] 사각형에 대한 포인터입니다.

설명

lpRect 매개 변수는 사용되지 않습니다.

CMDIChildWndEx::D ockPaneLeftOf

창을 다른 창의 왼쪽에 도킹합니다.

BOOL DockPaneLeftOf(
    CPane* pBar,
    CPane* pLeftOf);

매개 변수

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

pLeftOf
참조 지점 역할을 하는 창에 대한 포인터입니다.

Return Value

성공하면 TRUE, 실패의 경우 FALSE입니다.

설명

이 메서드는 pBar로 지정된 창을 가져와서 pLeftOf로 지정된 창의 왼쪽에 도킹합니다.

미리 정의된 순서로 여러 창을 도킹하려는 경우 이 메서드를 호출합니다.

CMDIChildWndEx::EnableAutoHidePanes

창이 창의 지정된 측면에 도킹될 때 자동 숨기기 모드를 사용하도록 설정합니다.

BOOL EnableAutoHidePanes(DWORD dwDockStyle);

매개 변수

dwDockStyle
[in] 사용하도록 설정된 주 프레임 창의 측면을 지정합니다. 다음 플래그 중 하나 이상을 사용합니다.

• CBRS_ALIGN_LEFT

• CBRS_ALIGN_RIGHT

• CBRS_ALIGN_TOP

• CBRS_ALIGN_BOTTOM

Return Value

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

CMDIChildWndEx::EnableDocking

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

BOOL EnableDocking(DWORD dwDockStyle);

매개 변수

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

Return Value

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

설명

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

CMDIChildWndEx::GetDockingManager

CDockingManager* GetDockingManager();

Return Value

설명

CMDIChildWndEx::GetDocumentName

MDI 자식 창에 표시되는 문서의 이름을 반환합니다.

virtual LPCTSTR GetDocumentName(CObject** pObj);

Return Value

문서의 이름을 포함하는 문자열에 대한 포인터입니다.

설명

문서는 MDI 자식 창에 표시되는 내용입니다. 일반적으로 창에는 파일에서 로드되거나 파일에 저장된 데이터가 표시됩니다. 따라서 문서의 이름은 파일의 이름입니다. 에서 가져온 CDocument::GetPathName문자열을 GetDocumentName 반환하는 기본 구현입니다.

창에 파일에서 로드되지 않은 문서가 표시되면 파생 클래스에서 이 메서드를 재정의하고 고유한 문서 식별자를 반환합니다.

GetDocumentName 는 열려 있는 모든 문서의 상태를 저장할 때 프레임워크에서 호출됩니다. 반환된 문자열은 레지스트리에 기록됩니다.

프레임워크가 나중에 상태를 복원하는 경우 문서 이름은 레지스트리에서 읽고 CMDIFrameWndEx::CreateDocumentWindow에 전달됩니다. CMDIFrameWndEx 파생 클래스에서 이 메서드를 재정의하고 이 이름을 가진 문서를 만들거나 열고 이 이름을 가진 파일에서 읽습니다. 문서가 파일을 기반으로 하지 않는 경우 문서 식별자 자체에 따라 문서를 만듭니다. 문서를 저장하고 복원하려는 경우에만 이전 작업을 수행해야 합니다.

예시

다음 예제에서는 GetDocumentName 메서드를 사용하는 방법을 보여 줍니다. 이 코드 조각은 VisualStudioDemo 샘플: MFC Visual Studio 애플리케이션에서 제공됩니다.

LPCTSTR CChildFrame::GetDocumentName(CObject **pObj)
{
   if (DYNAMIC_DOWNCAST(CStartView, GetActiveView()) != NULL)
   {
      return g_strStartViewName;
   }
   return CMDIChildWndEx::GetDocumentName(pObj);
}

CMDIChildWndEx::GetFrameIcon

MDI 자식 창의 아이콘을 검색하기 위해 프레임워크에서 호출됩니다.

virtual HICON GetFrameIcon() const;

Return Value

창 아이콘에 대한 핸들입니다.

설명

이 메서드는 MDI 자식 프레임 창이 포함된 MDI 탭에 표시할 아이콘을 결정하기 위해 프레임워크에서 호출됩니다.

기본적으로 이 메서드는 창 아이콘을 반환합니다. 파생 클래스에서 재정 GetFrameIcon 의 CMDIChildWndEx하여 이 동작을 사용자 지정합니다.

CMDIChildWndEx::GetFrameText

MDI 자식 창의 텍스트를 검색하기 위해 프레임워크에서 호출됩니다.

virtual CString GetFrameText() const;

Return Value

프레임 창 텍스트를 포함하는 문자열입니다.

설명

이 메서드는 MDI 자식 프레임 창이 포함된 MDI 탭에 표시할 텍스트를 결정하기 위해 프레임워크에서 호출됩니다.

기본적으로 이 메서드는 창 텍스트를 반환합니다. 파생 클래스에서 재정 GetFrameText 의 CMDIChildWndEx하여 이 동작을 사용자 지정합니다.

CMDIChildWndEx::GetPane

지정된 컨트롤 ID로 창을 찾습니다.

CBasePane* GetPane(UINT nID);

매개 변수

nID
[in] 찾을 창의 컨트롤 ID입니다.

Return Value

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

CMDIChildWndEx::GetRelatedTabGroup

CMFCTabCtrl* GetRelatedTabGroup();

Return Value

설명

CMDIChildWndEx::GetTabbedPane

MDI 탭 문서 그룹의 일부인 도킹 창에 대한 포인터를 반환합니다.

CDockablePane* GetTabbedPane() const;

Return Value

MDI 탭 문서 그룹의 일부인 도킹 창에 대한 포인터입니다.

CMDIChildWndEx::GetToolbarButtonToolTipText

도구 모음 단추에 대한 도구 설명을 검색하기 위해 프레임워크에서 호출됩니다.

virtual BOOL GetToolbarButtonToolTipText(
    CMFCToolBarButton*,
    CString&);

Return Value

도구 설명이 표시된 경우 TRUE입니다. 기본 구현은 FALSE를 반환합니다.

설명

도구 모음 단추에 대한 사용자 지정 도구 팁을 표시하려면 이 메서드를 재정의합니다.

CMDIChildWndEx::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입니다.

CMDIChildWndEx::IsPointNearDockSite

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

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

매개 변수

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

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

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

Return Value

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

설명

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

CMDIChildWndEx::IsReadOnly

자식 창에 표시되는 문서가 읽기 전용인지 여부를 지정합니다.

virtual BOOL IsReadOnly();

Return Value

문서가 읽기 전용이면 TRUE이고, 그렇지 않으면 FALSE입니다.

설명

이 함수는 읽기 전용 문서를 저장하는 것을 방지하는 데 사용됩니다.

예시

다음 예제에서는 메서드를 재정의하는 방법을 보여 줍니다 IsReadOnly . 이 코드 조각은 VisualStudioDemo 샘플: MFC Visual Studio 애플리케이션에서 제공됩니다.

BOOL CChildFrame::IsReadOnly()
{
   return DYNAMIC_DOWNCAST(CStartView, GetActiveView()) != NULL;
}

CMDIChildWndEx::IsTabbedPane

MDI 자식 창에 도킹 창이 포함되어 있는지 여부를 지정합니다.

BOOL IsTabbedPane() const;

Return Value

MDI 자식 창에 탭 문서로 변환된 도킹 창이 포함되어 있으면 TRUE이고, 그렇지 않으면 FALSE입니다.

CMDIChildWndEx::OnMoveMiniFrame

미니 프레임 창을 이동하기 위해 프레임워크에서 호출됩니다.

virtual BOOL OnMoveMiniFrame(CWnd* pFrame);

매개 변수

pFrame
[in] 미니 프레임 창에 대한 포인터입니다.

Return Value

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

CMDIChildWndEx::OnSetPreviewMode

인쇄 미리 보기 모드를 입력하거나 종료하기 위해 프레임워크에서 호출됩니다.

virtual void OnSetPreviewMode(
    BOOL bPreview,
    CPrintPreviewState* pState);

매개 변수

bPreview
[in] TRUE이면 인쇄 미리 보기 모드를 입력합니다. FALSE이면 인쇄 미리 보기 모드를 종료합니다.

pState
[in] 인쇄 미리 보기 상태 구조에 대한 포인터입니다.

CMDIChildWndEx::OnUpdateFrameTitle

프레임 제목을 업데이트하기 위해 프레임워크에서 호출됩니다.

virtual void OnUpdateFrameTitle(BOOL bAddToTitle);

매개 변수

bAddToTitle
[in] TRUE이면 제목에 문서 이름을 추가합니다.

CMDIChildWndEx::P aneFromPoint

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

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

CBasePane* PaneFromPoint(
    CPoint point,
    int nSensitivity,
    DWORD& dwAlignment,
    CRuntimeClass* pRTCBarType) const;

매개 변수

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

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

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

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

dwAlignment
[in] 지정된 지점에서 창을 찾을 경우 이 매개 변수에는 지정된 지점에 가장 가까운 창의 측면이 포함됩니다. 자세한 내용은 설명 섹션을 참조하세요.

Return Value

지정된 지점을 포함하는 파생 개체에 CBasePane대한 포인터이거나, 창을 찾을 수 없는 경우 NULL입니다.

설명

이 메서드를 호출하여 런타임 클래스 및 표시 유형과 같은 지정된 조건에 따라 창에 지정된 지점이 포함되어 있는지 여부를 확인합니다.

함수가 반환되고 창이 발견 되면 dwAlignment 에는 지정된 점의 맞춤이 포함됩니다. 예를 들어 점이 창 맨 위에 가장 가까운 경우 dwAlignment 는 CBRS_ALIGN_TOP 설정됩니다.

CMDIChildWndEx::RecalcLayout

창의 레이아웃을 다시 계산합니다.

virtual void RecalcLayout(BOOL bNotify = TRUE);

매개 변수

bNotify
[in] TRUE이면 창의 현재 위치 항목이 레이아웃 변경 알림을 받습니다.

CMDIChildWndEx::RemovePaneFromDockManager

도킹 관리자에서 창을 제거합니다.

void RemovePaneFromDockManager(
    CBasePane* pControlBar,
    BOOL bDestroy,
    BOOL bAdjustLayout,
    BOOL bAutoHide,
    CBasePane* pBarReplacement);

매개 변수

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

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

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

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

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

CMDIChildWndEx::SetRelatedTabGroup

void SetRelatedTabGroup(CMFCTabCtrl* p);

매개 변수

[in] p

설명

CMDIChildWndEx::ShowPane

void ShowPane(
    CBasePane* pBar,
    BOOL bShow,
    BOOL bDelay,
    BOOL bActivate);

매개 변수

[in] pBar

[in] bShow

[in] bDelay

[in] bActivate

설명

CMDIChildWndEx::UpdateTaskbarTabIcon

Windows 7 작업 표시줄 탭 아이콘을 업데이트합니다.

virtual void UpdateTaskbarTabIcon(HICON hIcon);

매개 변수

hIcon
Windows 7 작업 표시줄 탭에 표시할 아이콘에 대한 핸들입니다.

설명

CMDIChildWndEx::UnregisterTaskbarTab

Windows 7 작업 표시줄 탭에서 MDI 자식 항목을 제거합니다.

void UnregisterTaskbarTab(BOOL bCheckRegisteredMDIChildCount = TRUE);

매개 변수

bCheckRegisteredMDIChildCount
이 함수가 MDI 탭에 등록된 MDI 자식 수를 확인해야 하는지 여부를 지정합니다. 이 숫자가 0이면 이 함수는 애플리케이션의 작업 표시줄 축소판 그림에서 클리핑 사각형을 제거합니다.

설명

CMDIChildWndEx::SetTaskbarThumbnailClipRect

작업 표시줄에서 해당 창의 축소판 그림으로 표시할 창의 클라이언트 영역 일부를 선택하도록 클리핑 사각형을 설정하기 위해 프레임워크에서 호출합니다.

virtual BOOL SetTaskbarThumbnailClipRect(CRect rect);

매개 변수

rect
새 클리핑 사각형을 지정합니다. 사각형이 비어 있거나 null이면 클리핑이 제거됩니다.

Return Value

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

설명

CMDIChildWndEx::SetTaskbarTabProperties

Windows 7 작업 표시줄 탭에 대한 속성을 설정합니다.

void SetTaskbarTabProperties(DWORD dwFlags);

매개 변수

dwFlags
STPFLAG 값의 조합입니다. 자세한 내용은 ITaskbarList4::SetTabProperties를 참조 하세요.

설명

CMDIChildWndEx::SetTaskbarTabOrder

Windows 7 작업 표시줄 탭의 지정된 창 앞에 MDI 자식 항목을 삽입합니다.

void SetTaskbarTabOrder(CMDIChildWndEx* pWndBefore = NULL);

매개 변수

pWndBefore
왼쪽에 축소판 그림이 삽입된 MDI 자식 창에 대한 포인터입니다. 이 창은 이미 .를 통해 RegisterTaskbarTab등록되어 있어야 합니다. 이 값이 NULL이면 목록 끝에 새 축소판 그림이 추가됩니다.

설명

CMDIChildWndEx::SetTaskbarTabActive

해당 Windows 7 작업 표시줄 탭을 활성화합니다.

void SetTaskbarTabActive();

설명

CMDIChildWndEx::RegisterTaskbarTab

Windows 7 작업 표시줄 탭에 MDI 자식 등록

virtual void RegisterTaskbarTab(CMDIChildWndEx* pWndBefore = NULL);

매개 변수

pWndBefore
왼쪽에 축소판 그림이 삽입된 MDI 자식 창에 대한 포인터입니다. 이 창은 이미 .를 통해 RegisterTaskbarTab등록되어 있어야 합니다. 이 값이 NULL이면 목록 끝에 새 축소판 그림이 추가됩니다.

설명

CMDIChildWndEx::OnTaskbarTabThumbnailStretch

MDI 자식의 Windows 7 작업 표시줄 탭 미리 보기 미리 보기에 대한 비트맵을 확장해야 하는 경우 프레임워크에서 호출됩니다.

virtual BOOL OnTaskbarTabThumbnailStretch(
    HBITMAP hBmpDst,
    const CRect& rectDst,
    HBITMAP hBmpSrc,
    const CRect& rectSrc);

매개 변수

hBmpDst
대상 비트맵에 대한 핸들입니다.

rectDst
대상 사각형을 지정합니다.

hBmpSrc
원본 비트맵에 대한 핸들입니다.

rectSrc
원본 사각형을 지정합니다.

설명

요구 사항: afxmdichildwndex.h

CMDIChildWndEx::OnTaskbarTabThumbnailMouseActivate

작업 표시줄 탭 미리 보기에서 WM_MOUSEACTIVATE 메시지를 처리해야 하는 경우 프레임워크에서 호출됩니다.

virtual int OnTaskbarTabThumbnailMouseActivate(
    CWnd* pDesktopWnd,
    UINT nHitTest,
    UINT message);

매개 변수

pDesktopWnd
활성화되는 창의 최상위 부모 창에 대한 포인터를 지정합니다. 포인터는 일시적일 수 있으며 저장해서는 안 됩니다.

nHitTest
적중 테스트 영역 코드를 지정합니다. 적중 테스트는 커서의 위치를 결정하는 테스트입니다.

message
마우스 메시지 번호를 지정합니다.

설명

기본 구현은 관련 MDI 자식 프레임을 활성화합니다.

CMDIChildWndEx::OnTaskbarTabThumbnailActivate

작업 표시줄 탭 축소판 그림이 WM_ACTIVATE 메시지를 처리해야 하는 경우 프레임워크에서 호출됩니다.

virtual void OnTaskbarTabThumbnailActivate(
    UINT nState,
    CWnd* pWndOther,
    BOOL bMinimized);

매개 변수

nState
활성화되는지 비활성화되는지 여부를 CWnd 지정합니다.

pWndOther
CWnd 활성화되거나 비활성화되는 대상에 대한 포인터입니다. 포인터는 NULL일 수 있으며 일시적일 수 있습니다.

bMinimized
활성화되거나 비활성화되는 최소화된 상태를 CWnd 지정합니다. TRUE 값은 창이 최소화되었음을 나타냅니다.

설명

기본 구현은 관련 MDI 자식 프레임을 활성화합니다.

CMDIChildWndEx::OnPressTaskbarThmbnailCloseButton

사용자가 작업 표시줄 탭 축소판 그림에서 닫기 단추를 누를 때 프레임워크에서 호출됩니다.

virtual void OnPressTaskbarThmbnailCloseButton();

설명

CMDIChildWndEx::OnGetIconicThumbnail

MDI 자식의 상징적인 축소판 그림에 대한 비트맵을 가져와야 하는 경우 프레임워크에서 호출됩니다.

virtual HBITMAP OnGetIconicThumbnail(
    int nWidth,
    int nHeight);

매개 변수

nWidth
필요한 비트맵의 너비를 지정합니다.

nHeight
필요한 비트맵의 높이를 지정합니다.

설명

CMDIChildWndEx::OnGetIconicLivePreviewBitmap

MDI 자식의 라이브 미리 보기에 대한 비트맵을 가져와야 하는 경우 프레임워크에서 호출됩니다.

virtual HBITMAP OnGetIconicLivePreviewBitmap(
    BOOL bIsMDIChildActive,
    CPoint& ptLocation);

매개 변수

bIsMDIChildActive
현재 활성 상태이고 주 창이 최소화되지 않은 MDI 자식에 대해 비트맵이 요청된 경우 이 매개 변수는 TRUE입니다. 이 경우 기본 처리는 주 창의 스냅샷을 만듭니다.

ptLocation
주(최상위 수준) 창 클라이언트 좌표에서 비트맵의 위치를 지정합니다. 이 지점은 호출 수신자가 제공해야 합니다.

Return Value

처리된 경우 유효한 32bpp 비트맵에 대한 핸들을 반환하고, 그렇지 않으면 NULL을 반환합니다.

설명

파생 클래스에서 이 메서드를 재정의하고 MDI 자식의 라이브 미리 보기에 유효한 32bpp 비트맵을 반환합니다. 이 메서드는 MDI 자식이 Windows 7 작업 표시줄 탭에 표시되는 경우에만 호출됩니다. NULL을 반환하는 경우 MFC는 기본 처리기를 호출하고 사용 PrintClient 하거나 PrintWindow.

CMDIChildWndEx::m_dwDefaultTaskbarTabPropertyFlags

탭(MDI 자식)이 Windows 7 작업 표시줄 탭에 등록될 때 프레임워크 SetTaskbarTabProperties 에서 메서드에 전달하는 플래그의 조합입니다.

AFX_IMPORT_DATA static DWORD m_dwDefaultTaskbarTabPropertyFlags;

설명

기본 조합은 .입니다 STPF_USEAPPTHUMBNAILWHENACTIVE | STPF_USEAPPPEEKWHENACTIVE.

CMDIChildWndEx::IsTaskbarThumbnailClipRectEnabled

작업 표시줄에서 해당 창의 축소판 그림으로 표시할 창의 클라이언트 영역 일부를 자동으로 선택할 수 있는지 여부를 지정합니다.

BOOL IsTaskbarThumbnailClipRectEnabled() const;

Return Value

표시할 창의 클라이언트 영역 중 일부를 자동으로 선택할 수 있으면 TRUE를 반환합니다. 그렇지 않으면 FALSE입니다.

설명

CMDIChildWndEx::IsTaskbarTabsSupportEnabled

MDI 자식이 Windows 7 작업 표시줄 탭에 나타날 수 있는지 여부를 알려줍니다.

BOOL IsTaskbarTabsSupportEnabled();

Return Value

WINDOWS 7 작업 표시줄 탭에 MDI 자식이 표시되면 TRUE이고, Windows 7 작업 표시줄 탭에 MDI 자식이 표시될 수 없는 경우 FALSE입니다.

설명

CMDIChildWndEx::IsRegisteredWithTaskbarTabs

MDI 자식이 Windows 7 작업 표시줄 탭에 성공적으로 등록되면 TRUE를 반환합니다.

BOOL IsRegisteredWithTaskbarTabs();

Return Value

MDI 자식이 Windows 7 작업 표시줄 탭에 등록된 경우 TRUE입니다. 그렇지 않으면 FALSE입니다.

설명

CMDIChildWndEx::InvalidateIconicBitmaps

MDI 자식의 아이콘 비트맵 표현을 무효화합니다.

BOOL InvalidateIconicBitmaps();

Return Value

Windows 7 작업 표시줄 지원을 사용할 수 없거나 MDI 자식이 Windows 7 작업 표시줄 탭에 등록되지 않은 경우 FALSE를 반환합니다. 그렇지 않으면 TRUE를 반환합니다.

설명

MDI 자식의 라이브 콘텐츠 또는 크기가 변경된 경우 호출해야 합니다.

CMDIChildWndEx::GetTaskbarThumbnailClipRect

작업 표시줄에서 해당 창의 축소판 그림으로 표시할 창의 클라이언트 영역 일부를 선택해야 하는 경우 프레임워크에서 호출됩니다.

virtual CRect GetTaskbarThumbnailClipRect() const;

Return Value

창 좌표의 사각형입니다. 이 사각형은 최상위 프레임의 클라이언트 영역에 매핑됩니다. 클리핑 사각형을 지우려면 사각형이 비어 있어야 합니다.

설명

CMDIChildWndEx::GetTaskbarPreviewWnd

Windows 7 작업 표시줄 탭 미리 보기에 표시할 자식 창(일반적으로 보기 또는 분할자 창)을 가져와야 하는 경우 프레임워크에서 호출됩니다.

virtual CWnd* GetTaskbarPreviewWnd();

Return Value

이 MDI 자식과 관련된 Windows 7 작업 표시줄 탭에 미리 보기를 표시해야 하는 개체에 대한 유효한 포인터 CWnd 를 반환해야 합니다. 기본 구현은 AFX_IDW_PANE_FIRST 컨트롤 ID(일반적으로 -derived 클래스)를 사용하여 CView이 MDI 자식의 자식 창을 반환합니다.

설명

CMDIChildWndEx::GetTabProxyWnd

Windows 7 작업 표시줄 탭에 등록된 탭 프록시 창을 반환합니다.

CMDITabProxyWnd* GetTabProxyWnd();

Return Value

Windows 7 작업 표시줄 탭에 등록된 개체에 대한 포인터 CMDITabProxyWnd 입니다.

설명

CMDIChildWndEx::EnableTaskbarThumbnailClipRect

작업 표시줄에서 창의 축소판 그림으로 표시할 창의 클라이언트 영역 일부를 자동으로 선택하거나 사용하지 않도록 설정합니다.

void EnableTaskbarThumbnailClipRect(BOOL bEnable = TRUE);

매개 변수

bEnable
표시할 창의 클라이언트 영역 부분에 대한 자동 선택을 사용하도록 설정할지(TRUE) 또는 사용하지 않도록 설정할지(FALSE) 여부를 지정합니다.

설명

CMDIChildWndEx::CanShowOnTaskBarTabs

이 MDI 자식이 Windows 7 작업 표시줄 탭에 표시될 수 있는지 여부를 프레임워크에 알립니다.

virtual BOOL CanShowOnTaskBarTabs();

Return Value

TRUE이면 MDI 자식의 콘텐츠를 Windows 7 작업 표시줄 미리 보기에 표시할 수 있습니다.

설명

파생 클래스에서 이 메서드를 재정의하고 FALSE를 반환하여 Windows 7 작업 표시줄 탭에서 이 MDI 자식의 모양을 사용하지 않도록 설정합니다.

CMDIChildWndEx::ActivateTopLevelFrame

애플리케이션이 작업 표시줄 탭에서 활성화될 때 최상위 프레임을 활성화하기 위해 프레임워크에서 호출됩니다.

virtual void ActivateTopLevelFrame();

설명

참고 항목

계층 구조 차트
클래스
CMDIChildWnd 클래스
CMFCWindowsManagerDialog 클래스
CMDIFrameWndEx 클래스