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 |
オブジェクトがメッセージを処理WM_PAINT するときにCMFCPopupMenu フレームワークによって呼び出されます。 |
CFrameWndEx::OnDWMCompositionChanged |
デスクトップ ウィンドウ マネージャー (DWM) コンポジションが有効または無効になったときに、フレームワークによって呼び出されます。 |
CFrameWndEx::OnExitSizeMove |
フレームの移動またはサイズ変更が停止したときに、フレームワークによって呼び出されます。 |
CFrameWndEx::OnGetMinMaxInfo |
フレームがサイズ変更されてウィンドウの寸法制限を設定するときに、フレームワークによって呼び出されます。 |
CFrameWndEx::OnIdleUpdateCmdUI |
コマンド処理がアイドル状態のときにフレーム表示を更新するために、フレームワークによって呼び出されます。 |
CFrameWndEx::OnLButtonDown |
このメソッドは、ユーザーがマウスの左ボタンを押したときに、フレームワークによって呼び出されます。 |
CFrameWndEx::OnLButtonUp |
このメソッドは、ユーザーがマウスの左ボタンを離したときに、フレームワークによって呼び出されます。 |
CFrameWndEx::OnMenuButtonToolHitTest |
オブジェクトがメッセージを処理WM_NCHITTEST するときにCMFCToolBarButton フレームワークによって呼び出されます。 |
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)|Invokes either the 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;
}
継承階層
必要条件
ヘッダー:afxframewndex.h
CFrameWndEx::ActiveItemRecalcLayout
OLE クライアント項目とフレームのクライアント領域のレイアウトが調整されます。
void ActiveItemRecalcLayout();
解説
CFrameWndEx::AddPane
コントロール バーがドッキング マネージャーに登録されます。
BOOL AddPane(
CBasePane* pControlBar,
BOOL bTail=TRUE);
パラメーター
pControlBar
[入力] 登録するコントロール バー ペイン。
bTail
[in] 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
ペインをドッキングするペインの左側へのポインター。
戻り値
TRUE
が正常にドッキングされた場合 pBar
は 。 それ以外の場合 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
[in] 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
[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
[入力] [カスタマイズ] メニュー項目のコマンド 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
ポインター。
解説
フレーム ウィンドウは、Class オブジェクトをCDockingManager
作成して使用して、子ウィンドウのドッキングを管理します。
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
TRUE
後に挿入pControlBar
する場合は 、FALSE
それ以外のpTarget
場合。
戻り値
TRUE
コントロール バーが正常に挿入および登録された場合は 。 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
[出力] ポイントが配置されている場所。 使用可能な値については、「解説」セクションの表を参照してください。
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
[入力] 境界ネゴシエーション コマンド。 使用可能な値については、「 解説」 セクションを参照してください。
lpRectBorder
[入力、出力] 境界線の寸法。
戻り値
TRUE
レイアウトを再計算する必要がある場合。それ以外の場合は . FALSE
解説
次の表に、パラメーターに使用できる値を nBorderCmd
示します。
borderGet
使用可能な OLE クライアント領域が取得されます。
borderRequest
OLE クライアント領域が要求されます。
borderSet
OLE クライアント領域が設定されます。
CFrameWndEx::OnActivate
このメソッドは、ユーザー入力がフレームに切り替えられたか、離れたときに、フレームワークによって呼び出されます。
afx_msg void OnActivate(
UINT nState,
CWnd* pWndOther,
BOOL bMinimized);
パラメーター
nState
[入力] フレームがアクティブか非アクティブか。 使用可能な値については、「解説」セクションの表を参照してください。
pWndOther
[入力] ユーザー入力を現在のウィンドウに切り替える別のウィンドウへのポインター。
bMinimized
[入力] フレームの最小化の状態。 TRUE
フレームが最小化されている場合。それ以外の場合は . FALSE
解説
次の表に、パラメーターに使用できる値を nState
示します。
Value | 説明 |
---|---|
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]このパラメーターは使用されません。
戻り値
常に 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
閉じようとしているときに、フレームワークからメッセージが送信されます。 ウィンドウを閉じるときにフレームワークから送信されたメッセージをオブジェクトが処理WM_DESTROY
しているときにCMFCPopupMenu
、フレーム ウィンドウに属するオブジェクトからの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
派生オブジェクトで所有されるメニュー バーに属するメニュー項目の画像レンダリングをカスタマイズする場合は、このメソッドがオーバーライドされます。
CFrameWndEx::OnDrawMenuLogo
オブジェクトがメッセージを処理WM_PAINT
するときにCMFCPopupMenu
フレームワークによって呼び出されます。
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
[入力] ユーザーが修飾キーを押したかどうかが示されます。 指定できる値については、Notification のパラメーターwParam
をWM_LBUTTONDOWN
参照してください。
point
[入力] ポインターの x 座標と y 座標をウィンドウの左上隅を基準にして指定します。
解説
CFrameWndEx::OnLButtonUp
このメソッドは、ユーザーがマウスの左ボタンを離したときに、フレームワークによって呼び出されます。
afx_msg void OnLButtonUp(
UINT nFlags,
CPoint point);
パラメーター
nFlags
[入力] ユーザーが修飾キーを押したかどうかが示されます。 指定できる値については、Notification のパラメーターwParam
をWM_LBUTTONUP
参照してください。
point
[入力] ポインターの x 座標と y 座標をウィンドウの左上隅を基準にして指定します。
解説
CFrameWndEx::OnMenuButtonToolHitTest
オブジェクトがメッセージを処理WM_NCHITTEST
するときにCMFCToolBarButton
フレームワークによって呼び出されます。
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
[入力] ユーザーが修飾キーを押したかどうかが示されます。 指定できる値については、Notification のパラメーターwParam
をWM_MOUSEMOVE
参照してください。
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
[in] TRUE
フレームをアクティブに描画する場合。 FALSE
を選択すると、フレームが非アクティブになります。
戻り値
既定の処理を続行する場合は 0 以外の値、非クライアント領域が非アクティブ化されないようにする場合は 0。
解説
CFrameWndEx::OnNcCalcSize
クライアント領域のサイズと位置を計算する必要があるときに、フレームワークによって呼び出されます。
afx_msg void OnNcCalcSize(
BOOL bCalcValidRects,
NCCALCSIZE_PARAMS FAR* lpncsp);
パラメーター
bCalcValidRects
[in] 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
[in] 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
[in] 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
[in] TRUE
アプリケーションにペインが表示される場合は〘。 FALSE
それ以外の場合。
戻り値
このメソッドは常に FALSE
を返します。
解説
既定の実装では、ペインが表示されている場合、ペインが非表示の場合bShow
TRUE
、またはペインが表示されている場合、またはペインがFALSE
表示されるタイミングbShow
が表示されます。
既定の実装では、ペインが表示されている場合、またはペインが表示されている場合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
[入力] 移動されるフレームの端。 Notification のパラメーターwParam
をWM_SIZING
参照してください。
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
[in] 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
[in] TRUE
パラメーターを無視する場合は nSensitivity
〗。それ以外の場合は FALSE
〗。
pRTCBarType
[in]そうでない NULL
場合、メソッドは指定した型のコントロール バーのみを検索します。
dwAlignment
[出力] 成功した場合、このパラメーターには、指定したポイントに最も近いコントロール バーの側が含まれます。 それ以外の場合、このパラメーターは初期化されません。
戻り値
コントロールが見つからない場合は、;NULL
をpoint
含むコントロール バーへのポインター。
解説
このメソッドは、アプリケーション内のすべてのコントロール バーを検索します 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
[in] TRUE
それを削除した後にコントロールバーを破壊する。 FALSE
それ以外の場合。
bAdjustLayout
[in] TRUE
ドッキングレイアウトを調整する。 FALSE
それ以外の場合。
bAutoHide
[in] 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
。
解説
関連項目
フィードバック
https://aka.ms/ContentUserFeedback」を参照してください。
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「フィードバックの送信と表示