`CFrameWndEx` 수업

아티클
10/12/2023

겹쳐진 Windows SDI(단일 문서 인터페이스) 또는 팝업 프레임 창의 기능을 구현하고 창 관리를 위한 멤버를 제공합니다. 클래스를 CFrameWnd 확장합니다.

구문

class CFrameWndEx : public CFrameWnd

멤버

공용 메서드

이름	설명
`CFrameWndEx::ActiveItemRecalcLayout`	OLE 클라이언트 항목의 레이아웃과 프레임의 클라이언트 영역을 조정합니다.
`CFrameWndEx::AddDockSite`	이 메서드는 사용되지 않습니다.
`CFrameWndEx::AddPane`	도킹 관리자에 컨트롤 바를 등록합니다.
`CFrameWndEx::AdjustDockingLayout`	프레임 창에 도킹된 모든 창의 레이아웃을 다시 계산합니다.
`CFrameWndEx::DelayUpdateFrameMenu`	프레임 메뉴를 설정한 다음 명령 처리가 유휴 상태일 때 업데이트합니다.
`CFrameWndEx::DockPane`	지정된 창을 프레임 창에 도킹합니다.
`CFrameWndEx::DockPaneLeftOf`	창을 다른 창의 왼쪽에 도킹합니다.
`CFrameWndEx::EnableAutoHidePanes`	기본 프레임 창의 지정된 면에 도킹될 때 창에 대한 자동 숨기기 모드를 사용하도록 설정합니다.
`CFrameWndEx::EnableDocking`	프레임 창에 속하는 창의 도킹을 사용하도록 설정합니다.
`CFrameWndEx::EnableFullScreenMainMenu`	주 메뉴를 전체 화면 모드로 표시하거나 숨깁니다.
`CFrameWndEx::EnableFullScreenMode`	프레임 창에 대한 전체 화면 모드를 사용하도록 설정합니다.
`CFrameWndEx::EnableLoadDockState`	도킹 상태의 로드를 사용하거나 사용하지 않도록 설정합니다.
`CFrameWndEx::EnablePaneMenu`	창 메뉴의 자동 처리를 사용하거나 사용하지 않도록 설정합니다.
`CFrameWndEx::GetActivePopup`	현재 표시된 팝업 메뉴에 대한 포인터를 반환합니다.
`CFrameWndEx::GetDefaultResId`	프레임워크에서 프레임 창을 로드할 때 지정한 리소스 ID를 반환합니다.
`CFrameWndEx::GetDockingManager`	프레임 창의 `CDockingManager` Class 개체를 검색합니다.
`CFrameWndEx::GetMenuBar`	프레임 창에 연결된 메뉴 모음 개체에 대한 포인터를 반환합니다.
`CFrameWndEx::GetPane`	지정된 ID가 있는 창에 대한 포인터를 반환합니다.
`CFrameWndEx::GetRibbonBar`	프레임의 리본 표시줄 컨트롤을 검색합니다.
`CFrameWndEx::GetTearOffBars`	분리 상태에 있는 창 개체의 목록을 반환합니다.
`CFrameWndEx::GetToolbarButtonToolTipText`	애플리케이션이 도구 모음 단추에 대한 도구 설명을 표시할 때 프레임워크에서 호출됩니다.
`CFrameWndEx::InsertPane`	도킹 관리자에 창을 등록합니다.
`CFrameWndEx::IsFullScreen`	프레임 창이 전체 화면 모드인지 여부를 확인합니다.
`CFrameWndEx::IsMenuBarAvailable`	메뉴 모음 개체에 대한 포인터가 유효한지 여부를 확인합니다.
`CFrameWndEx::IsPointNearDockSite`	점이 맞춤 영역에 있는지 여부를 나타냅니다.
`CFrameWndEx::IsPrintPreview`	프레임 창이 인쇄 미리 보기 모드인지 여부를 나타냅니다.
`CFrameWndEx::LoadFrame`	이 메서드는 생성 후 프레임 창을 만들고 해당 리소스를 로드하기 위해 호출됩니다.
`CFrameWndEx::NegotiateBorderSpace`	OLE 클라이언트 테두리 협상을 구현합니다.
`CFrameWndEx::OnActivate`	프레임에서 사용자 입력을 전환하거나 프레임에서 멀어지면 프레임워크에서 이 메서드를 호출합니다.
`CFrameWndEx::OnActivateApp`	애플리케이션을 선택하거나 선택 취소할 때 프레임워크에서 호출됩니다.
`CFrameWndEx::OnChangeVisualManager`	프레임을 변경하려면 시각적 관리자를 변경해야 하는 경우 프레임워크에서 호출됩니다.
`CFrameWndEx::OnClose`	프레임워크는 이 메서드를 호출하여 프레임을 닫습니다.
`CFrameWndEx::OnCloseDockingPane`	사용자가 도킹 창에서 닫기 단추를 클릭할 때 프레임워크에서 호출됩니다.
`CFrameWndEx::OnCloseMiniFrame`	사용자가 부동 미니 프레임 창에서 닫기 단추를 클릭할 때 프레임워크에서 호출됩니다.
`CFrameWndEx::OnClosePopupMenu`	활성 팝업 메뉴가 메시지를 처리할 때 프레임워크에서 호출됩니다 `WM_DESTROY` .
`CFrameWndEx::OnCmdMsg`	명령 메시지를 디스패치합니다.
`CFrameWndEx::OnContextHelp`	컨텍스트 관련 도움말을 표시하기 위해 프레임워크에서 호출됩니다.
`CFrameWndEx::OnCreate`	프레임을 만든 후 프레임워크에서 호출됩니다.
`CFrameWndEx::OnDestroy`	프레임이 제거될 때 프레임워크에서 호출됩니다.
`CFrameWndEx::OnDrawMenuImage`	애플리케이션이 메뉴 항목과 연결된 이미지를 그릴 때 프레임워크에서 호출됩니다.
`CFrameWndEx::OnDrawMenuLogo`	개체가 메시지를 처리할 때 프레임워크에서 `CMFCPopupMenu` 호출됩니다 `WM_PAINT` .
`CFrameWndEx::OnDWMCompositionChanged`	DWM(데스크톱 창 관리자) 컴퍼지션을 사용하거나 사용하지 않도록 설정한 경우 프레임워크에서 호출됩니다.
`CFrameWndEx::OnExitSizeMove`	프레임이 이동 또는 크기 조정을 중지할 때 프레임워크에서 호출됩니다.
`CFrameWndEx::OnGetMinMaxInfo`	프레임 크기를 조정하여 창 차원 제한을 설정할 때 프레임워크에서 호출됩니다.
`CFrameWndEx::OnIdleUpdateCmdUI`	명령 처리가 유휴 상태일 때 프레임 표시를 업데이트하기 위해 프레임워크에서 호출됩니다.
`CFrameWndEx::OnLButtonDown`	프레임워크는 사용자가 마우스 왼쪽 단추를 누를 때 이 메서드를 호출합니다.
`CFrameWndEx::OnLButtonUp`	프레임워크는 사용자가 마우스 왼쪽 단추를 놓을 때 이 메서드를 호출합니다.
`CFrameWndEx::OnMenuButtonToolHitTest`	개체가 메시지를 처리할 때 프레임워크에서 `CMFCToolBarButton` 호출됩니다 `WM_NCHITTEST` .
`CFrameWndEx::OnMenuChar`	메뉴가 표시되고 사용자가 명령에 해당하지 않는 키를 누르면 프레임워크에서 호출됩니다.
`CFrameWndEx::OnMouseMove`	프레임워크는 포인터가 이동할 때 이 메서드를 호출합니다.
`CFrameWndEx::OnMoveMiniFrame`	창 창이 이동할 때 프레임워크에서 호출됩니다.
`CFrameWndEx::OnNcActivate`	프레임의 클라이언트가 아닌 영역을 다시 그려 활성 상태의 변화를 나타내야 하는 경우 프레임워크에서 호출됩니다.
`CFrameWndEx::OnNcCalcSize`	클라이언트 영역의 크기와 위치를 계산해야 하는 경우 프레임워크에서 호출됩니다.
`CFrameWndEx::OnNcHitTest`	포인터가 이동하거나 마우스 단추를 누르거나 놓을 때 프레임워크에서 호출됩니다.
`CFrameWndEx::OnNcMouseMove`	비 클라이언트 영역에서 포인터가 이동할 때 프레임워크에서 호출됩니다.
`CFrameWndEx::OnNcPaint`	비 클라이언트 영역을 그려야 하는 경우 프레임워크에서 호출됩니다.
`CFrameWndEx::OnPaneCheck`	틀의 표시 유형을 제어하기 위해 프레임워크에서 호출됩니다.
`CFrameWndEx::OnPostPreviewFrame`	사용자가 인쇄 미리 보기 모드를 변경한 경우 프레임워크에서 호출됩니다.
`CFrameWndEx::OnPowerBroadcast`	전원 관리 이벤트가 발생할 때 프레임워크에서 호출됩니다.
`CFrameWndEx::OnSetMenu`	프레임 창 메뉴를 바꾸기 위해 프레임워크에서 호출됩니다.
`CFrameWndEx::OnSetPreviewMode`	프레임의 인쇄 미리 보기 모드를 설정하기 위해 프레임워크에서 호출됩니다.
`CFrameWndEx::OnSetText`	창의 텍스트를 설정하기 위해 프레임워크에서 호출됩니다.
`CFrameWndEx::OnShowCustomizePane`	빠른 사용자 지정 창을 사용하도록 설정하면 프레임워크에서 호출됩니다.
`CFrameWndEx::OnShowPanes`	틀을 표시하거나 숨기기 위해 프레임워크에서 호출됩니다.
`CFrameWndEx::OnShowPopupMenu`	팝업 메뉴를 사용할 때 프레임워크에서 호출됩니다.
`CFrameWndEx::OnSize`	프레임워크는 프레임의 크기가 변경된 후 이 메서드를 호출합니다.
`CFrameWndEx::OnSizing`	프레임워크는 사용자가 프레임 크기를 조정할 때 이 메서드를 호출합니다.
`CFrameWndEx::OnSysColorChange`	시스템 색이 변경되면 프레임워크에서 호출됩니다.
`CFrameWndEx::OnTearOffMenu`	분리 막대가 있는 메뉴를 사용하도록 설정하면 프레임워크에서 호출됩니다.
`CFrameWndEx::OnToolbarContextMenu`	프레임워크에서 도구 모음 상황에 맞는 메뉴를 빌드하기 위해 호출됩니다.
`CFrameWndEx::OnToolbarCreateNew`	프레임워크는 이 메서드를 호출하여 새 도구 모음을 만듭니다.
`CFrameWndEx::OnToolbarDelete`	도구 모음이 삭제될 때 프레임워크에서 호출됩니다.
`CFrameWndEx::OnUpdateFrameMenu`	프레임 메뉴를 설정하기 위해 프레임워크에서 호출됩니다.
`CFrameWndEx::OnUpdateFrameTitle`	프레임워크는 이 메서드를 호출하여 프레임 창의 제목 표시줄을 업데이트합니다.
`CFrameWndEx::OnUpdatePaneMenu`	프레임워크에서 창 메뉴를 업데이트하기 위해 호출됩니다.
`CFrameWndEx::OnWindowPosChanged`	창 관리 메서드 호출로 인해 프레임 크기, 위치 또는 z 순서가 변경된 경우 프레임워크에서 호출됩니다.
`CFrameWndEx::PaneFromPoint`	지정한 점을 포함하는 도킹 창을 반환합니다.
`CFrameWndEx::PreTranslateMessage`	특정 창 메시지가 디스패치되기 전에 처리합니다.
`CFrameWndEx::RecalcLayout`	프레임 및 해당 자식 창의 레이아웃을 조정합니다.
`CFrameWndEx::RemovePaneFromDockManager`	창을 등록 취소하고 도킹 관리자의 내부 목록에서 제거합니다.
`CFrameWndEx::SetDockState`	도킹 레이아웃을 레지스트리에 저장된 도킹 상태로 복원합니다.
`CFrameWndEx::SetPrintPreviewFrame`	인쇄 미리 보기 프레임 창을 설정합니다.
`CFrameWndEx::SetupToolbarMenu`	도구 모음 메뉴에 사용자 정의 명령을 삽입합니다.
`CFrameWndEx::ShowFullScreen`	기본 프레임을 전체 화면과 일반 모드 간에 전환합니다.
`CFrameWndEx::ShowPane`	지정된 창을 표시하거나 숨깁니다.
`CFrameWndEx::UpdateCaption`	프레임워크에서 창 프레임 캡션을 업데이트하기 위해 호출됩니다.
`CFrameWndEx::WinHelp`	애플리케이션 또는 컨텍스트 관련 도움말을 `WinHelp` 호출합니다.

예시

다음 예제에서는 클래스에서 클래스를 상속 하는 방법을 보여 줍니다 CFrameWndEx . 이 예제에서는 서브클래스의 메서드 시그니처와 메서드를 재정의 OnShowPopupMenu 하는 방법을 보여 줍니다. 이 코드 조각은 워드 패드 샘플의 일부입니다.

class CMainFrame : public CFrameWndEx
{
protected: // create from serialization only
   CMainFrame();
   DECLARE_DYNCREATE(CMainFrame)

   // Attributes
public:
   HICON m_hIconDoc;
   HICON m_hIconText;
   HICON m_hIconWrite;
   HICON GetIcon(int nDocType);

   // Operations
public:
   void UpdateMRUFilesList()
   {
      m_wndTaskPane.UpdateMRUFilesList();
   }

   void OnChangeLook();

   // Overrides
   // ClassWizard generated virtual function overrides
   //{{AFX_VIRTUAL(CMainFrame)
public:
   virtual void ActivateFrame(int nCmdShow = -1);
   virtual BOOL LoadFrame(UINT nIDResource,
                          DWORD dwDefaultStyle = WS_OVERLAPPEDWINDOW | FWS_ADDTOTITLE,
                          CWnd *pParentWnd = NULL,
                          CCreateContext *pContext = NULL);

protected:
   virtual BOOL PreCreateWindow(CREATESTRUCT &cs);
   virtual BOOL OnCommand(WPARAM wParam, LPARAM lParam);
   //}}AFX_VIRTUAL

   virtual BOOL OnShowPopupMenu(CMFCPopupMenu *pMenuPopup);
   virtual BOOL OnTearOffMenu(CMFCPopupMenu *pMenuPopup, CPane *pBar);

protected:
   void AdjustObjectSubmenu(CMFCPopupMenu *pMenuPopup);
   void AdjustColorsMenu(CMFCPopupMenu *pMenuPopup, UINT uiId);

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

public:
   CMFCMenuBar m_wndMenuBar;
   CMFCToolBar m_wndToolBar;
   CMFCStatusBar m_wndStatusBar;
   CFormatBar m_wndFormatBar;
   CRulerBar m_wndRulerBar;
   CTaskPane m_wndTaskPane;

protected: // control bar embedded members
   BOOL CreateMenuBar();
   BOOL CreateToolBar();
   BOOL CreateFormatBar();
   BOOL CreateStatusBar();
   BOOL CreateRulerBar();
   BOOL CreateTaskPane();

   // Generated message map functions
protected:
   //{{AFX_MSG(CMainFrame)
   afx_msg int OnCreate(LPCREATESTRUCT lpCreateStruct);
   afx_msg void OnSysColorChange();
   afx_msg void OnSize(UINT nType, int cx, int cy);
   afx_msg void OnMove(int x, int y);
   afx_msg void OnHelpFinder();
   afx_msg void OnDropFiles(HDROP hDropInfo);
   afx_msg void OnFontChange();
   afx_msg BOOL OnQueryNewPalette();
   afx_msg void OnPaletteChanged(CWnd *pFocusWnd);
   afx_msg void OnDevModeChange(LPTSTR lpDeviceName);
   afx_msg void OnViewCustomize();
   afx_msg void OnViewFullScreen();
   //}}AFX_MSG
   afx_msg LRESULT OnBarState(WPARAM wParam, LPARAM lParam);
   afx_msg LRESULT OnOpenMsg(WPARAM wParam, LPARAM lParam);
   afx_msg LRESULT OnHelpCustomizeToolbars(WPARAM wp, LPARAM lp);
   afx_msg LRESULT OnStartCustomize(WPARAM wp, LPARAM lp);
   afx_msg LRESULT OnToolbarCreateNew(WPARAM, LPARAM);
   afx_msg LRESULT OnGetDocumentColors(WPARAM, LPARAM);
   afx_msg void OnDummy();
   afx_msg void OnAskQuestion();
   DECLARE_MESSAGE_MAP()
};

// CMainFrame is application-defined object of type CFrameWndEx
BOOL CMainFrame::OnShowPopupMenu(CMFCPopupMenu *pMenuPopup)
{
   BOOL bRes = CFrameWndEx::OnShowPopupMenu(pMenuPopup);

   if (pMenuPopup != NULL && !pMenuPopup->IsCustomizePane())
   {
      AdjustObjectSubmenu(pMenuPopup);
      AdjustColorsMenu(pMenuPopup, ID_CHAR_COLOR);
   }

   return bRes;
}

상속 계층 구조

요구 사항

머리글: afxframewndex.h

`CFrameWndEx::ActiveItemRecalcLayout`

OLE 클라이언트 항목의 레이아웃과 프레임의 클라이언트 영역을 조정합니다.

void ActiveItemRecalcLayout();

설명

`CFrameWndEx::AddPane`

도킹 관리자에 컨트롤 바를 등록합니다.

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

매개 변수

pControlBar
[in] 등록할 컨트롤 막대 창입니다.

bTail
[in] TRUE 목록의 끝에 컨트롤 막대 창을 추가하려면 이고, FALSE 그렇지 않으면.

Return Value

TRUE 컨트롤 막대가 성공적으로 등록되었으면 FALSE 그렇지 않으면.

`CFrameWndEx::AdjustDockingLayout`

프레임 창에 도킹된 모든 창의 레이아웃을 다시 계산합니다.

virtual void AdjustDockingLayout(HDWP hdwp=NULL);

매개 변수

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

설명

hdwp 구조는 메서드에 의해 초기화됩니다 BeginDeferWindowPos .

`CFrameWndEx::DelayUpdateFrameMenu`

프레임 메뉴를 설정한 다음 명령 처리가 유휴 상태일 때 업데이트합니다.

virtual void DelayUpdateFrameMenu(HMENU hMenuAlt);

매개 변수

hMenuAlt
[in] 대체 메뉴에 대한 핸들입니다.

설명

`CFrameWndEx::DockPane`

지정된 창을 프레임 창에 도킹합니다.

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

매개 변수

pBar
[in] 도킹할 컨트롤 막대에 대한 포인터입니다.

nDockBarID
[in] 도킹할 프레임 창 측면의 ID입니다.

lpRect
[in] 창의 화면 위치와 크기를 지정하는 상수 Rect 구조체에 대한 포인터입니다.

설명

매개 변수는 nDockBarID 다음 값 중 하나를 가질 수 있습니다.

AFX_IDW_DOCKBAR_TOP
AFX_IDW_DOCKBAR_BOTTOM
AFX_IDW_DOCKBAR_LEFT
AFX_IDW_DOCKBAR_RIGHT

`CFrameWndEx::DockPaneLeftOf`

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

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

매개 변수

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

pLeftOf
[in] 지정한 창을 도킹할 왼쪽 창 pBar에 대한 포인터입니다.

Return Value

TRUE 도킹이 성공적으로 완료되면 pBar 입니다. 그렇지 않으면 FALSE입니다.

설명

메서드는 매개 변수로 지정된 도구 모음을 pBar 가져와서 매개 변수로 지정된 도구 모음의 왼쪽에 pLeftOf 도킹합니다.

`CFrameWndEx::EnableAutoHidePanes`

기본 프레임 창의 지정된 면에 도킹된 경우 창에 자동 숨기기 모드를 사용하도록 설정합니다.

BOOL EnableAutoHidePanes(DWORD dwDockStyle);

매개 변수

dwDockStyle
[in] 창을 도킹할 주 프레임 창의 측면을 지정합니다.

Return Value

TRUE가로 막대 창이 지정된 프레임 창 쪽 dwDockStyleFALSE 에 성공적으로 도킹되면 그렇지 않습니다.

설명

dwDockStyle 는 다음 값 중 하나를 가질 수 있습니다.

CBRS_ALIGN_TOP: 컨트롤 막대를 프레임 창의 클라이언트 영역 맨 위에 도킹할 수 있습니다.
CBRS_ALIGN_BOTTOM: 컨트롤 막대를 프레임 창의 클라이언트 영역 아래쪽에 도킹할 수 있습니다.
CBRS_ALIGN_LEFT: 컨트롤 막대를 프레임 창의 클라이언트 영역 왼쪽에 도킹할 수 있습니다.
CBRS_ALIGN_RIGHT: 컨트롤 막대를 프레임 창의 클라이언트 영역 오른쪽에 도킹할 수 있습니다.

`CFrameWndEx::EnableDocking`

프레임 창의 도킹을 사용하도록 설정합니다.

BOOL EnableDocking(DWORD dwDockStyle);

매개 변수

dwDockStyle
[in] 창 막대가 도킹되는 주 프레임 창의 측면을 지정합니다.

Return Value

TRUE 막대 창이 지정된 쪽에 성공적으로 도킹될 수 있으면 입니다. 그렇지 않으면 FALSE입니다.

설명

매개 변수는 dwDockStyle 다음 값 중 하나를 가질 수 있습니다.

CBRS_ALIGN_TOP
CBRS_ALIGN_BOTTOM
CBRS_ALIGN_LEFT
CBRS_ALIGN_RIGHT

`CFrameWndEx::EnableFullScreenMainMenu`

주 메뉴를 전체 화면 모드로 표시하거나 숨깁니다.

void EnableFullScreenMainMenu(BOOL bEnableMenu);

매개 변수

bEnableMenu
[in] TRUE 기본 메뉴를 전체 화면 모드 FALSE 로 표시하려면 그렇지 않습니다.

`CFrameWndEx::EnableFullScreenMode`

프레임 창에 전체 화면 모드를 사용하도록 설정합니다.

void EnableFullScreenMode(UINT uiFullScreenCmd);

매개 변수

uiFullScreenCmd
[in] 전체 화면 모드를 사용하거나 사용하지 않도록 설정하는 명령의 ID입니다.

설명

전체 화면 모드에서는 모든 도킹 컨트롤 막대, 도구 모음 및 메뉴가 숨겨지고 활성 보기의 크기가 전체 화면을 차지하도록 조정됩니다.

전체 화면 모드를 사용하도록 설정하는 경우 전체 화면 모드를 사용하거나 사용하지 않도록 설정하는 명령의 ID를 지정해야 합니다. 주 프레임의 OnCreate 함수에서 호출 EnableFullScreenMode 할 수 있습니다. 프레임 창이 전체 화면 모드로 전환되는 경우 프레임워크는 지정된 명령 ID가 있는 하나의 단추가 있는 부동 도구 모음을 만듭니다.

화면에 주 메뉴를 유지하려면 다음을 호출합니다 CFrameWndEx::EnableFullScreenMainMenu.

`CFrameWndEx::EnableLoadDockState`

도킹 상태의 로드를 사용하거나 사용하지 않도록 설정합니다.

void EnableLoadDockState(BOOL bEnable=TRUE);

매개 변수

bEnable
[in] TRUE 도킹 상태의 로드를 사용하도록 설정하려면 도킹 상태 FALSE 의 로드를 사용하지 않도록 설정합니다.

`CFrameWndEx::EnablePaneMenu`

창 메뉴의 자동 처리를 사용하거나 사용하지 않도록 설정합니다.

void EnablePaneMenu(
    BOOL bEnable,
    UINT uiCustomizeCmd,
    const CString& strCustomizeLabel,
    UINT uiViewToolbarsMenuEntryID,
    BOOL bContextMenuShowsToolbarsOnly=FALSE,
    BOOL bViewMenuShowsToolbarsOnly=FALSE);

매개 변수

bEnable
[in] TRUE 컨트롤 막대 팝업 메뉴의 자동 처리를 사용하도록 설정하려면 FALSE 컨트롤 막대 팝업 메뉴의 자동 처리를 사용하지 않도록 설정합니다.

uiCustomizeCmd
[in] 사용자 지정 메뉴 항목의 명령 ID입니다.

strCustomizeLabel
[in] 사용자 지정 메뉴 항목에 대해 표시할 레이블입니다.

uiViewToolbarsMenuEntryID
[in] 컨트롤 막대에서 팝업 메뉴를 여는 도구 모음 메뉴 항목의 ID입니다.

bContextMenuShowsToolbarsOnly
[in] 이 경우 TRUE컨트롤 막대 상황에 맞는 메뉴에 도구 모음 목록만 표시됩니다. 이 경우 FALSE메뉴에 도구 모음 및 도킹 막대 목록이 표시됩니다.

bViewMenuShowsToolbarsOnly
[in] 이 경우 TRUE컨트롤 바 메뉴에 도구 모음 목록만 표시됩니다. 이 경우 FALSE메뉴에 도구 모음 및 도킹 막대 목록이 표시됩니다.

`CFrameWndEx::GetActivePopup`

현재 표시된 팝업 메뉴에 대한 포인터를 반환합니다.

CMFCPopupMenu* GetActivePopup() const;

Return Value

현재 표시된 팝업 메뉴에 대한 포인터입니다. 그렇지 않으면 NULL.

`CFrameWndEx::GetDefaultResId`

프레임워크에서 프레임 창을 로드할 때 지정한 리소스 ID를 반환합니다.

UINT GetDefaultResId() const;

Return Value

프레임워크가 프레임 창을 로드할 때 사용자가 지정한 리소스 ID 값입니다. 프레임 창에 메뉴 모음이 없으면 0입니다.

`CFrameWndEx::GetDockingManager`

프레임 창의 CDockingManager Class 개체를 검색합니다.

CDockingManager* GetDockingManager();

Return Value

클래스에 대한 CDockingManager 포인터입니다.

설명

프레임 창에서 클래스 개체를 CDockingManager 만들고 사용하여 자식 창 도킹을 관리합니다.

`CFrameWndEx::GetMenuBar`

프레임 창에 연결된 메뉴 모음 개체에 대한 포인터를 반환합니다.

const CMFCMenuBar* GetMenuBar() const;

Return Value

프레임 창에 연결된 메뉴 모음 개체에 대한 포인터입니다.

`CFrameWndEx::GetPane`

지정된 ID가 있는 창에 대한 포인터를 반환합니다.

CBasePane* GetPane(UINT nID);

매개 변수

nID
[in] 컨트롤 ID입니다.

Return Value

지정된 ID가 있는 창에 대한 포인터입니다. NULL 이러한 창이 없으면 입니다.

`CFrameWndEx::GetRibbonBar`

프레임의 리본 표시줄 컨트롤을 검색합니다.

CMFCRibbonBar* GetRibbonBar();

Return Value

프레임의 CMFCRibbonBar 클래스 에 대한 포인터입니다.

설명

`CFrameWndEx::GetTearOffBars`

분리 상태에 있는 창 개체의 목록을 반환합니다.

const CObList& GetTearOffBars() const;

Return Value

분리 상태에 있는 창 개체에 대한 포인터 컬렉션이 들어 있는 개체에 대한 참조 CObList 입니다.

`CFrameWndEx::GetToolbarButtonToolTipText`

애플리케이션이 도구 모음 단추에 대한 도구 설명을 표시할 때 프레임워크에서 호출됩니다.

virtual BOOL GetToolbarButtonToolTipText(
    CMFCToolBarButton* pButton,
    CString& strTTText);

매개 변수

pButton
[in] 도구 모음 단추에 대한 포인터입니다.

strTTText
[in] 단추에 대해 표시할 도구 설명 텍스트입니다.

Return Value

TRUE 도구 설명이 표시되었으면 입니다. 그렇지 않으면 FALSE입니다.

설명

기본적으로 이 메서드는 아무것도 수행하지 않습니다. 도구 모음 단추에 대한 도구 설명을 표시하려면 이 메서드를 재정의합니다.

`CFrameWndEx::InsertPane`

컨트롤 막대 목록에 창을 삽입하고 도킹 관리자에 등록합니다.

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

매개 변수

pControlBar
컨트롤 막대 목록에 삽입하고 도킹 관리자에 등록할 컨트롤 막대에 대한 포인터입니다.

pTarget
앞이나 뒤에 창을 삽입할 컨트롤 막대에 대한 포인터입니다.

bAfter
TRUE뒤에 pTarget삽입하려면 이고, FALSE 그렇지 않으면 삽입 pControlBar 합니다.

Return Value

TRUE 컨트롤 막대가 성공적으로 삽입되고 등록되었 FALSE 으면 그렇지 않습니다.

설명

도킹 레이아웃에 참여하려면 클래스를 CDockingManager 사용하여 각 컨트롤 막대를 등록해야 합니다.

`CFrameWndEx::IsFullScreen`

프레임 창이 전체 화면 모드인지 여부를 확인합니다.

BOOL IsFullScreen() const;

Return Value

TRUE 프레임 창이 전체 화면 모드인 경우 그렇지 않으면 FALSE.

설명

메서드를 호출하여 전체 화면 모드를 CFrameWndEx::EnableFullScreenMode 설정할 수 있습니다.

`CFrameWndEx::IsMenuBarAvailable`

메뉴 모음 개체에 대한 포인터가 유효한지 여부를 확인합니다.

BOOL IsMenuBarAvailable() const;

Return Value

TRUE 프레임 창에 메뉴 모음이 있는 경우 그렇지 않으면 FALSE.

`CFrameWndEx::IsPointNearDockSite`

점이 맞춤 영역에 있는지 여부를 결정합니다.

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

매개 변수

point
[in] 점의 위치입니다.

dwBarAlignment
[out] 점이 정렬되는 위치입니다. 가능한 값은 설명 섹션의 표를 참조하세요.

bOuterEdge
[out] TRUE 점이 프레임 테두리 가까이에 있으면 FALSE 지점이 클라이언트 영역에 있으면 입니다.

Return Value

TRUE점이 맞춤 영역에 있으면 이고, 그렇지 않으면 . FALSE

설명

다음 표에서는 매개 변수에 사용할 수 있는 값을 나열합니다 dwBarAlignment .

값	설명
`CBRS_ALIGN_TOP`	위쪽에 맞춰 정렬됩니다.
`CBRS_ALIGN_RIGHT`	오른쪽에 맞춰 정렬됩니다.
`CBRS_ALIGN_BOTTOM`	아래쪽에 맞춰 정렬됩니다.
`CBRS_ALIGN_LEFT`	왼쪽에 맞춰 정렬됩니다.

`CFrameWndEx::IsPrintPreview`

프레임 창이 인쇄 미리 보기 모드인지 여부를 확인합니다.

BOOL IsPrintPreview();

Return Value

TRUE프레임 창이 인쇄 미리 보기 모드인 경우 그렇지 않으면 . FALSE

설명

`CFrameWndEx::LoadFrame`

이 메서드는 생성 후 프레임 창을 만들고 해당 리소스를 로드하기 위해 호출됩니다.

virtual BOOL LoadFrame(
    UINT nIDResource,
    DWORD dwDefaultStyle = WS_OVERLAPPEDWINDOW | FWS_ADDTOTITLE,
    CWnd* pParentWnd = NULL,
    CCreateContext* pContext = NULL);

매개 변수

nIDResource
[in] 모든 프레임 리소스를 로드하는 데 사용되는 리소스 ID입니다.

dwDefaultStyle
[in] 기본 프레임 창 스타일입니다.

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

pContext
[in] 애플리케이션을 CCreateContext 만드는 동안 프레임워크에서 사용하는 Structure 클래스에 대한 포인터입니다.

Return Value

메서드가 성공했으면 TRUE이고, 실패했으면 FALSE입니다.

설명

`CFrameWndEx::NegotiateBorderSpace`

OLE 클라이언트 테두리 협상을 구현합니다.

virtual BOOL NegotiateBorderSpace(
    UINT nBorderCmd,
    LPRECT lpRectBorder);

매개 변수

nBorderCmd
[in] 테두리 협상 명령입니다. 가능한 값은 설명 섹션을 참조하세요.

lpRectBorder
[in, out] 테두리의 차원입니다.

Return Value

TRUE레이아웃을 다시 계산해야 하는 경우 그렇지 않으면 . FALSE

설명

다음 표에서는 매개 변수에 사용할 수 있는 값을 나열합니다 nBorderCmd .

borderGet
사용 가능한 OLE 클라이언트 공간을 가져옵니다.

borderRequest
OLE 클라이언트 공간을 요청합니다.

borderSet
OLE 클라이언트 공간을 설정합니다.

`CFrameWndEx::OnActivate`

프레임에서 사용자 입력을 전환하거나 프레임에서 멀어지면 프레임워크에서 이 메서드를 호출합니다.

afx_msg void OnActivate(
    UINT nState,
    CWnd* pWndOther,
    BOOL bMinimized);

매개 변수

nState
[in] 프레임이 활성 상태인지 비활성 상태인지 여부입니다. 가능한 값은 설명 섹션의 표를 참조하세요.

pWndOther
[in] 사용자 입력을 현재 창으로 전환하는 다른 창에 대한 포인터입니다.

bMinimized
[in] 프레임의 최소화된 상태입니다. TRUE프레임이 최소화된 경우 그렇지 않으면 . FALSE

설명

다음 표에서는 매개 변수에 사용할 수 있는 값을 나열합니다 nState .

값	설명
`WA_ACTIVE`	마우스 클릭 이외의 메서드에 의해 프레임이 선택됩니다.
`WA_CLICKACTIVE`	마우스 클릭으로 프레임을 선택합니다.
`WA_INACTIVE`	프레임이 선택되지 않았습니다.

`CFrameWndEx::OnActivateApp`

애플리케이션을 선택하거나 선택 취소할 때 프레임워크에서 호출됩니다.

afx_msg void OnActivateApp(
    BOOL bActive,
    DWORD dwThreadID);

매개 변수

bActive
[in] TRUE 애플리케이션이 선택되어 있으면 이고, FALSE 애플리케이션을 선택하지 않으면 입니다.

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

설명

`CFrameWndEx::OnChangeVisualManager`

프레임을 변경하려면 시각적 관리자를 변경해야 하는 경우 프레임워크에서 호출됩니다.

afx_msg LRESULT OnChangeVisualManager(
    WPARAM wParam,
    LPARAM lParam);

매개 변수

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

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

Return Value

항상 0을 반환합니다.

설명

`CFrameWndEx::OnClose`

프레임워크는 이 메서드를 호출하여 프레임을 닫습니다.

afx_msg void OnClose();

설명

프레임이 인쇄 미리 보기 모드인 경우 인쇄 미리 보기를 닫기 위해 Windows 메시지를 보냅니다. 그렇지 않으면 프레임이 OLE 클라이언트를 호스트하는 경우 클라이언트가 비활성화됩니다.

`CFrameWndEx::OnCloseDockingPane`

사용자가 도킹 창에서 닫기 단추를 클릭할 때 프레임워크에서 호출됩니다.

virtual BOOL OnCloseDockingPane(CDockablePane* pPane);

Return Value

TRUE 도킹 막대를 닫을 수 있으면 그렇지 않으면 FALSE입니다.

설명

기본 구현은 아무 작업도 수행하지 않습니다. 도킹 막대의 숨김을 처리하려는 경우 이 메서드를 재정의합니다.

`CFrameWndEx::OnCloseMiniFrame`

사용자가 부동 미니 프레임 창에서 닫기 단추를 클릭할 때 프레임워크에서 호출됩니다.

virtual BOOL OnCloseMiniFrame(CPaneFrameWnd* pWnd);

Return Value

TRUE 부동 미니 프레임 창을 닫을 수 있으면 그렇지 않으면 FALSE입니다.

설명

기본 구현은 아무 작업도 수행하지 않습니다. 부동 미니 프레임 창의 숨김을 처리하려는 경우 이 메서드를 재정의합니다.

`CFrameWndEx::OnClosePopupMenu`

활성 팝업 메뉴가 메시지를 처리할 때 프레임워크에서 호출됩니다 WM_DESTROY .

virtual void OnClosePopupMenu(CMFCPopupMenu* pMenuPopup);

매개 변수

pMenuPopup
팝업 메뉴에 대한 포인터입니다.

설명

프레임워크는 창을 닫을 때 메시지를 보냅니 WM_DESTROY 다. 개체가 창을 닫을 때 프레임워크에서 CMFCPopupMenu 보낸 메시지를 처리 WM_DESTROY 할 때 CMFCPopupMenu 프레임 창에 속한 개체의 알림을 처리하려는 경우 이 메서드를 재정의합니다.

`CFrameWndEx::OnCmdMsg`

명령 메시지를 디스패치합니다.

virtual BOOL OnCmdMsg(
    UINT nID,
    int nCode,
    void* pExtra,
    AFX_CMDHANDLERINFO* pHandlerInfo);

매개 변수

nID
[in] 명령 ID입니다.

nCode
[in] 명령 메시지 범주입니다.

pExtra
[in, out] 명령 개체에 대한 포인터입니다.

pHandlerInfo
[in, out] 명령 처리기 구조에 대한 포인터입니다.

Return Value

TRUE명령 메시지가 처리되었으면 이고, 그렇지 않으면 . FALSE

설명

`CFrameWndEx::OnContextHelp`

컨텍스트 관련 도움말을 표시하기 위해 프레임워크에서 호출됩니다.

afx_msg void OnContextHelp();

설명

`CFrameWndEx::OnCreate`

프레임을 만든 후 프레임워크에서 호출됩니다.

afx_msg int OnCreate(LPCREATESTRUCT lpCreateStruct);

매개 변수

lpCreateStruct
[in] 새 프레임의 구조체 CREATESTRUCT 에 대한 포인터입니다.

Return Value

프레임 생성을 계속하려면 0입니다. -1을 사용하여 프레임을 삭제합니다.

설명

`CFrameWndEx::OnDestroy`

프레임이 제거될 때 프레임워크에서 호출됩니다.

afx_msg void OnDestroy();

설명

액셀러레이터 테이블과 모든 창이 제거됩니다.

`CFrameWndEx::OnDrawMenuImage`

애플리케이션이 메뉴 항목과 연결된 이미지를 그릴 때 프레임워크에서 호출됩니다.

virtual BOOL OnDrawMenuImage(
    CDC* pDC,
    const CMFCToolBarMenuButton* pMenuButton,
    const CRect& rectImage);

매개 변수

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

pMenuButton
[in] 이미지가 렌더링되는 메뉴 단추에 대한 포인터입니다.

rectImage
[in] 이미지의 Rect 화면 위치와 크기를 지정하는 구조체에 대한 포인터입니다.

Return Value

TRUE 프레임워크가 이미지를 성공적으로 렌더링하면 FALSE 그렇지 않으면.

설명

파생 개체가 소유한 메뉴 모음에 속하는 메뉴 항목에 대한 이미지 렌더링을 사용자 지정하려는 경우 이 메서드를 재정의 CFrameWndEx 합니다.

`CFrameWndEx::OnDrawMenuLogo`

개체가 메시지를 처리할 때 프레임워크에서 CMFCPopupMenu 호출됩니다 WM_PAINT .

virtual void OnDrawMenuLogo(
    CDC* pDC,
    CMFCPopupMenu* pMenu,
    const CRect& rectLogo);

매개 변수

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

pMenu
[in] 메뉴 항목에 대한 포인터입니다.

rectLogo
[in] 메뉴 로고의 화면 위치와 크기를 지정하는 상수 CRect 구조체에 대한 참조입니다.

설명

파생 개체가 소유한 메뉴 모음에 속하는 팝업 메뉴에 로고를 표시하려면 이 함수를 재정의 CFrameWndEx 합니다.

`CFrameWndEx::OnDWMCompositionChanged`

DWM(데스크톱 창 관리자) 컴퍼지션을 사용하거나 사용하지 않도록 설정한 경우 프레임워크에서 호출됩니다.

afx_msg LRESULT OnDWMCompositionChanged(
    WPARAM wp,
    LPARAM lp);

매개 변수

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

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

Return Value

항상 0을 반환합니다.

설명

`CFrameWndEx::OnExitSizeMove`

프레임이 이동 또는 크기 조정을 중지할 때 프레임워크에서 호출됩니다.

LRESULT OnExitSizeMove(
    WPARAM wp,
    LPARAM lp);

매개 변수

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

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

Return Value

항상 0을 반환합니다.

설명

`CFrameWndEx::OnGetMinMaxInfo`

프레임 크기를 조정하여 창 차원 제한을 설정할 때 프레임워크에서 호출됩니다.

afx_msg void OnGetMinMaxInfo(MINMAXINFO FAR* lpMMI);

매개 변수

lpMMI
[in] 구조체에 대한 포인터입니다 MINMAXINFO .

설명

`CFrameWndEx::OnIdleUpdateCmdUI`

명령 처리가 유휴 상태일 때 프레임 표시를 업데이트하기 위해 프레임워크에서 호출됩니다.

afx_msg LRESULT OnIdleUpdateCmdUI(
    WPARAM wParam = 0,
    LPARAM lParam = 0);

매개 변수

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

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

Return Value

항상 0을 반환합니다.

설명

`CFrameWndEx::OnLButtonDown`

프레임워크는 사용자가 마우스 왼쪽 단추를 누를 때 이 메서드를 호출합니다.

afx_msg void OnLButtonDown(
    UINT nFlags,
    CPoint point);

매개 변수

nFlags
[in] 사용자가 한정자 키를 눌렀는지 여부를 나타냅니다. 가능한 값은 Notification의 매개 변수 wParam 를 WM_LBUTTONDOWN 참조하세요.

point
[in] 창의 왼쪽 위 모서리를 기준으로 포인터의 x 및 y 좌표를 지정합니다.

설명

`CFrameWndEx::OnLButtonUp`

프레임워크는 사용자가 마우스 왼쪽 단추를 놓을 때 이 메서드를 호출합니다.

afx_msg void OnLButtonUp(
    UINT nFlags,
    CPoint point);

매개 변수

nFlags
[in] 사용자가 한정자 키를 눌렀는지 여부를 나타냅니다. 가능한 값은 Notification의 매개 변수 wParam 를 WM_LBUTTONUP 참조하세요.

point
[in] 창의 왼쪽 위 모서리를 기준으로 포인터의 x 및 y 좌표를 지정합니다.

설명

`CFrameWndEx::OnMenuButtonToolHitTest`

개체가 메시지를 처리할 때 프레임워크에서 CMFCToolBarButton 호출됩니다 WM_NCHITTEST .

virtual BOOL OnMenuButtonToolHitTest(
    CMFCToolBarButton* pButton,
    TOOLINFO* pTI);

매개 변수

pButton
[in] 도구 모음 단추에 대한 포인터입니다.

pTI
[out] 도구 정보 구조에 대한 포인터입니다.

Return Value

TRUE 애플리케이션이 매개 변수를 채우면 입니다 pTI . 그렇지 않으면 FALSE입니다.

설명

특정 메뉴 항목에 대한 도구 설명 정보를 제공하려는 경우 이 메서드를 재정의합니다.

`CFrameWndEx::OnMenuChar`

메뉴가 표시되고 사용자가 명령에 해당하지 않는 키를 누르면 프레임워크에서 호출됩니다.

afx_msg LRESULT OnMenuChar(
    UINT nChar,
    UINT nFlags,
    CMenu* pMenu);

매개 변수

nChar
[in] 누른 키의 문자 코드입니다.

nFlags
[in] 표시되는 메뉴가 MF_POPUP 하위 메뉴인 경우 플래그를 포함합니다. 표시된 메뉴가 컨트롤 메뉴인 경우 플래그가 포함 MF_SYSMENU 됩니다.

pMenu
[in] 메뉴에 대한 포인터입니다.

Return Value

상위 단어는 다음 값 중 하나여야 합니다.

값	설명
`0`	프레임워크는 키 입력을 무시해야 합니다.
`1`	프레임워크는 메뉴를 닫아야 합니다.
`2`	프레임워크는 메뉴에 표시되는 항목 중 하나를 선택해야 합니다. 낮은 순서의 단어에는 선택할 명령의 ID가 포함됩니다.

`CFrameWndEx::OnMouseMove`

프레임워크는 포인터가 이동할 때 이 메서드를 호출합니다.

afx_msg void OnMouseMove(
    UINT nFlags,
    CPoint point);

매개 변수

nFlags
[in] 사용자가 한정자 키를 눌렀는지 여부를 나타냅니다. 가능한 값은 Notification의 매개 변수 wParam 를 WM_MOUSEMOVE 참조하세요.

point
[in] 창의 x 왼쪽 위 모서리를 기준으로 포인터의 및 y 좌표를 지정합니다.

설명

`CFrameWndEx::OnMoveMiniFrame`

창 창이 이동할 때 프레임워크에서 호출됩니다.

virtual BOOL OnMoveMiniFrame(CWnd* pFrame);

매개 변수

pFrame
[in] 클래스 창 창에 대한 CPaneFrameWnd 포인터입니다.

Return Value

TRUE 창 창이 도킹되지 않은 경우 FALSE 창 창이 도킹되었으면 입니다.

설명

`CFrameWndEx::OnNcActivate`

프레임의 클라이언트가 아닌 영역을 다시 그려 활성 상태의 변화를 나타내야 하는 경우 프레임워크에서 호출됩니다.

afx_msg BOOL OnNcActivate(BOOL bActive);

매개 변수

bActive
[in] TRUE 프레임을 활성으로 그리려면 FALSE 프레임을 비활성 상태로 그립니다.

Return Value

0이 아닌 경우 기본 처리를 계속합니다. 비 클라이언트 영역이 비활성화되지 않도록 0입니다.

설명

`CFrameWndEx::OnNcCalcSize`

클라이언트 영역의 크기와 위치를 계산해야 하는 경우 프레임워크에서 호출됩니다.

afx_msg void OnNcCalcSize(
    BOOL bCalcValidRects,
    NCCALCSIZE_PARAMS FAR* lpncsp);

매개 변수

bCalcValidRects
[in] TRUE 애플리케이션이 유효한 클라이언트 영역을 지정해야 하는 경우 그렇지 않으면 . FALSE

lpncsp
[in] NCCALCSIZE_PARAMS 프레임 차원 변경 내용을 포함하는 구조체에 대한 포인터입니다.

설명

`CFrameWndEx::OnNcHitTest`

포인터가 이동하거나 마우스 단추를 누르거나 놓을 때 프레임워크에서 호출됩니다.

afx_msg LRESULT OnNcHitTest(CPoint point);

매개 변수

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

Return Value

포인터가 열거형 값을 적중합니다. 가능한 값 목록은 알림을 참조 WM_NCHITTEST 하세요.

설명

`CFrameWndEx::OnNcMouseMove`

비 클라이언트 영역에서 포인터가 이동할 때 프레임워크에서 호출됩니다.

afx_msg void OnNcMouseMove(
    UINT nHitTest,
    CPoint point);

매개 변수

nHitTest
[in] 포인터가 열거형 값을 적중합니다. 가능한 값 목록은 알림을 참조 WM_NCHITTEST 하세요.

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

설명

`CFrameWndEx::OnNcPaint`

비 클라이언트 영역을 그려야 하는 경우 프레임워크에서 호출됩니다.

afx_msg void OnNcPaint();

설명

`CFrameWndEx::OnPaneCheck`

틀의 표시 유형을 제어하기 위해 프레임워크에서 호출됩니다.

afx_msg BOOL OnPaneCheck(UINT nID);

매개 변수

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

Return Value

TRUE 명령이 처리되었으면 이고, FALSE 명령 처리를 계속합니다.

설명

`CFrameWndEx::OnPostPreviewFrame`

사용자가 인쇄 미리 보기 모드를 변경할 때 프레임워크에서 호출됩니다.

afx_msg LRESULT OnPostPreviewFrame(
    WPARAM wParam,
    LPARAM lParam);

매개 변수

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

lParam
[in] TRUE 프레임이 인쇄 미리 보기 모드인 경우 FALSE 인쇄 미리 보기 모드가 꺼져 있는 경우

Return Value

항상 0을 반환합니다.

설명

`CFrameWndEx::OnPowerBroadcast`

전원 관리 이벤트가 발생할 때 프레임워크에서 호출됩니다.

afx_msg LRESULT OnPowerBroadcast(
    WPARAM wp,
    LPARAM lp);

매개 변수

wp
[in] 전원 관리 이벤트입니다. 가능한 값 목록은 메시지를 참조 WM_POWERBROADCAST 하세요.

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

Return Value

기본 창 프로시저를 호출한 결과입니다.

설명

`CFrameWndEx::OnSetMenu`

프레임 창 메뉴를 바꾸기 위해 프레임워크에서 호출됩니다.

afx_msg LRESULT OnSetMenu(
    WPARAM wp,
    LPARAM lp);

BOOL OnSetMenu(HMENU hmenu);

매개 변수

wp
[in] 새 프레임 창 메뉴에 대한 핸들입니다.

lp
[in] 새 창 메뉴에 대한 핸들입니다.

hmenu
[in] 새 프레임 창 메뉴에 대한 핸들입니다.

Return Value

LRESULT 는 기본 창 프로시저를 호출한 결과입니다.

BOOL은 이벤트가 처리된 경우이고 TRUE , FALSE그렇지 않으면 .

설명

`CFrameWndEx::OnSetPreviewMode`

프레임의 인쇄 미리 보기 모드를 설정하기 위해 프레임워크에서 호출됩니다.

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

매개 변수

bPreview
[in] TRUE 인쇄 미리 보기를 사용하도록 설정하려면 FALSE 인쇄 미리 보기를 사용하지 않도록 설정합니다.

pState
[in] 프레임 상태 구조에 대한 포인터입니다 CPrintPreviewState .

설명

`CFrameWndEx::OnSetText`

창의 텍스트를 설정하기 위해 프레임워크에서 호출됩니다.

afx_msg LRESULT OnSetText(
    WPARAM wParam,
    LPARAM lParam);

매개 변수

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

lParam
[in] 창의 텍스트에 대한 포인터입니다.

Return Value

호출에서 값을 반환합니다 DefWindowProc.

설명

`CFrameWndEx::OnShowCustomizePane`

를 표시할 때 프레임워크에서 호출됩니다 QuickCustomizePane.

virtual BOOL OnShowCustomizePane(
    CMFCPopupMenu* pMenuPane,
    UINT uiToolbarID);

매개 변수

pMenuPane
[in] 빠른 사용자 지정 창에 대한 포인터입니다.

uiToolbarID
[in] 사용자 지정할 도구 모음의 컨트롤 ID입니다.

Return Value

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

설명

빠른 사용자 지정 메뉴는 도구 모음의 사용자 지정 단추를 클릭할 때 나타나는 팝업 메뉴입니다.

`CFrameWndEx::OnShowPanes`

틀을 표시하거나 숨기기 위해 프레임워크에서 호출됩니다.

virtual BOOL OnShowPanes(BOOL bShow);

매개 변수

bShow
[in] TRUE 애플리케이션에 창이 표시되면 이고, FALSE 그렇지 않으면.

Return Value

이 메서드는 항상 FALSE을 반환합니다.

설명

기본 구현은 창(있는 TRUE 경우bShow)과 창이 숨겨지거나 있는 경우 및 창이 표시되는 경우 bShow FALSE 를 보여줍니다.

기본 구현은 창이 표시되거나 창이 숨겨져 있는 bShow FALSE 경우 bShow TRUE 창을 숨깁니다.

프레임워크에서 창을 표시하거나 숨길 때 사용자 지정 코드를 실행하도록 파생 클래스에서 이 메서드를 재정의합니다.

`CFrameWndEx::OnShowPopupMenu`

팝업 메뉴를 표시할 때 프레임워크에서 호출됩니다.

virtual BOOL OnShowPopupMenu(CMFCPopupMenu* pMenu);

매개 변수

pMenu
[in] 팝업 메뉴에 대한 포인터입니다.

Return Value

TRUE 팝업 메뉴가 표시되면 이고, 그렇지 않으면 FALSE.

설명

프레임워크에 팝업 메뉴가 표시될 때 사용자 지정 코드를 실행하도록 파생 클래스에서 이 메서드를 재정의합니다. 예를 들어 팝업 메뉴에서 명령의 배경색을 변경하려면 이 메서드를 재정의합니다.

`CFrameWndEx::OnSize`

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

afx_msg void OnSize(
    UINT nType,
    int cx,
    int cy);

매개 변수

nType
[in] 크기 조정의 형식입니다. 가능한 값은 WM_SIZE 알림의 매개 변수 wParam 를 참조하세요.

cx
[in] 프레임의 새 너비(픽셀)입니다.

cy
[in] 프레임의 새 높이(픽셀)입니다.

설명

`CFrameWndEx::OnSizing`

사용자가 프레임 크기를 조정할 때 프레임워크에서 호출됩니다.

afx_msg void OnSizing(
    UINT fwSide,
    LPRECT pRect);

매개 변수

fwSide
[in] 이동되는 프레임의 가장자리입니다. 알림에서 매개 변수 wParam 를 WM_SIZING 참조하세요.

pRect
[in, out] 프레임의 CRect 좌표를 포함하는 구조체에 RECT 대한 포인터입니다.

설명

`CFrameWndEx::OnSysColorChange`

시스템 색이 변경되면 프레임워크에서 호출됩니다.

void OnSysColorChange();

설명

`CFrameWndEx::OnTearOffMenu`

애플리케이션이 분리 막대가 있는 메뉴를 표시할 때 프레임워크에서 호출됩니다.

virtual BOOL OnTearOffMenu(
    CMFCPopupMenu* pMenuPopup,
    CPane* pBar);

매개 변수

pMenuPopup
[in] 팝업 메뉴에 대한 포인터입니다.

pBar
[in] 분리 막대에 대한 포인터입니다.

Return Value

TRUE 절개 표시줄이 있는 팝업 메뉴를 사용하도록 설정하면 FALSE.

설명

프레임워크에 컨트롤 막대가 표시될 때 사용자 지정 코드를 실행하도록 파생 클래스에서 이 메서드를 재정의합니다.

기본 구현은 아무 작업도 수행 하지 하 고 반환 TRUE합니다.

`CFrameWndEx::OnToolbarContextMenu`

프레임워크에서 도구 모음 팝업 메뉴를 빌드하기 위해 호출됩니다.

afx_msg LRESULT OnToolbarContextMenu(
    WPARAM wp,
    LPARAM lp);

매개 변수

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

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

Return Value

항상 1을 반환합니다.

설명

`CFrameWndEx::OnToolbarCreateNew`

프레임워크는 이 메서드를 호출하여 새 도구 모음을 만듭니다.

afx_msg LRESULT OnToolbarCreateNew(
    WPARAM wp,
    LPARAM lp);

매개 변수

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

lp
[in] 도구 모음의 제목 표시줄에 대한 텍스트에 대한 포인터입니다.

Return Value

새 도구 모음에 대한 포인터입니다. 또는 NULL 도구 모음이 만들어지지 않은 경우

설명

`CFrameWndEx::OnToolbarDelete`

도구 모음이 삭제될 때 프레임워크에서 호출됩니다.

afx_msg LRESULT OnToolbarDelete(
    WPARAM /* unused */,
    LPARAM lp);

`CFrameWndEx::PaneFromPoint`

각 창에서 지정된 지점을 검색합니다.

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] TRUE 매개 변수를 무시하려면 이 nSensitivity 고, FALSE그렇지 않으면 .입니다.

pRTCBarType
[in] 그렇지 않은 NULL경우 메서드는 지정된 형식의 컨트롤 막대만 검색합니다.

dwAlignment
[out] 성공하면 이 매개 변수는 지정된 지점에 가장 가까운 컨트롤 막대의 측면을 포함합니다. 그렇지 않으면 이 매개 변수가 초기화되지 않습니다.

Return Value

컨트롤이 없으면 ; NULL 을 point포함하는 컨트롤 막대에 대한 포인터입니다.

설명

이 메서드는 애플리케이션의 모든 컨트롤 막대에서 .를 검색합니다 point.

검색 영역의 크기를 늘리는 데 사용합니다 nSensitivity . 메서드가 검색하는 컨트롤 막대의 형식을 제한하는 데 사용합니다 pRTCBarType .

`CFrameWndEx::PreTranslateMessage`

특정 창 메시지가 디스패치되기 전에 처리합니다.

virtual BOOL PreTranslateMessage(MSG* pMsg);

매개 변수

pMsg
[in] 처리할 MSG 메시지를 포함하는 구조체에 대한 포인터입니다.

Return Value

메시지를 처리하고 디스패치해서는 안 되는 경우 0이 아닙니다. 메시지가 처리되지 않았고 디스패치되어야 하는 경우 0입니다.

설명

`CFrameWndEx::RecalcLayout`

프레임 및 해당 자식 창의 레이아웃을 조정합니다.

virtual void RecalcLayout(BOOL bNotify = TRUE);

매개 변수

bNotify
[in] 레이아웃 변경에 대해 OLE 클라이언트 항목에 알릴지 여부를 지정합니다.

설명

이 메서드는 프레임 창의 크기가 변경되거나 컨트롤 막대가 표시되거나 숨겨지는 경우에 호출됩니다.

`CFrameWndEx::RemovePaneFromDockManager`

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

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

매개 변수

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

bDestroy
[in] TRUE 컨트롤 막대를 제거한 후 삭제하려면 입니다. FALSE 그렇지 않으면.

bAdjustLayout
[in] TRUE 도킹 레이아웃을 조정하려면 FALSE 그렇지 않으면.

bAutoHide
[in] TRUE 컨트롤 막대가 자동 숨기기 모드인 경우 FALSE 그렇지 않으면.

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

설명

이 메서드를 사용하여 프레임 창의 도킹 레이아웃에서 컨트롤 막대를 제거합니다.

클래스는 CDockingManager 컨트롤 막대의 레이아웃을 처리합니다. 메서드 또는 CFrameWndEx::InsertPane 메서드를 사용하여 각 컨트롤 바를 도킹 관리자에 CFrameWndEx::AddPane 등록해야 합니다.

`CFrameWndEx::SetDockState`

도킹 레이아웃을 레지스트리에 저장된 도킹 상태로 복원합니다.

void SetDockState(const CDockState& state);

매개 변수

state
도킹 상태입니다. 이 매개 변수는 무시됩니다.

`CFrameWndEx::SetPrintPreviewFrame`

인쇄 미리 보기 프레임 창을 설정합니다.

void SetPrintPreviewFrame(CFrameWnd* pWnd);

매개 변수

pWnd
[in] 인쇄 미리 보기 프레임 창에 대한 포인터입니다.

설명

`CFrameWndEx::SetupToolbarMenu`

도구 모음 메뉴에 사용자 정의 명령을 삽입합니다.

void SetupToolbarMenu(
    CMenu& menu,
    const UINT uiViewUserToolbarCmdFirst,
    const UINT uiViewUserToolbarCmdLast);

매개 변수

menu
[in] CMenu 수정할 개체입니다.

uiViewUserToolbarCmdFirst
[in] 첫 번째 사용자 정의 명령입니다.

uiViewUserToolbarCmdLast
[in] 마지막 사용자 정의 명령입니다.

설명

프레임워크는 사용자 정의 명령을 목록에 저장합니다. uiViewUserToolbarCmdList 삽입할 명령의 인덱스를 사용하고 uiViewUserToolbarCmdFirst 지정합니다.

`CFrameWndEx::ShowFullScreen`

주 프레임을 전체 화면 모드와 일반 모드 간에 전환합니다.

void ShowFullScreen();

`CFrameWndEx::ShowPane`

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

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

매개 변수

pBar
[in] 표시하거나 숨길 컨트롤 막대에 대한 포인터입니다.

bShow
[in] 이 경우 TRUE애플리케이션에 컨트롤 막대가 표시됩니다. 그렇지 않으면 애플리케이션이 컨트롤 바를 숨깁니다.

bDelay
[in] 이면 TRUE프레임워크가 호출 CFrameWndEx::AdjustDockingLayout될 때까지 도킹 레이아웃 조정을 지연합니다. 그렇지 않으면 도킹 레이아웃을 즉시 다시 계산합니다.

bActivate
[in] 이면 TRUE컨트롤 막대를 활성화합니다. 그렇지 않으면 비활성 상태로 컨트롤 막대를 표시합니다.

`CFrameWndEx::UpdateCaption`

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

void UpdateCaption();

설명

`CFrameWndEx::WinHelp`

WinHelp 애플리케이션 또는 컨텍스트 관련 도움말을 호출합니다.

virtual void WinHelp(
    DWORD dwData,
    UINT nCmd = HELP_CONTEXT);

매개 변수

dwData
매개 변수에 따라 달라지는 nCmd 데이터입니다. 가능한 값 목록은 다음을 참조하세요 WinHelp.

nCmd
도움말 명령입니다. 가능한 값 목록은 다음을 참조하세요 WinHelp.

설명

참고 항목

계층 구조 차트
클래스
CFrameWnd

다음을 통해 공유

CFrameWndEx 수업

구문

멤버

공용 메서드

예시

상속 계층 구조

요구 사항

CFrameWndEx::ActiveItemRecalcLayout

설명

CFrameWndEx::AddPane

매개 변수

Return Value

CFrameWndEx::AdjustDockingLayout

매개 변수

설명

CFrameWndEx::DelayUpdateFrameMenu

매개 변수

설명

CFrameWndEx::DockPane

매개 변수

설명

CFrameWndEx::DockPaneLeftOf

매개 변수

Return Value

설명

CFrameWndEx::EnableAutoHidePanes

매개 변수

Return Value

설명

CFrameWndEx::EnableDocking

매개 변수

Return Value

설명

CFrameWndEx::EnableFullScreenMainMenu

매개 변수

CFrameWndEx::EnableFullScreenMode

매개 변수

설명

CFrameWndEx::EnableLoadDockState

매개 변수

CFrameWndEx::EnablePaneMenu

매개 변수

CFrameWndEx::GetActivePopup

Return Value

CFrameWndEx::GetDefaultResId

Return Value

CFrameWndEx::GetDockingManager

Return Value

설명

CFrameWndEx::GetMenuBar

Return Value

CFrameWndEx::GetPane

매개 변수

Return Value

CFrameWndEx::GetRibbonBar

Return Value

설명

CFrameWndEx::GetTearOffBars

Return Value

CFrameWndEx::GetToolbarButtonToolTipText

매개 변수

Return Value

설명

CFrameWndEx::InsertPane

매개 변수

Return Value

설명

CFrameWndEx::IsFullScreen

Return Value

설명

CFrameWndEx::IsMenuBarAvailable

Return Value

CFrameWndEx::IsPointNearDockSite

매개 변수

Return Value

설명

CFrameWndEx::IsPrintPreview

Return Value

설명

`CFrameWndEx` 수업

`CFrameWndEx::ActiveItemRecalcLayout`

`CFrameWndEx::AddPane`

`CFrameWndEx::AdjustDockingLayout`

`CFrameWndEx::DelayUpdateFrameMenu`

`CFrameWndEx::DockPane`

`CFrameWndEx::DockPaneLeftOf`

`CFrameWndEx::EnableAutoHidePanes`

`CFrameWndEx::EnableDocking`

`CFrameWndEx::EnableFullScreenMainMenu`

`CFrameWndEx::EnableFullScreenMode`

`CFrameWndEx::EnableLoadDockState`

`CFrameWndEx::EnablePaneMenu`

`CFrameWndEx::GetActivePopup`

`CFrameWndEx::GetDefaultResId`

`CFrameWndEx::GetDockingManager`

`CFrameWndEx::GetMenuBar`

`CFrameWndEx::GetPane`

`CFrameWndEx::GetRibbonBar`

`CFrameWndEx::GetTearOffBars`

`CFrameWndEx::GetToolbarButtonToolTipText`

`CFrameWndEx::InsertPane`

`CFrameWndEx::IsFullScreen`

`CFrameWndEx::IsMenuBarAvailable`

`CFrameWndEx::IsPointNearDockSite`

`CFrameWndEx::IsPrintPreview`

`CFrameWndEx::LoadFrame`

`CFrameWndEx::NegotiateBorderSpace`

`CFrameWndEx::OnActivate`

`CFrameWndEx::OnActivateApp`

`CFrameWndEx::OnChangeVisualManager`

`CFrameWndEx::OnClose`

`CFrameWndEx::OnCloseDockingPane`

`CFrameWndEx::OnCloseMiniFrame`

`CFrameWndEx::OnClosePopupMenu`

`CFrameWndEx::OnCmdMsg`

`CFrameWndEx::OnContextHelp`

`CFrameWndEx::OnCreate`

`CFrameWndEx::OnDestroy`

`CFrameWndEx::OnDrawMenuImage`

`CFrameWndEx::OnDrawMenuLogo`

`CFrameWndEx::OnDWMCompositionChanged`

`CFrameWndEx::OnExitSizeMove`

`CFrameWndEx::OnGetMinMaxInfo`

`CFrameWndEx::OnIdleUpdateCmdUI`

`CFrameWndEx::OnLButtonDown`

`CFrameWndEx::OnLButtonUp`