CFrameWndEx クラス

  • [アーティクル]

Windows のシングル ドキュメント インターフェイス (SDI: Single Document Interface) のオーバーラップ フレーム ウィンドウまたはポップアップ フレーム ウィンドウの機能を実装し、ウィンドウを管理するメンバーを提供します。 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 メソッドをオーバーライドする方法を示しています。 このコード スニペットは、 Word パッド サンプルの一部です。

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;
}

継承階層

CObject

CCmdTarget

CWnd

CFrameWnd

CFrameWndEx

要件

ヘッダー: afxframewndex.h

CFrameWndEx::ActiveItemRecalcLayout

OLE クライアント項目とフレームのクライアント領域のレイアウトが調整されます。

void ActiveItemRecalcLayout();

解説

CFrameWndEx::AddPane

コントロール バーがドッキング マネージャーに登録されます。

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

パラメーター

pControlBar
[入力] 登録するコントロール バー ペイン。

bTail
[入力] TRUE コントロール バー ウィンドウをリストの末尾に追加する場合は、次の操作を行います。それ以外の場合 FALSE 。

戻り値

TRUE コントロール バーが正常に登録された場合。それ以外の場合 FALSE 。

CFrameWndEx::AdjustDockingLayout

フレーム ウィンドウにドッキングされているすべてのペインのレイアウトが再計算されます。

virtual void AdjustDockingLayout(HDWP hdwp=NULL);

パラメーター

hdwp
複数のウィンドウの位置を含めた構造体へのハンドル。 .

解説

hdwp 構造体は、 BeginDeferWindowPos メソッドによって初期化されます。

CFrameWndEx::DelayUpdateFrameMenu

フレーム メニューが設定され、コマンド処理がアイドル状態のときに更新されます。

virtual void DelayUpdateFrameMenu(HMENU hMenuAlt);

パラメーター

hMenuAlt
[入力] 代替メニューへのハンドル。

解説

CFrameWndEx::DockPane

指定したペインがフレーム ウィンドウにドッキングされます。

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

パラメーター

pBar
[入力] ドッキングされるコントロール バーへのポインター。

nDockBarID
[入力] ドッキング先のフレーム ウィンドウの辺の 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
[入力] ドッキング先のペイン オブジェクトへのポインター。

pLeftOf
[in] pBarで指定されたペインをドッキングするペインの左側へのポインター。

戻り値

TRUEpBarが正常にドッキングされた場合は a0/a0>。 それ以外の場合 FALSE。

解説

メソッドは、 pBar パラメーターで指定されたツール バーを受け取り、 pLeftOf パラメーターで指定されたツール バーの左側にドッキングします。

CFrameWndEx::EnableAutoHidePanes

メイン フレーム ウィンドウの指定した側にドッキングされている場合に、ウィンドウの自動非表示モードを有効にします。

BOOL EnableAutoHidePanes(DWORD dwDockStyle);

パラメーター

dwDockStyle
[入力] ペインのドッキング先となるメイン フレーム ウィンドウの辺が指定されます。

戻り値

TRUE バー ウィンドウが、 dwDockStyleで指定されたフレーム ウィンドウ側に正常にドッキングされた場合は、それ以外の場合 FALSE 。

解説

dwDockStyle には、次のいずれかの値を指定できます。

  • CBRS_ALIGN_TOP: コントロール バーをフレーム ウィンドウのクライアント領域の上部にドッキングできます。

  • CBRS_ALIGN_BOTTOM: コントロール バーをフレーム ウィンドウのクライアント領域の下部にドッキングできるようにします。

  • CBRS_ALIGN_LEFT: コントロール バーをフレーム ウィンドウのクライアント領域の左側にドッキングできます。

  • CBRS_ALIGN_RIGHT: コントロール バーをフレーム ウィンドウのクライアント領域の右側にドッキングできます。

CFrameWndEx::EnableDocking

フレーム ウィンドウのペインのドッキングを有効にします。

BOOL EnableDocking(DWORD dwDockStyle);

パラメーター

dwDockStyle
[入力] ペイン バーがドッキングするメイン フレーム ウィンドウの辺が指定されます。

戻り値

TRUE バー ペインを指定した側に正常にドッキングできる場合は 。 それ以外の場合 FALSE。

解説

dwDockStyle パラメーターには、次のいずれかの値を指定できます。

  • CBRS_ALIGN_TOP

  • CBRS_ALIGN_BOTTOM

  • CBRS_ALIGN_LEFT

  • CBRS_ALIGN_RIGHT

CFrameWndEx::EnableFullScreenMainMenu

全画面モードにメイン メニューを表示または非表示になります。

void EnableFullScreenMainMenu(BOOL bEnableMenu);

パラメーター

bEnableMenu
[入力] TRUE をクリックすると、全画面表示モードでメイン メニューが表示 FALSE 。それ以外の場合は。

CFrameWndEx::EnableFullScreenMode

フレーム ウィンドウの全画面モードが有効になります。

void EnableFullScreenMode(UINT uiFullScreenCmd);

パラメーター

uiFullScreenCmd
[入力] 全画面表示モードを有効または無効にするコマンドの ID。

解説

全画面表示モードでは、すべてのドッキング コントロール バー、ツール バー、メニューが非表示になり、全画面になるようにアクティブなビューのサイズが変更されます。

全画面表示モードを有効にする場合は、全画面表示モードを有効または無効にするコマンドの ID を指定する必要があります。 メイン フレームの OnCreate 関数から EnableFullScreenMode を呼び出すことができます。 フレーム ウィンドウが全画面表示モードに切り替えられるとき、指定したコマンド ID を持つボタン 1 つからなるフローティング ツール バーがフレームワークによって作成されます。

メイン メニューを画面に表示したままにする場合は、 CFrameWndEx::EnableFullScreenMainMenuを呼び出します。

CFrameWndEx::EnableLoadDockState

ドッキング状態の読み込みを有効または無効にします。

void EnableLoadDockState(BOOL bEnable=TRUE);

パラメーター

bEnable
[入力] TRUE ドッキング状態の読み込みを有効にするには、ドッキング状態の読み込みを無効にする FALSE 。

CFrameWndEx::EnablePaneMenu

ペイン メニューの自動処理を有効または無効にします。

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

パラメーター

bEnable
[入力] TRUE コントロールバーのポップアップメニューの自動処理を有効にするには、コントロール バーのポップアップ メニューの自動処理を無効にする FALSE 。

uiCustomizeCmd
[入力] [カスタマイズ] メニュー項目のコマンド ID。

strCustomizeLabel
[入力] [カスタマイズ] メニュー項目に表示されるラベル

uiViewToolbarsMenuEntryID
[入力] コントロール バーのポップアップ メニューを開くツール バー メニュー項目の ID。

bContextMenuShowsToolbarsOnly
[in] TRUE場合、コントロール バーのコンテキスト メニューにはツール バーの一覧のみが表示されます。 FALSE場合、メニューにツールバーとドッキング バーの一覧が表示されます。

bViewMenuShowsToolbarsOnly
[in] TRUE場合は、コントロール バー メニューにツール バーの一覧のみが表示されます。 FALSE場合、メニューにツールバーとドッキング バーの一覧が表示されます。

CFrameWndEx::GetActivePopup

現在表示されているポップアップ メニューへのポインターが返されます。

CMFCPopupMenu* GetActivePopup() const;

戻り値

現在表示されているポップアップ メニューへのポインター。それ以外の場合は NULL。

CFrameWndEx::GetDefaultResId

フレームワークによってフレーム ウィンドウが読み込まれたときに指定したリソース ID が返されます。

UINT GetDefaultResId() const;

戻り値

フレーム ウィンドウがフレームワークによって読み込まれたときにユーザーが指定したリソース ID 値。 フレーム ウィンドウにメニュー バーがない場合は 0。

CFrameWndEx::GetDockingManager

フレーム ウィンドウの CDockingManager Class オブジェクトを取得します。

CDockingManager* GetDockingManager();

戻り値

CDockingManager クラスへのポインター。

解説

フレーム ウィンドウは、 CDockingManager Class オブジェクトを作成して使用して、子ウィンドウのドッキングを管理します。

CFrameWndEx::GetMenuBar

フレーム ウィンドウにアタッチされているメニュー バーのオブジェクトへのポインターを返します。

const CMFCMenuBar* GetMenuBar() const;

戻り値

フレーム ウィンドウにアタッチされているメニュー バー オブジェクトへのポインター。

CFrameWndEx::GetPane

指定した ID を持つペインへのポインターが返されます。

CBasePane* GetPane(UINT nID);

パラメーター

nID
[入力] コントロール ID。

戻り値

指定した ID を持つペインへのポインター。 NULL そのようなペインが存在しない場合は 〗。

CFrameWndEx::GetRibbonBar

フレームのリボン バー コントロールが取得されます。

CMFCRibbonBar* GetRibbonBar();

戻り値

フレームの CMFCRibbonBar クラス へのポインター。

解説

CFrameWndEx::GetTearOffBars

ティアオフ状態にあるウィンドウ オブジェクトの一覧を返します。

const CObList& GetTearOffBars() const;

戻り値

ティアオフ状態にあるペイン オブジェクトへのポインターのコレクションを含む CObList オブジェクトへの参照。

CFrameWndEx::GetToolbarButtonToolTipText

アプリケーションでツール バーのボタンのツールヒントを表示するときに、フレームワークによって呼び出されます。

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

パラメーター

pButton
[入力] ツール バーのボタンへのポインター。

strTTText
[入力] ボタンに表示するツールヒントのテキスト。

戻り値

TRUE ヒントが表示されている場合は 。 それ以外の場合 FALSE。

解説

既定では、このメソッドは何も実行しません。 ツール バーのボタンのツールヒントを表示する場合は、このメソッドがオーバーライドされます。

CFrameWndEx::InsertPane

コントロール バーのリストにウィンドウを挿入し、ドッキング マネージャーに登録します。

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

パラメーター

pControlBar
コントロール バーのリストに挿入され、ドッキング マネージャーに登録されるコントロール バーへのポインター。

pTarget
ウィンドウの挿入位置の前または後にあるコントロール バーへのポインター。

bAfter
TRUEpTargetの後にpControlBarを挿入する場合は、それ以外の場合FALSE。

戻り値

TRUE コントロール バーが正常に挿入および登録された場合は a0/& FALSE 。それ以外の場合は。

解説

ドッキング レイアウトに参加するには、 CDockingManager クラス を使用して各コントロール バーを登録する必要があります。

CFrameWndEx::IsFullScreen

フレーム ウィンドウが全画面モードかどうかが判断されます。

BOOL IsFullScreen() const;

戻り値

TRUE フレームウィンドウが全画面表示モードの場合。それ以外の場合は FALSE。

解説

CFrameWndEx::EnableFullScreenMode メソッドを呼び出すと、全画面表示モードを設定できます。

CFrameWndEx::IsMenuBarAvailable

メニュー バー オブジェクトへのポインターが有効であるかどうかが判断されます。

BOOL IsMenuBarAvailable() const;

戻り値

TRUE フレーム ウィンドウにメニュー バーがある場合。それ以外の場合は FALSE。

CFrameWndEx::IsPointNearDockSite

ポイントが配置ゾーン内にあるかどうかが判断されます。

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

パラメーター

point
[入力] ポイントの位置。

dwBarAlignment
[出力] ポイントが配置されている場所。 使用可能な値については、「 Remarks 」セクションの表を参照してください。

bOuterEdge
[out] TRUE ポイントがフレームの境界線の近くに配置されている場合。ポイントがクライアント領域にあるかどうかを FALSE します。

戻り値

TRUE ポイントが線形ゾーンに配置されている場合。それ以外の場合は FALSE。

解説

次の表に、 dwBarAlignment パラメーターに指定できる値を示します。

Value 説明
CBRS_ALIGN_TOP 上側に配置されています。
CBRS_ALIGN_RIGHT 右側に配置されています。
CBRS_ALIGN_BOTTOM 下側に配置されています。
CBRS_ALIGN_LEFT 左側に配置されています。

CFrameWndEx::IsPrintPreview

フレーム ウィンドウが印刷プレビュー モードかどうかが判断されます。

BOOL IsPrintPreview();

戻り値

TRUE フレーム ウィンドウが印刷プレビュー モードの場合。それ以外の場合は FALSE。

解説

CFrameWndEx::LoadFrame

このメソッドは、フレーム ウィンドウを作成し、そのリソースを読み込む構築の後に呼び出されます。

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

パラメーター

nIDResource
[入力] すべてのフレーム リソースの読み込みに使用されるリソース ID。

dwDefaultStyle
[入力] 既定のフレーム ウィンドウ スタイル。

pParentWnd
[入力] フレームの親ウィンドウへのポインター。

pContext
[in]アプリケーションの作成時にフレームワークによって使用される CCreateContext Structure クラスへのポインター。

戻り値

メソッドが正常に実行された場合は TRUE、それ以外の場合は FALSE。

解説

CFrameWndEx::NegotiateBorderSpace

OLE クライアントの境界ネゴシエーションが実装されます。

virtual BOOL NegotiateBorderSpace(
    UINT nBorderCmd,
    LPRECT lpRectBorder);

パラメーター

nBorderCmd
[入力] 境界ネゴシエーション コマンド。 使用可能な値については、「 Remarks 」セクションを参照してください。

lpRectBorder
[入力、出力] 境界線の寸法。

戻り値

TRUE レイアウトを再計算する必要がある場合。それ以外の場合は FALSE。

解説

次の表に、 nBorderCmd パラメーターに指定できる値を示します。

borderGet
使用可能な OLE クライアント領域が取得されます。

borderRequest
OLE クライアント領域が要求されます。

borderSet
OLE クライアント領域が設定されます。

CFrameWndEx::OnActivate

このメソッドは、ユーザー入力がフレームに切り替えられたか、離れたときに、フレームワークによって呼び出されます。

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

パラメーター

nState
[入力] フレームがアクティブか非アクティブか。 使用可能な値については、「 Remarks 」セクションの表を参照してください。

pWndOther
[入力] ユーザー入力を現在のウィンドウに切り替える別のウィンドウへのポインター。

bMinimized
[入力] フレームの最小化の状態。 TRUE フレームが最小化されている場合。それ以外の場合は FALSE。

解説

次の表に、 nState パラメーターに指定できる値を示します。

Value 説明
WA_ACTIVE フレームは、マウス クリック以外の方法で選択されています。
WA_CLICKACTIVE フレームは、マウス クリックで選択されています。
WA_INACTIVE フレームが選択されていません。

CFrameWndEx::OnActivateApp

アプリケーションが選択または選択解除されたときに、フレームワークによって呼び出されます。

afx_msg void OnActivateApp(
    BOOL bActive,
    DWORD dwThreadID);

パラメーター

bActive
[入力] TRUE アプリケーションが選択されている場合。アプリケーションが選択されていない場合に FALSE します。

dwThreadID
[in]このパラメーターは使用されません。

解説

CFrameWndEx::OnChangeVisualManager

フレームの変更によりビジュアル マネージャーを変更する必要があるときに、フレームワークによって呼び出されます。

afx_msg LRESULT OnChangeVisualManager(
    WPARAM wParam,
    LPARAM lParam);

パラメーター

wParam
[in]このパラメーターは使用されません。

lParam
[in]このパラメーターは使用されません。

戻り値

常に 0 を返します。

解説

CFrameWndEx::OnClose

このメソッドは、フレームを閉じるために、フレームワークによって呼び出されます。

afx_msg void OnClose();

解説

フレームが印刷プレビュー モードの場合、印刷プレビューを閉じる Windowsメッセージが送信されます。それ以外の場合、フレームが OLE クライアントをホストしている場合は、クライアントが非アクティブ化されます。

CFrameWndEx::OnCloseDockingPane

ユーザーがドッキング ペインの [閉じる] ボタンをクリックしたとき、フレームワークによって呼び出されます。

virtual BOOL OnCloseDockingPane(CDockablePane* pPane);

戻り値

TRUE ドッキング バーを閉じることができる場合は〘。 それ以外の場合は FALSE

解説

既定の実装では、何も行われません。 ドッキング バーの非表示を処理する場合は、このメソッドがオーバーライドされます。

CFrameWndEx::OnCloseMiniFrame

ユーザーがフローティング ミニ フレーム ウィンドウの [閉じる] ボタンをクリックしたときに、フレームワークによって呼び出されます。

virtual BOOL OnCloseMiniFrame(CPaneFrameWnd* pWnd);

戻り値

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
[入力] コマンド ID。

nCode
[入力] コマンド メッセージ カテゴリ。

pExtra
[入力、出力] コマンド オブジェクトへのポインター。

pHandlerInfo
[入力、出力] コマンド ハンドラー構造体へのポインター。

戻り値

TRUE コマンド メッセージが処理された場合。それ以外の場合は FALSE。

解説

CFrameWndEx::OnContextHelp

コンテキスト関連のヘルプを表示するために、フレームワークによって呼び出されます。

afx_msg void OnContextHelp();

解説

CFrameWndEx::OnCreate

フレームが作成された後に、フレームワークによって呼び出されます。

afx_msg int OnCreate(LPCREATESTRUCT lpCreateStruct);

パラメーター

lpCreateStruct
[in]新しいフレームの CREATESTRUCT 構造体 へのポインター。

戻り値

フレームの作成を続行する場合は 0、フレームを破棄する場合は -1。

解説

CFrameWndEx::OnDestroy

フレームが破棄されるときに、フレームワークによって呼び出されます。

afx_msg void OnDestroy();

解説

アクセラレータ テーブルとすべてのウィンドウが破棄されます。

CFrameWndEx::OnDrawMenuImage

アプリケーションでメニュー項目に関連付けられている画像を描画するときに、フレームワークによって呼び出されます。

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

パラメーター

pDC
[入力] デバイス コンテキストへのポインター。

pMenuButton
[入力] 画像がレンダリングされているメニュー ボタンへのポインター。

rectImage
[入力] 画像の画面位置とサイズを指定する Rect 構造体へのポインター。

戻り値

TRUE フレームワークがイメージを正常にレンダリングする場合。それ以外の場合 FALSE 。

解説

CFrameWndEx 派生オブジェクトで所有されるメニュー バーに属するメニュー項目の画像レンダリングをカスタマイズする場合は、このメソッドがオーバーライドされます。

CMFCPopupMenu オブジェクトがWM_PAINT メッセージを処理するときにフレームワークによって呼び出されます。

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

パラメーター

pDC
[入力] デバイス コンテキストへのポインター。

pMenu
[入力] メニュー項目へのポインター。

rectLogo
[入力] メニュー ロゴの画面位置とサイズを指定する CRect 定数構造体への参照。

解説

CFrameWndEx 派生オブジェクトで所有されるメニュー バーに属するポップアップ メニューにロゴを表示する場合は、この関数がオーバーライドされます。

CFrameWndEx::OnDWMCompositionChanged

デスクトップ ウィンドウ マネージャー (DWM) コンポジションが有効または無効になったときに、フレームワークによって呼び出されます。

afx_msg LRESULT OnDWMCompositionChanged(
    WPARAM wp,
    LPARAM lp);

パラメーター

wp
[in]このパラメーターは使用されません。

lp
[in]このパラメーターは使用されません。

戻り値

常に 0 を返します。

解説

CFrameWndEx::OnExitSizeMove

フレームの移動またはサイズ変更が停止したときに、フレームワークによって呼び出されます。

LRESULT OnExitSizeMove(
    WPARAM wp,
    LPARAM lp);

パラメーター

wp
[in]このパラメーターは使用されません。

lp
[in]このパラメーターは使用されません。

戻り値

常に 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]このパラメーターは使用されません。

戻り値

常に 0 を返します。

解説

CFrameWndEx::OnLButtonDown

このメソッドは、ユーザーがマウスの左ボタンを押したときに、フレームワークによって呼び出されます。

afx_msg void OnLButtonDown(
    UINT nFlags,
    CPoint point);

パラメーター

nFlags
[入力] ユーザーが修飾キーを押したかどうかが示されます。 使用可能な値については、WM_LBUTTONDOWN Notification のパラメーターwParamを参照してください。

point
[入力] ポインターの x 座標と y 座標をウィンドウの左上隅を基準にして指定します。

解説

CFrameWndEx::OnLButtonUp

このメソッドは、ユーザーがマウスの左ボタンを離したときに、フレームワークによって呼び出されます。

afx_msg void OnLButtonUp(
    UINT nFlags,
    CPoint point);

パラメーター

nFlags
[入力] ユーザーが修飾キーを押したかどうかが示されます。 使用可能な値については、WM_LBUTTONUP Notification のパラメーターwParamを参照してください。

point
[入力] ポインターの x 座標と y 座標をウィンドウの左上隅を基準にして指定します。

解説

CFrameWndEx::OnMenuButtonToolHitTest

CMFCToolBarButton オブジェクトがWM_NCHITTEST メッセージを処理するときにフレームワークによって呼び出されます。

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

パラメーター

pButton
[入力] ツール バー ボタンへのポインター。

pTI
[出力] ツール情報構造体へのポインター。

戻り値

TRUE アプリケーションが pTI パラメーターを入力する場合は。 それ以外の場合 FALSE。

解説

特定のメニュー項目に関するツールヒント情報を提供する場合は、このメソッドがオーバーライドされます。

CFrameWndEx::OnMenuChar

メニューが表示され、ユーザーがコマンドに対応しないキーを押すと、フレームワークによって呼び出されます。

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

パラメーター

nChar
[入力] 押されたキーの文字コード。

nFlags
[in]表示されるメニューがサブメニューの場合は MF_POPUP フラグを格納し、表示されるメニューがコントロール メニューの場合は MF_SYSMENU フラグを格納します。

pMenu
[入力] メニューへのポインター。

戻り値

上位ワードは、次のいずれかの値です。

Value 説明
0 キーストロークが、フレームワークによって無視されます。
1 メニューが、フレームワークによって閉じられます。
2 メニューに表示される項目の 1 つが、フレームワークによって選択されます。 下位ワードには、選択するコマンドの ID が含まれます。

CFrameWndEx::OnMouseMove

このメソッドは、ポインターが移動するときに、フレームワークによって呼び出されます。

afx_msg void OnMouseMove(
    UINT nFlags,
    CPoint point);

パラメーター

nFlags
[入力] ユーザーが修飾キーを押したかどうかが示されます。 使用可能な値については、WM_MOUSEMOVE Notification のパラメーターwParamを参照してください。

point
[in]ウィンドウの左上隅を基準としたポインターの x および y 座標を指定します。

解説

CFrameWndEx::OnMoveMiniFrame

ペイン ウィンドウが移動するときに、フレームワークによって呼び出されます。

virtual BOOL OnMoveMiniFrame(CWnd* pFrame);

パラメーター

pFrame
[in] CPaneFrameWnd クラス ウィンドウへのポインター。

戻り値

TRUE ウィンドウ ウィンドウがドッキングされていない場合。ウィンドウ ウィンドウがドッキングされているかどうかを FALSE します。

解説

CFrameWndEx::OnNcActivate

アクティブな状態の変化を示すためにフレームの非クライアント領域を再描画する必要があるときに、フレームワークによって呼び出されます。

afx_msg BOOL OnNcActivate(BOOL bActive);

パラメーター

bActive
[入力] TRUE フレームをアクティブに描画する場合。フレームを非アクティブに描画する FALSE します。

戻り値

既定の処理を続行する場合は 0 以外の値、非クライアント領域が非アクティブ化されないようにする場合は 0。

解説

CFrameWndEx::OnNcCalcSize

クライアント領域のサイズと位置を計算する必要があるときに、フレームワークによって呼び出されます。

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

パラメーター

bCalcValidRects
[入力] TRUE アプリケーションが有効なクライアント領域を指定する必要がある場合。それ以外の場合は FALSE。

lpncsp
[入力] フレーム寸法の変更を含む NCCALCSIZE_PARAMS 構造体へのポインター。

解説

CFrameWndEx::OnNcHitTest

ポインターが移動するか、マウス ボタンが押される、または離されるときに、フレームワークによって呼び出されます。

afx_msg LRESULT OnNcHitTest(CPoint point);

パラメーター

point
[入力] ポインターの画面座標位置。

戻り値

ポインター ヒット列挙値。 使用可能な値の一覧については、「 WM_NCHITTEST 通知」を参照してください。

解説

CFrameWndEx::OnNcMouseMove

ポインターがクライアント以外の領域に移動するときに、フレームワークによって呼び出されます。

afx_msg void OnNcMouseMove(
    UINT nHitTest,
    CPoint point);

パラメーター

nHitTest
[入力] ポインター ヒット列挙値。 使用可能な値の一覧については、「 WM_NCHITTEST 通知」を参照してください。

point
[入力] ポインターの画面座標位置。

解説

CFrameWndEx::OnNcPaint

クライアント以外の領域を描画する必要があるときに、フレームワークによって呼び出されます。

afx_msg void OnNcPaint();

解説

CFrameWndEx::OnPaneCheck

ペインの表示を制御するために、フレームワークによって呼び出されます。

afx_msg BOOL OnPaneCheck(UINT nID);

パラメーター

nID
[入力] ペインのコントロール ID。

戻り値

TRUE コマンドが処理された場合。コマンド処理を続行 FALSE 。

解説

CFrameWndEx::OnPostPreviewFrame

ユーザーが印刷プレビュー モードを変更するときに、フレームワークによって呼び出されます。

afx_msg LRESULT OnPostPreviewFrame(
    WPARAM wParam,
    LPARAM lParam);

パラメーター

wParam
[in]このパラメーターは使用されません。

lParam
[入力] TRUE フレームが印刷プレビュー モードの場合。印刷プレビュー モードがオフの場合に FALSE します。

戻り値

常に 0 を返します。

解説

CFrameWndEx::OnPowerBroadcast

電源管理イベントが発生したときに、フレームワークによって呼び出されます。

afx_msg LRESULT OnPowerBroadcast(
    WPARAM wp,
    LPARAM lp);

パラメーター

wp
[入力] 電源管理イベント。 使用可能な値の一覧については、「 WM_POWERBROADCAST メッセージ」を参照してください。

lp
[in]このパラメーターは使用されません。

戻り値

既定のウィンドウ プロシージャを呼び出した結果。

解説

CFrameWndEx::OnSetMenu

フレーム ウィンドウ メニューを置き換えるために、フレームワークによって呼び出されます。

afx_msg LRESULT OnSetMenu(
    WPARAM wp,
    LPARAM lp);

BOOL OnSetMenu(HMENU hmenu);

パラメーター

wp
[入力] 新しいフレーム ウィンドウ メニューへのハンドル。

lp
[入力] 新しいウィンドウ メニューへのハンドル。

hmenu
[入力] 新しいフレーム ウィンドウ メニューへのハンドル。

戻り値

LRESULT は、既定のウィンドウ プロシージャを呼び出した結果です。

BOOL は、イベントが処理された場合は TRUE 。それ以外の場合は FALSE。

解説

CFrameWndEx::OnSetPreviewMode

フレームの印刷プレビュー モードを設定するために、フレームワークによって呼び出されます。

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

パラメーター

bPreview
[入力] TRUE 印刷プレビューを有効にする場合。印刷プレビューを無効にする FALSE 。

pState
[入力] CPrintPreviewState フレーム状態構造体へのポインター。

解説

CFrameWndEx::OnSetText

ウィンドウのテキストを設定するために、フレームワークによって呼び出されます。

afx_msg LRESULT OnSetText(
    WPARAM wParam,
    LPARAM lParam);

パラメーター

wParam
[in]このパラメーターは使用されません。

lParam
[入力] ウィンドウのテキストへのポインター。

戻り値

DefWindowProcの呼び出しからの戻り値。

解説

CFrameWndEx::OnShowCustomizePane

QuickCustomizePane が表示されるときに、フレームワークによって呼び出されます。

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

パラメーター

pMenuPane
[入力] クイック カスタマイズ ペインへのポインター。

uiToolbarID
[入力] カスタマイズするツール バーのコントロール ID。

戻り値

このメソッドは常に TRUE を返します。

解説

クイック カスタマイズ メニューは、ツール バーのカスタマイズ ボタンをクリックしたときに表示されるポップアップ メニューです。

CFrameWndEx::OnShowPanes

ペインを表示または非表示するために、フレームワークによって呼び出されます。

virtual BOOL OnShowPanes(BOOL bShow);

パラメーター

bShow
[入力] TRUE アプリケーションにペインが表示される場合は〘。それ以外の場合 FALSE 。

戻り値

このメソッドは常に FALSE を返します。

解説

既定の実装では、 bShow が TRUE され、ペインが非表示になっている場合、または bShow が FALSE され、ペインが表示されている場合に、ペインが表示されます。

既定の実装では、 bShow が TRUE され、ペインが表示されている場合、または bShow が FALSE され、ペインが非表示になっている場合、ペインは非表示になります。

派生クラスでこのメソッドがオーバーライドされて、フレームワークでペインを表示または非表示にするときにカスタム コードが実行されます。

CFrameWndEx::OnShowPopupMenu

ポップアップ メニューが表示されるときに、フレームワークによって呼び出されます。

virtual BOOL OnShowPopupMenu(CMFCPopupMenu* pMenu);

パラメーター

pMenu
[入力] ポップアップ メニューへのポインター。

戻り値

TRUE ポップアップ メニューが表示されている場合は 〗。それ以外の場合は FALSE。

解説

派生クラスでこのメソッドがオーバーライドされて、フレームワークでポップアップ メニューを表示するときにカスタム コードが実行されます。 たとえば、このメソッドがオーバーライドされて、ポップアップ メニューのコマンドの背景色が変更されます。

CFrameWndEx::OnSize

フレームのサイズが変更された後、フレームワークによって呼び出されます。

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

パラメーター

nType
[入力] サイズ変更の種類。 使用可能な値については、「WM_SIZE通知」のパラメーター wParamを参照してください。

cx
[入力] フレームの新しい幅 (ピクセル単位)。

cy
[入力] フレームの新しい高さ (ピクセル単位)。

解説

CFrameWndEx::OnSizing

ユーザーがフレームのサイズを変更したときに、フレームワークによって呼び出されます。

afx_msg void OnSizing(
    UINT fwSide,
    LPRECT pRect);

パラメーター

fwSide
[入力] 移動されるフレームの端。 WM_SIZING通知のパラメーター wParamを参照してください。

pRect
[入力、出力]フレームの座標を含む CRect または RECT 構造体へのポインター。

解説

CFrameWndEx::OnSysColorChange

システムの色が変更されるときに、フレームワークによって呼び出されます。

void OnSysColorChange();

解説

CFrameWndEx::OnTearOffMenu

アプリケーションでティアオフ バーを含むメニューを表示するときに、フレームワークによって呼び出されます。

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

パラメーター

pMenuPopup
[入力] ポップアップ メニューへのポインター。

pBar
[入力] ティアオフ バーへのポインター。

戻り値

TRUE ティアオフ バーが表示されたポップアップ メニューが有効な場合。それ以外の場合は FALSE。

解説

派生クラスでこのメソッドがオーバーライドされて、フレームワークでコントロール バーを表示するときにカスタム コードが実行されます。

既定の実装では何も行われないため、 TRUEが返されます。

CFrameWndEx::OnToolbarContextMenu

ツール バーのポップアップ メニューを構築するために、フレームワークによって呼び出されます。

afx_msg LRESULT OnToolbarContextMenu(
    WPARAM wp,
    LPARAM lp);

パラメーター

wp
[in]このパラメーターは使用されません。

lp
[in]このパラメーターは使用されません。

戻り値

常に 1 が返されます。

解説

CFrameWndEx::OnToolbarCreateNew

このメソッドは、新しいツール バーを作成するために、フレームワークによって呼び出されます。

afx_msg LRESULT OnToolbarCreateNew(
    WPARAM wp,
    LPARAM lp);

パラメーター

wp
[in]このパラメーターは使用されません。

lp
[入力] ツール バーのタイトル バーのテキストへのポインター。

戻り値

新しいツール バーへのポインター。または、ツール バーが作成されていない場合に NULL します。

解説

CFrameWndEx::OnToolbarDelete

ツール バーが削除されるときに、フレームワークによって呼び出されます。

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

パラメーター

unused
[in]このパラメーターは使用されません。

lp
[入力] ツール バーへのポインター。

戻り値

TRUE ツールバーが削除された場合。それ以外の場合は FALSE。

解説

CFrameWndEx::OnUpdateFrameMenu

フレーム メニューを設定するために、フレームワークによって呼び出されます。

virtual void OnUpdateFrameMenu(HMENU hMenuAlt);

パラメーター

hMenuAlt
[入力] 代替メニューへのハンドル。

解説

CFrameWndEx::OnUpdateFrameTitle

このメソッドは、フレーム ウィンドウのタイトル バーを更新するために、フレームワークによって呼び出されます。

virtual void OnUpdateFrameTitle(BOOL bAddToTitle);

パラメーター

bAddToTitle
[入力] TRUE 作業中の文書のタイトルをフレーム ウィンドウのタイトル バーに追加する場合。それ以外の場合は FALSE。

解説

CFrameWndEx::OnUpdatePaneMenu

ペイン メニューを更新するために、フレームワークによって呼び出されます。

afx_msg void OnUpdatePaneMenu(CCmdUI* pCmdUI);

パラメーター

pCmdUI
[入力] ペインのユーザー インターフェイス オブジェクトへのポインター。

解説

CFrameWndEx::OnWindowPosChanged

ウィンドウ管理メソッドの呼び出しによって、フレーム サイズ、位置、または z オーダーが変更されたときに、フレームワークによって呼び出されます。

afx_msg void OnWindowPosChanged(WINDOWPOS FAR* lpwndpos);

パラメーター

lpwndpos
[in]新しいサイズと位置を含む WINDOWPOS 構造体へのポインター。

解説

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
[入力] チェックするポイントの画面座標。

nSensitivity
[入力] ポイントを検索するときに、各コントロール バーの外接矩形をこの量だけ拡大します。

bExactBar
[入力] TRUEnSensitivity パラメーターを無視する場合は &a0/>。それ以外の場合はFALSE。

pRTCBarType
[in] NULLしない場合、メソッドは指定した型のコントロール バーのみを検索します。

dwAlignment
[出力] 成功した場合、このパラメーターには、指定したポイントに最も近いコントロール バーの側が含まれます。 それ以外の場合、このパラメーターは初期化されません。

戻り値

pointを含むコントロール バーへのポインター。コントロールが見つからない場合にNULL。

解説

このメソッドは、アプリケーション内のすべてのコントロール バーで pointを検索します。

nSensitivityを使用して、検索領域のサイズを大きくします。 pRTCBarTypeを使用して、メソッドが検索するコントロール バーの種類を制限します。

CFrameWndEx::PreTranslateMessage

ディスパッチされる前に特定のウィンドウ メッセージを処理します。

virtual BOOL PreTranslateMessage(MSG* pMsg);

パラメーター

pMsg
[in]処理するメッセージを含む MSG 構造体へのポインター。

戻り値

メッセージが処理され、ディスパッチすべきでない場合は 0 以外。メッセージが処理されておらず、ディスパッチする必要がある場合は 0。

解説

CFrameWndEx::RecalcLayout

フレームとその子ウィンドウのレイアウトが調整されます。

virtual void RecalcLayout(BOOL bNotify = TRUE);

パラメーター

bNotify
[入力] OLE クライアント項目にレイアウトの変更について通知するかどうかが指定されます。

解説

このメソッドは、フレーム ウィンドウのサイズが変更されたとき、またはコントロール バーが表示または非表示になったときに呼び出されます。

CFrameWndEx::RemovePaneFromDockManager

ペインを登録解除してドッキング マネージャーから削除します。

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

パラメーター

pControlBar
[入力] 削除するコントロール バー ペインへのポインター。

bDestroy
[入力] TRUE それを削除した後にコントロールバーを破壊する。それ以外の場合 FALSE 。

bAdjustLayout
[入力] TRUE ドッキングレイアウトを調整する。それ以外の場合 FALSE 。

bAutoHide
[入力] TRUE コントロール バーが自動非表示モードの場合。それ以外の場合 FALSE 。

pBarReplacement
[入力] 削除されたペインを置き換えるペインへのポインター。

解説

このメソッドを使用して、フレーム ウィンドウのドッキング レイアウトからコントロール バーを削除します。

CDockingManager クラスはコントロール バーのレイアウトを処理します。 CFrameWndEx::AddPane メソッドまたは CFrameWndEx::InsertPane メソッドを使用して、各コントロール バーをドッキング マネージャーに登録する必要があります。

CFrameWndEx::SetDockState

ドッキング レイアウトをレジストリに格納されているドッキング状態に復元されます。

void SetDockState(const CDockState& state);

パラメーター

state
ドッキング状態。 このパラメーターは無視されます。

CFrameWndEx::SetPrintPreviewFrame

印刷プレビュー フレーム ウィンドウが設定されます。

void SetPrintPreviewFrame(CFrameWnd* pWnd);

パラメーター

pWnd
[入力] 印刷プレビュー フレーム ウィンドウへのポインター。

解説

CFrameWndEx::SetupToolbarMenu

ツール バー メニューにユーザー定義コマンドが挿入されます。

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

パラメーター

menu
[入力] 変更する CMenu オブジェクト。

uiViewUserToolbarCmdFirst
[入力] 最初のユーザー定義コマンド。

uiViewUserToolbarCmdLast
[入力] 最後のユーザー定義コマンド。

解説

フレームワークによって、ユーザー定義のコマンドがリストに格納されます。 uiViewUserToolbarCmdFirstとuiViewUserToolbarCmdListを使用して、挿入するコマンドのインデックスを指定します。

CFrameWndEx::ShowFullScreen

メイン フレームの全画面表示モードと通常モードを切り替えます。

void ShowFullScreen();

CFrameWndEx::ShowPane

指定したペインが表示または非表示になります。

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

パラメーター

pBar
[入力] 表示または非表示にするコントロール バーへのポインター。

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