CMDIFrameWndEx
クラス
Windows Multiple Document Interface (MDI) フレーム ウィンドウの CMDIFrameWnd
機能を拡張します。
構文
class CMDIFrameWndEx : public CMDIFrameWnd
メンバー
パブリック メソッド
名前 | 説明 |
---|---|
CMDIFrameWndEx::ActiveItemRecalcLayout |
アクティブなアイテムのレイアウトを再計算します。 |
CMDIFrameWndEx::AddDockSite |
このメソッドは使用されません。 |
CMDIFrameWndEx::AddPane |
ペインをドッキング マネージャーに登録します。 |
CMDIFrameWndEx::AdjustClientArea |
罫線を許可するクライアント領域を減らします。 |
CMDIFrameWndEx::AdjustDockingLayout |
ドッキングされたすべてのペインのレイアウトを再計算します。 |
CMDIFrameWndEx::AreMDITabs |
MDI タブ機能と MDI タブ 付きグループ機能のどちらを有効にするかを指定します。 |
CMDIFrameWndEx::CanConvertControlBarToMDIChild |
フレーム ウィンドウがドッキング ウィンドウをタブ付きドキュメントに変換できるかどうかを判断するために、フレームワークによって呼び出されます。 |
CMDIFrameWndEx::ControlBarToTabbedDocument |
指定したドッキング ウィンドウをタブ付きドキュメントに変換します。 |
CMDIFrameWndEx::CreateDocumentWindow |
子ドキュメント ウィンドウを作成します。 |
CMDIFrameWndEx::CreateNewWindow |
新しいウィンドウを作成するためにフレームワークによって呼び出されます。 |
CMDIFrameWndEx::CreateObject |
このクラス型の動的インスタンスを作成するために、フレームワークで使用されます。 |
CMDIFrameWndEx::DockPane |
指定したペインがフレーム ウィンドウにドッキングされます。 |
CMDIFrameWndEx::DockPaneLeftOf |
ウィンドウを別のウィンドウの左側にドッキングします。 |
CMDIFrameWndEx::EnableAutoHidePanes |
メイン フレーム ウィンドウの指定した辺にドッキングされている場合に、ペインの自動非表示モードを有効にします。 |
CMDIFrameWndEx::EnableDocking |
MDI フレーム ウィンドウに属するペインのドッキングを有効にします。 |
CMDIFrameWndEx::EnableFullScreenMainMenu |
メイン メニューを全画面表示モードで表示または非表示にします。 |
CMDIFrameWndEx::EnableFullScreenMode |
フレーム ウィンドウの全画面表示モードを有効にします。 |
CMDIFrameWndEx::EnableLoadDockState |
ドッキング状態の読み込みを有効または無効にします。 |
CMDIFrameWndEx::EnableMDITabbedGroups |
MDI タブ付きグループ機能を有効または無効にします。 |
CMDIFrameWndEx::EnableMDITabs |
MDI タブ機能を有効または無効にします。 有効にすると、フレーム ウィンドウに各 MDI 子ウィンドウのタブが表示されます。 |
CMDIFrameWndEx::EnableMDITabsLastActiveActivation |
ユーザーが現在のタブを閉じるときに、最後にアクティブなタブをアクティブ化するかどうかを指定します。 |
CMDIFrameWndEx::EnablePaneMenu |
アプリケーション ウィンドウの一覧を表示するポップアップ ウィンドウ メニューの自動作成と管理を有効または無効にします。 |
CMDIFrameWndEx::EnableWindowsDialog |
コマンド ID がダイアログ ボックスを呼び出すメニュー項目を CMFCWindowsManagerDialog 挿入します。 |
CMDIFrameWndEx::GetActivePopup |
現在表示されているポップアップ メニューへのポインターを返します。 |
CMDIFrameWndEx::GetPane |
指定したコントロール ID を持つペインへのポインターを返します。 |
CMDIFrameWndEx::GetDefaultResId |
MDI フレーム ウィンドウの共有リソースの ID を返します。 |
CMDIFrameWndEx::GetMDITabGroups |
MDI タブ付きウィンドウの一覧を返します。 |
CMDIFrameWndEx::GetMDITabs |
下線付きのタブ付きウィンドウへの参照を返します。 |
CMDIFrameWndEx::GetMDITabsContextMenuAllowedItems |
MDI タブ付きグループ機能が有効な場合に有効なコンテキスト メニュー項目を決定するフラグの組み合わせを返します。 |
CMDIFrameWndEx::GetMenuBar |
フレーム ウィンドウにアタッチされているメニュー バー オブジェクトへのポインターを返します。 |
CMDIFrameWndEx::GetRibbonBar |
フレームのリボン バー コントロールが取得されます。 |
CMDIFrameWndEx::GetTearOffBars |
破棄状態の派生オブジェクトの CPane 一覧を返します。 |
CMDIFrameWndEx::GetThisClass |
このクラス型に関連付けられているオブジェクトへのポインターを CRuntimeClass 取得するためにフレームワークによって呼び出されます。 |
CMDIFrameWndEx::GetToolbarButtonToolTipText |
アプリケーションでツール バーのボタンのツールヒントを表示するときに、フレームワークによって呼び出されます。 |
CMDIFrameWndEx::InsertPane |
指定されたペインがドッキング マネージャーに登録されます。 |
CMDIFrameWndEx::IsFullScreen |
フレーム ウィンドウが全画面表示モードであるかどうかを判断します。 |
CMDIFrameWndEx::IsMDITabbedGroup |
MDI タブ付きグループ機能が有効かどうかを判断します。 |
CMDIFrameWndEx::IsMemberOfMDITabGroup |
指定したタブ付きウィンドウが、MDI タブ付きグループ内のウィンドウの一覧に含まれているかどうかを判断します。 |
CMDIFrameWndEx::IsMenuBarAvailable |
フレーム ウィンドウにメニュー バーがあるかどうかを指定します。 |
CMDIFrameWndEx::IsPointNearDockSite |
指定されたポイントがドッキング サイトに近いかどうかを決定します。 |
CMDIFrameWndEx::IsPrintPreview |
フレーム ウィンドウが印刷プレビュー モードかどうかを決定します。 |
CMDIFrameWndEx::LoadFrame |
リソース情報からフレーム ウィンドウを作成します。 ( CMDIFrameWnd::LoadFrame をオーバーライドします)。 |
CMDIFrameWndEx::LoadMDIState |
MDI タブ付きグループの指定されたレイアウトと、以前に開いたドキュメントの一覧を読み込みます。 |
CMDIFrameWndEx::MDITabMoveToNextGroup |
アクティブなタブを現在アクティブなタブ付きウィンドウから、次または前のタブ付きグループに移動します。 |
CMDIFrameWndEx::MDITabNewGroup |
1 つのウィンドウを持つ新しいタブ付きグループを作成します。 |
CMDIFrameWndEx::NegotiateBorderSpace |
OLE のインプレース アクティブ化中に、フレーム ウィンドウ内の罫線スペースをネゴシエートします。 |
CMDIFrameWndEx::OnCloseDockingPane |
ユーザーがドッキング可能ウィンドウの [閉じる] ボタンをクリックすると、フレームワークによって呼び出されます。 |
CMDIFrameWndEx::OnCloseMiniFrame |
ユーザーがフローティング ミニ フレーム ウィンドウの [閉じる] ボタンをクリックしたときに、フレームワークによって呼び出されます。 |
CMDIFrameWndEx::OnClosePopupMenu |
アクティブなポップアップ メニューがメッセージを処理 WM_DESTROY するときにフレームワークによって呼び出されます。 |
CMDIFrameWndEx::OnCmdMsg |
コマンド メッセージのルーティングとディスパッチ、およびコマンド ユーザー インターフェイス オブジェクトの更新を行うために、フレームワークによって呼び出されます。 |
CMDIFrameWndEx::OnDrawMenuImage |
メニュー項目に関連付けられているイメージが描画されるときに、フレームワークによって呼び出されます。 |
CMDIFrameWndEx::OnDrawMenuLogo |
メッセージを処理WM_PAINT するときにCMFCPopupMenu フレームワークによって呼び出されます。 |
CMDIFrameWndEx::OnEraseMDIClientBackground |
MDI フレーム ウィンドウがメッセージを処理 WM_ERASEBKGND するときにフレームワークによって呼び出されます。 |
CMDIFrameWndEx::OnMenuButtonToolHitTest |
オブジェクトがメッセージを処理WM_NCHITTEST するときにCMFCToolBarButton フレームワークによって呼び出されます。 |
CMDIFrameWndEx::OnMoveMiniFrame |
ミニフレーム ウィンドウを移動するためにフレームワークによって呼び出されます。 |
CMDIFrameWndEx::OnSetPreviewMode |
アプリケーションのメイン フレーム ウィンドウの印刷プレビュー モードを設定します。 ( CFrameWnd::OnSetPreviewMode をオーバーライドします)。 |
CMDIFrameWndEx::OnShowCustomizePane |
クイック カスタマイズ ウィンドウがアクティブになったときにフレームワークによって呼び出されます。 |
CMDIFrameWndEx::OnShowMDITabContextMenu |
いずれかのタブにコンテキスト メニューを表示する必要がある場合に、フレームワークによって呼び出されます。 (MDI タブ付きグループに対してのみ有効です)。 |
CMDIFrameWndEx::OnShowPanes |
ペインを表示または非表示するために、フレームワークによって呼び出されます。 |
CMDIFrameWndEx::OnShowPopupMenu |
ポップアップ メニューがアクティブにされるときにフレームワークによって呼び出されます。 |
CMDIFrameWndEx::OnSizeMDIClient |
クライアント MDI ウィンドウのサイズが変更されたときにフレームワークによって呼び出されます。 |
CMDIFrameWndEx::OnTearOffMenu |
ティアオフ バーのあるメニューがアクティブ化されるときにフレームワークによって呼び出されます。 |
CMDIFrameWndEx::OnUpdateFrameMenu |
フレーム メニューを更新するためにフレームワークによって呼び出されます。 ( CMDIFrameWnd::OnUpdateFrameMenu をオーバーライドします)。 |
CMDIFrameWndEx::PaneFromPoint |
指定したポイントが含まれるドッキング ウィンドウが返されます。 |
CMDIFrameWndEx::PreTranslateMessage |
クラスCWinApp がウィンドウ メッセージを Windows 関数と DispatchMessage Windows 関数にディスパッチする前に変換するためにTranslateMessage 使用されます。 ( CMDIFrameWnd::PreTranslateMessage をオーバーライドします)。 |
CMDIFrameWndEx::RecalcLayout |
フレーム ウィンドウのレイアウトを再計算するためにフレームワークによって呼び出されます。 ( CFrameWnd::RecalcLayout をオーバーライドします)。 |
CMDIFrameWndEx::RemovePaneFromDockManager |
ペインを登録解除してドッキング マネージャーから削除します。 |
CMDIFrameWndEx::SaveMDIState |
MDI タブ付きグループの現在のレイアウトと、以前に開いたドキュメントの一覧を保存します。 |
CMDIFrameWndEx::SetPrintPreviewFrame |
印刷プレビュー フレーム ウィンドウが設定されます。 |
CMDIFrameWndEx::SetupToolbarMenu |
ダミーの項目を検索して、指定されたユーザー定義の項目で置き換えることで、ツールバーのオブジェクトを変更します。 |
CMDIFrameWndEx::ShowFullScreen |
メインフレームを通常モードから全画面表示モードに切り替えます。 |
CMDIFrameWndEx::ShowPane |
指定したペインが表示または非表示になります。 |
CMDIFrameWndEx::ShowWindowsDialog |
ボックスを CMFCWindowsManagerDialog 作成して開きます。 |
CMDIFrameWndEx::TabbedDocumentToControlBar |
指定したタブ付きドキュメントをドッキング ウィンドウに変換します。 |
CMDIFrameWndEx::UpdateCaption |
ウィンドウ フレーム キャプションを更新するために、フレームワークによって呼び出されます。 |
CMDIFrameWndEx::UpdateMDITabbedBarsIcons |
各 MDI タブ 付きペインのアイコンを設定します。 |
CMDIFrameWndEx::WinHelp |
WinHelp アプリケーションまたはコンテキスト ヘルプを起動するために、フレームワークによって呼び出されます。 ( CWnd::WinHelp をオーバーライドします)。 |
データ メンバー
名前 | 説明 |
---|---|
CMDIFrameWndEx::m_bCanConvertControlBarToMDIChild |
ドッキング ウィンドウを MDI 子ウィンドウに変換できるかどうかを決定します。 |
CMDIFrameWndEx::m_bDisableSetRedraw |
MDI 子ウィンドウの再描画の最適化を有効または無効にします。 |
解説
MDI アプリケーションで拡張カスタマイズ機能を利用するには、アプリケーションの MDI フレーム ウィンドウ クラスをCMDIFrameWndEx
CMDIFrameWnd
派生させます。
例
次の例では、CMDIFrameWndEx
からクラスを派生させます。 このコード スニペットは、DrawClient サンプル: MFC リボン ベースの OLE オブジェクト描画アプリケーションに 由来します。
class CMainFrame : public CMDIFrameWndEx
{
DECLARE_DYNAMIC(CMainFrame)
public:
struct XStyle
{
COLORREF clrFill;
COLORREF clrLine;
};
public:
CMainFrame();
// Attributes
public:
CMFCRibbonBar *GetRibbonBar() { return &m_wndRibbonBar; }
// Operations
public:
void UpdateUI(CDrawView *pCurrView);
void UpdateContextTab(CDrawView *pCurrView);
void UpdateContextTabFromObject(CDrawObjList &list);
COLORREF GetColorFromColorButton(int nButtonID);
int GetWeightFromLineWeight(int nButtonID);
BOOL GetStyleFromStyles(XStyle &style);
void SetRibbonContextCategory(UINT uiCategoryID);
void ActivateRibbonContextCategory(UINT uiCategoryID);
// Implementation
public:
virtual ~CMainFrame();
#ifdef _DEBUG
virtual void AssertValid() const;
virtual void Dump(CDumpContext &dc) const;
#endif
protected:
// control bar embedded members
CMFCRibbonStatusBar m_wndStatusBar;
CMFCRibbonBar m_wndRibbonBar;
CMFCRibbonApplicationButton m_MainButton;
// panel images
CMFCToolBarImages m_PanelImages;
// Document colors for demo:
CList<COLORREF, COLORREF> m_lstMainColors;
CList<COLORREF, COLORREF> m_lstAdditionalColors;
CList<COLORREF, COLORREF> m_lstStandardColors;
// Generated message map functions
protected:
//{{AFX_MSG(CMainFrame)
afx_msg int OnCreate(LPCREATESTRUCT lpCreateStruct);
afx_msg void OnAppLook(UINT id);
afx_msg void OnUpdateAppLook(CCmdUI *pCmdUI);
afx_msg void OnWindowManager();
afx_msg void OnMdiMoveToNextGroup();
afx_msg void OnMdiMoveToPrevGroup();
afx_msg void OnMdiNewHorzTabGroup();
afx_msg void OnMdiNewVertGroup();
afx_msg void OnMdiCancel();
afx_msg LRESULT OnRibbonCustomize(WPARAM wp, LPARAM lp);
afx_msg LRESULT OnHighlightRibbonListItem(WPARAM wp, LPARAM lp);
afx_msg void OnToolsOptions();
afx_msg void OnDummy();
afx_msg void OnSysColorChange();
//}}AFX_MSG
DECLARE_MESSAGE_MAP()
virtual BOOL OnShowMDITabContextMenu(CPoint point, DWORD dwAllowedItems, BOOL bDrop);
virtual BOOL OnShowPopupMenu(CMFCPopupMenu *pMenuPopup);
void ShowOptions(int nPage);
void CreateDocumentColors();
private:
BOOL CreateRibbonBar();
BOOL CreateStatusBar();
void InitMainButton();
void InitHomeCategory();
void InitViewCategory();
void InitTabButtons();
void AddContextTab_Format();
void AdjustObjectSubmenu(CMFCPopupMenu *pMenuPopup);
void UpdateStatusBarCountPane(int nID, CString strText, int nCount);
UINT m_nAppLook;
};
継承階層
必要条件
ヘッダー:afxMDIFrameWndEx.h
CMDIFrameWndEx::ActiveItemRecalcLayout
アクティブなアイテムのレイアウトを再計算します。
void ActiveItemRecalcLayout();
CMDIFrameWndEx::AddPane
ペインをドッキング マネージャーに登録します。
BOOL AddPane(
CBasePane* pControlBar,
BOOL bTail=TRUE);
パラメーター
pControlBar
[in]登録するペインへのポインター。
bTail
[in]このペインをリストの末尾に追加するかどうかを指定します。
戻り値
ペインが正常に登録された場合は、0 以外の値を返します。 ペインがドッキング マネージャーに既に登録されている場合は、0 を返します。
解説
ドッキング レイアウトに参加するには、各ペインを CDockingManager
クラス に登録する必要があります。 特定のウィンドウをドッキングすることをドッキング マネージャーに通知するには、このメソッドを使用します。 そのペインが登録されると、ドッキング マネージャーは、その配置設定と、ドッキング マネージャーメイン含まれるペインの一覧内の位置に基づいて、ペインを配置します。
CMDIFrameWndEx::AdjustClientArea
罫線を許可するクライアント領域を減らします。
virtual void AdjustClientArea();
CMDIFrameWndEx::AdjustDockingLayout
ドッキングされたすべてのペインのレイアウトを再計算します。
virtual void AdjustDockingLayout(HDWP hdwp=NULL);
パラメーター
hdwp
[in]複数ウィンドウ位置構造を識別します。 この値は、次を呼び出 BeginDeferWindowPos
して取得できます。
解説
フレーム ウィンドウにドッキングされているすべてのペインのレイアウトを再計算するには、このメンバー関数を呼び出します。
CMDIFrameWndEx::AreMDITabs
MDI タブ機能と MDI タブ 付きグループ機能のどちらを有効にするかを指定します。
BOOL AreMDITabs(int* pnMDITabsType=NULL) const;
パラメーター
pnMDITabsType
[out]有効になっている機能を示す整数変数へのポインター:
- 0: すべての機能が無効になっています。
- 1: MDI タブが有効になっています。
- 2: MDI タブ付きグループが有効になっています。
戻り値
TRUE
MDI タブまたは MDI タブ付きグループが有効になっているかどうかを返します。
上記の FALSE
機能が有効になっていない場合に返します。
解説
この関数を使用して、MDI タブまたは MDI タブ付きグループがフレーム ウィンドウに対して有効になっているかどうかを確認します。 MDI タブ機能を有効または無効にするために使用 CMDIFrameWndEx::EnableMDITabs
します。
MDI タブ付きグループ機能を有効または無効にするために使用 CMDIFrameWndEx::EnableMDITabbedGroups
します。
CMDIFrameWndEx::CanConvertControlBarToMDIChild
フレーム ウィンドウがドッキング ウィンドウをタブ付きドキュメントに変換できるかどうかを判断するためにフレームワークによって呼び出されます
virtual BOOL CanConvertControlBarToMDIChild();
戻り値
TRUE
フレーム ウィンドウがドッキング ウィンドウをタブ付きドキュメントに変換できる場合に返します。それ以外の場合は 、 を返しますFALSE
。
解説
派生クラスでこのメソッドをオーバーライドし、タブ付きドキュメントへのドッキング ウィンドウの変換を有効にするために戻ります TRUE
。 または、次にTRUE
設定CMDIFrameWndEx::m_bCanConvertControlBarToMDIChild
できます。
CMDIFrameWndEx::ControlBarToTabbedDocument
指定したドッキング ウィンドウをタブ付きドキュメントに変換します。
virtual CMDIChildWndEx* ControlBarToTabbedDocument(CDockablePane* pBar);
パラメーター
pBar
変換するドッキング ウィンドウへのポインター。
戻り値
ドッキング ウィンドウを含む新しい MDI 子ウィンドウへのポインターを返します。
解説
このメソッドは、ドッキング ウィンドウをタブ付きドキュメントに変換します。 このメソッドを呼び出すと、フレームワークによってクラス オブジェクトが作成CMDIChildWndEx
され、ドッキング マネージャーからドッキング ウィンドウが削除され、ドッキング ウィンドウが新しい MDI 子ウィンドウに追加されます。 MDI 子ウィンドウは、クライアント領域全体をカバーするようにドッキング ウィンドウのサイズを変更します
CMDIFrameWndEx::CreateDocumentWindow
子ドキュメント ウィンドウを作成します。
virtual CMDIChildWndEx* CreateDocumentWindow(
LPCTSTR lpcszDocName,
CObject* pObj);
パラメーター
lpcszDocName
[in]ドキュメント識別子を含むテキスト文字列。 通常は、ドキュメント ファイルの完全なパスです。
pObj
[in]ユーザー定義オブジェクトへのポインター。 たとえば、開発者は、ドキュメントを記述し、起動時にドキュメントを初期化する方法を伝えるアプリケーション固有のデータ構造を作成できます。
戻り値
CMDIChildWndEx
を指すポインターです。
解説
フレームワークは、レジストリに以前に保存されたドキュメントの一覧を読み込むときに、このメソッドを呼び出します。
レジストリからドキュメントが読み込まれるときにドキュメントを作成するには、このメソッドをオーバーライドします。
例
次の例は、VisualStudioDemo サンプル: MFC Visual Studio アプリケーションでの使用方法CreateDocumentWindow
を示しています。
この例では、 g_strStartViewName
ディスク ファイルから読み込まれていない "仮想ドキュメント" ("スタート ページ" など) の名前を指定できます。 そのため、そのケースを処理するには特別な処理が必要です。
CMainFrame::CMainFrame()
{
CMFCPopupMenu::SetForceShadow(TRUE);
m_bCanConvertControlBarToMDIChild = TRUE;
}
CMDIFrameWndEx::CreateNewWindow
新しいウィンドウを作成するためにフレームワークによって呼び出されます。
virtual CMDIChildWndEx* CreateNewWindow(
LPCTSTR lpcszDocName,
CObject* pObj);
パラメーター
lpcszDocName
[in]ドキュメント名。
pObj
[入力] 将来の使用のために予約されています。
戻り値
新しいウィンドウへのポインター。
CMDIFrameWndEx::DockPane
指定したペインがフレーム ウィンドウにドッキングされます。
void DockPane(
CBasePane* pBar,
UINT nDockBarID=0,
LPCRECT lpRect=NULL);
パラメーター
pBar
[in]ドッキングするペインへのポインター。
nDockBarID
[in]ドッキング先のフレーム ウィンドウの辺を指定します。
lpRect
[in] 使用されません。
解説
このメソッドは、指定したウィンドウを、呼び出されたときにCBasePane::EnableDocking
CMDIFrameWndEx::EnableDocking
指定されたフレーム ウィンドウのいずれかの辺にドッキングします。
例
DockPane
メソッドの使用例を次に示します。 このコード スニペットは、VisualStudioDemo サンプル: MFC Visual Studio アプリケーションから取得したものです。
DockPane(&m_wndMenuBar);
DockPane(&m_wndToolBar);
DockPane(&m_wndPropertiesBar);
DockPane(&m_wndToolbarBuild);
CMDIFrameWndEx::DockPaneLeftOf
ウィンドウを別のウィンドウの左側にドッキングします。
BOOL DockPaneLeftOf(
CPane* pBar,
CPane* pLeftOf);
パラメーター
pBar
[in]ドッキング ウィンドウへのポインター。
pLeftOf
[in]ドッキング サイトとして機能するペインへのポインター。
戻り値
操作が TRUE
成功した場合に返します。 それ以外の場合は、FALSE
を返します。
解説
このメソッドを呼び出して、複数のペイン オブジェクトをあらかじめ定義した順序でドッキングします。 このメソッドは、指定された pBar
ウィンドウの左側に指定された pLeftOf
ウィンドウをドッキングします。
例
次の例は、VisualStudioDemo サンプル: MFC Visual Studio アプリケーションでのメソッドの使用方法を示していますDockPaneLeftOf
。
DockPane(&m_wndToolbarBuild);
DockPaneLeftOf(&m_wndToolbarEdit, &m_wndToolbarBuild);
CMDIFrameWndEx::EnableAutoHidePanes
ウィンドウがメインフレーム ウィンドウの指定した辺にドッキングされている場合に、ペインの自動非表示モードを有効にします。
BOOL EnableAutoHidePanes(DWORD dwDockStyle);
パラメーター
dwDockStyle
[in]有効にするメイン フレーム ウィンドウの側面を指定します。 次のフラグの 1 つまたは複数を使用します。
CBRS_ALIGN_LEFT
CBRS_ALIGN_RIGHT
CBRS_ALIGN_TOP
CBRS_ALIGN_BOTTOM
戻り値
この関数を呼び出して、ウィンドウがメイン フレーム ウィンドウの指定した辺にドッキングされているときに、ペインの自動非表示モードを有効にします。
例
次の例は、VisualStudioDemo サンプル: MFC Visual Studio アプリケーションでのメソッドの使用方法を示していますEnableAutoHidePanes
。
EnableAutoHidePanes(CBRS_ALIGN_ANY);
解説
CMDIFrameWndEx::EnableDocking
MDI フレーム ウィンドウに属するペインのドッキングを有効にします。
BOOL EnableDocking(DWORD dwDockStyle);
パラメーター
dwDockStyle
[in]適用するドッキング スタイルを指定します。
戻り値
解説
オブジェクトに属するペインのドッキングを有効にするには、この関数を CMDIFrameWndEx
呼び出します。
例
次の例は、VisualStudioDemo サンプル: MFC Visual Studio アプリケーションでのメソッドの使用方法を示していますEnableDocking
。
EnableDocking(CBRS_ALIGN_ANY);
CMDIFrameWndEx::EnableFullScreenMainMenu
メイン メニューを全画面表示モードで表示または非表示にします。
void EnableFullScreenMainMenu(BOOL bEnableMenu);
パラメーター
bEnableMenu
[in] TRUE
をクリックすると、メイン メニューが全画面表示モードで表示されるかFALSE
、非表示になります。
解説
CMDIFrameWndEx::EnableFullScreenMode
フレーム ウィンドウの全画面表示モードを有効にします。
void EnableFullScreenMode(UINT uiFullScreenCmd);
パラメーター
uiFullScreenCmd
[in]全画面表示モードを有効または無効にするコマンドの ID。
解説
全画面表示モードでは、すべてのドッキング コントロール バー、ツールバー、メニューが非表示になり、アクティブなビューのサイズが全画面表示に変更されます。 全画面表示モードを有効にする場合は、有効または無効にするコマンドの ID を指定する必要があります。 メイン フレームの OnCreate
関数から EnableFullScreenMode
を呼び出すことができます。 フレーム ウィンドウを全画面表示モードに切り替えると、フレームワークは、指定されたコマンド ID を持つ 1 つのボタンを含むフローティング ツール バーを作成します。 画面上のメインメニューを維持したい場合は、 CMDIFrameWndEx::EnableFullScreenMainMenu
.
CMDIFrameWndEx::EnableLoadDockState
ドッキング状態の読み込みを有効または無効にします。
void EnableLoadDockState(BOOL bEnable = TRUE);
パラメーター
bEnable
[in] TRUE
ドッキング状態の読み込みを有効にするには、 FALSE
ドッキング状態の読み込みを無効にします。
解説
CMDIFrameWndEx::EnableMDITabbedGroups
フレーム ウィンドウの MDI タブ付きグループ機能を有効または無効にします。
void EnableMDITabbedGroups(
BOOL bEnable,
const CMDITabInfo& params);
パラメーター
bEnable
[in]MDI タブ付きグループ機能が有効になっている場合TRUE
FALSE
は、MDI タブ付きグループ機能が無効になります。
params
[in]MDI クライアント領域で作成される子ウィンドウにフレームワークが適用されるパラメーターを指定します。
解説
MDI タブ付きグループ機能を有効または無効にするには、このメソッドを使用します。 この機能により、MDI アプリケーションは、MDI クライアント領域内で垂直方向または水平方向に配置されたタブ付きウィンドウとして子ウィンドウを表示できます。 タブ付きウィンドウのグループは、スプリッターで分割されます。 ユーザーは、分割器を使用してタブ付きグループのサイズを変更できます。
ユーザーは次のことができます。
- グループ間で個々のタブをドラッグします。
- 個々のタブをウィンドウの端にドラッグして、新しいグループを作成します。
- ショートカット メニューを使用して、タブを移動するか、新しいグループを作成します。
- アプリケーションでは、タブ付きウィンドウの現在のレイアウトと、現在開いているドキュメントの一覧を保存できます。
このメソッドを 、に設定してbEnable
FALSE
params
呼び出した場合は無視されます。
MDI タブ付きグループが既に有効になっている場合でも、このメソッドをもう一度呼び出して、子ウィンドウの設定を変更できます。 パラメーターで bEnable
指定されたオブジェクトのメンバーを TRUE
設定してメソッドを CMDITabInfo
呼び出し、 params
変更します。
MDI タブ付きグループの使用方法の詳細については、「MDI タブ付きグループ」を参照してください。
例
次の例は、VisualStudioDemo サンプル: MFC Visual Studio アプリケーションでの使用方法EnableMDITabbedGroups
を示しています。
CMDITabInfo mdiTabParams;
mdiTabParams.m_bTabCustomTooltips = TRUE;
if (bMDITabsVS2005Look)
{
mdiTabParams.m_style = CMFCTabCtrl::STYLE_3D_VS2005;
mdiTabParams.m_bDocumentMenu = TRUE;
}
else if (bOneNoteTabs)
{
mdiTabParams.m_style = CMFCTabCtrl::STYLE_3D_ONENOTE;
mdiTabParams.m_bAutoColor = bMDITabColors;
}
if (bActiveTabCloseButton)
{
mdiTabParams.m_bTabCloseButton = FALSE;
mdiTabParams.m_bActiveTabCloseButton = TRUE;
}
EnableMDITabbedGroups(TRUE, mdiTabParams);
CMDIFrameWndEx::EnableMDITabs
MDI フレーム ウィンドウの MDI タブ機能を有効または無効にします。 有効にすると、フレーム ウィンドウに各 MDI 子ウィンドウのタブが表示されます。
void EnableMDITabs(
BOOL bEnable=TRUE,
BOOL bIcons=TRUE,
CMFCTabCtrl::Location tabLocation=CMFCTabCtrl::LOCATION_BOTTOM,
BOOL bTabCloseButton=FALSE,
CMFCTabCtrl::Style style=CMFCTabCtrl::STYLE_3D_SCROLLED,
BOOL bTabCustomTooltips=FALSE,
BOOL bActiveTabCloseButton=FALSE);
パラメーター
bEnable
タブを有効にするかどうかを指定します。
bIcons
タブにアイコンを表示するかどうかを指定します。
tabLocation
タブ ラベルの位置を指定します。
bTabCloseButton
タブ閉じるボタンを表示するかどうかを指定します。
style
タブのスタイルを指定します。 通常のタブまたは STYLE_3D_ONENOTE
Microsoft OneNote タブに使用STYLE_3D_SCROLLED
します。
bTabCustomTooltips
カスタム ヒントを有効にするかどうかを指定します。
bActiveTabCloseButton
この場合 TRUE
、タブ領域の 右上隅ではなく、アクティブなタブに [閉じる ] ボタンが表示されます。
解説
MDI フレーム ウィンドウの MDI タブ機能を有効または無効にするには、このメソッドを呼び出します。 有効にすると、すべての子ウィンドウがタブとして表示されます。
タブ ラベルは、パラメーター tabLocation
の設定に応じて、フレームの上部または下部に配置できます。 (既定の設定) または CMFCTabCtrl::LOCATION_TOP
.CMFCTabCtrl::LOCATION_BOTTOM
存在するAFX_WM_ON_GET_TAB_TOOLTIP
場合bTabCustomTooltips
はTRUE
、メイン フレーム ウィンドウにメッセージが送信されます。 コードでこのメッセージを処理し、MDI タブのカスタム ヒントをフレームワークに提供できます。
例
次の例は、MDITabsDemo サンプル: MFC タブ付き MDI アプリケーションでの使用方法EnableMDITabs
を示しています。
void CMainFrame::UpdateMDITabs(BOOL bResetMDIChild)
{
CMDITabInfo params;
HWND hwndActive = NULL;
switch (theApp.m_Options.m_nMDITabsType)
{
case CMDITabOptions::None:
{
BOOL bCascadeMDIChild = FALSE;
if (IsMDITabbedGroup())
{
EnableMDITabbedGroups(FALSE, params);
bCascadeMDIChild = TRUE;
}
else if (AreMDITabs())
{
EnableMDITabs(FALSE);
bCascadeMDIChild = TRUE;
}
if (bCascadeMDIChild)
{
// CMDIClientAreaWnd m_wndClientArea
hwndActive = (HWND)m_wndClientArea.SendMessage(WM_MDIGETACTIVE);
m_wndClientArea.PostMessage(WM_MDICASCADE);
m_wndClientArea.UpdateTabs(false);
m_wndClientArea.SetActiveTab(hwndActive);
::BringWindowToTop(hwndActive);
}
}
break;
case CMDITabOptions::MDITabsStandard:
hwndActive = (HWND)m_wndClientArea.SendMessage(WM_MDIGETACTIVE);
m_wndClientArea.PostMessage(WM_MDIMAXIMIZE, LPARAM(hwndActive), 0L);
::BringWindowToTop(hwndActive);
EnableMDITabs(TRUE, theApp.m_Options.m_bMDITabsIcons, theApp.m_Options.m_bTabsOnTop ? CMFCTabCtrl::LOCATION_TOP : CMFCTabCtrl::LOCATION_BOTTOM, theApp.m_Options.m_nTabsStyle);
GetMDITabs().EnableAutoColor(theApp.m_Options.m_bTabsAutoColor);
GetMDITabs().EnableTabDocumentsMenu(theApp.m_Options.m_bMDITabsDocMenu);
GetMDITabs().EnableTabSwap(theApp.m_Options.m_bDragMDITabs);
GetMDITabs().SetTabBorderSize(theApp.m_Options.m_nMDITabsBorderSize);
GetMDITabs().SetFlatFrame(theApp.m_Options.m_bFlatFrame);
GetMDITabs().EnableCustomToolTips(theApp.m_Options.m_bCustomTooltips);
GetMDITabs().EnableCustomToolTips(theApp.m_Options.m_bCustomTooltips);
GetMDITabs().EnableActiveTabCloseButton(theApp.m_Options.m_bActiveTabCloseButton);
break;
CMDIFrameWndEx::EnableMDITabsLastActiveActivation
ユーザーが現在のタブを閉じるときに、最後にアクティブなタブを開くかどうかを指定します。
void EnableMDITabsLastActiveActivation(BOOL bLastActiveTab=TRUE);
パラメーター
bLastActiveTab
[in]場合 TRUE
は、最後にアクティブなタブのアクティブ化を有効にします。の場合 FALSE
は、最後にアクティブなタブのアクティブ化を無効にします。
解説
アクティブなタブを閉じるときにタブを開くには、次の 2 つの方法があります。
- 次のタブをアクティブにします。
- 以前にアクティブだったタブをアクティブにします。
既定の実装では、最初の方法が使用されます。
タブのアクティブ化の 2 番目の方法を有効にするために使用 EnableMDITabsLastActiveActivation
します。 これは、Windows が MDI 子ウィンドウを開く方法をエミュレートします。
CMDIFrameWndEx::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
は、メニューにツールバーとドッキング バーの一覧が表示されます。
解説
ポップアップ ウィンドウ メニューには、アプリケーションのペインの一覧が表示され、ユーザーは個々のペインを表示または非表示にすることができます。
例
次の例は、VisualStudioDemo サンプル: MFC Visual Studio アプリケーションでの使用方法EnablePaneMenu
を示しています。
// Enable pane context menu(list of bars + customize command):
EnablePaneMenu(TRUE, ID_VIEW_CUSTOMIZE, _T("Customize..."), ID_VIEW_TOOLBARS, FALSE, TRUE);
CMDIFrameWndEx::EnableWindowsDialog
コマンド ID がダイアログ ボックスを呼び出すメニュー項目を CMFCWindowsManagerDialog
挿入します。
void EnableWindowsDialog(
UINT uiMenuId,
LPCTSTR lpszMenuText,
BOOL bShowAllways=FALSE,
BOOL bShowHelpButton=FALSE);
void EnableWindowsDialog(
UINT uiMenuId,
UINT uiMenuTextResId,
BOOL bShowAllways=FALSE,
BOOL bShowHelpButton=FALSE);
パラメーター
uiMenuId
[in]メニューのリソース ID を指定します。
lpszMenuText
[in]アイテムのテキストを指定します。
bShowHelpButton
[in]ウィンドウ管理ダイアログ ボックスに [ヘルプ] ボタンを表示するかどうかを指定します。
uiMenuTextResId
[in]アイテムのテキスト文字列を含む文字列リソース識別子。
解説
このメソッドを使用して、MDI 子ウィンドウ管理ダイアログ ボックス ( CMFCWindowsManagerDialog
クラス) を呼び出すコマンドを持つメニュー項目を挿入します。 によって指定されたメニューに新しい項目が挿入されます uiMenuId
。 メッセージを処理するときに呼び出 EnableWindowsDialog
します WM_CREATE
。
例
次の例は、VisualStudioDemo サンプル: MFC Visual Studio アプリケーションでの使用方法EnableWindowsDialog
を示しています。
// Enable windows manager:
EnableWindowsDialog(ID_WINDOW_MANAGER, _T("Windows..."), TRUE);
CMDIFrameWndEx::GetActivePopup
現在表示されているポップアップ メニューへのポインターを返します。
CMFCPopupMenu* GetActivePopup() const;
戻り値
アクティブなポップアップ メニューへのポインター。 NULL
ポップアップ メニューがアクティブでない場合は 。
解説
この関数を使用して、現在表示されているクラス オブジェクトへのCMFCPopupMenu
ポインターを取得します。
CMDIFrameWndEx::GetDefaultResId
MDI フレーム ウィンドウの共有リソースの ID を返します。
UINT GetDefaultResId() const;
戻り値
リソース ID 値。 フレーム ウィンドウにメニュー バーがない場合は 0。
解説
このメソッドは、MDI フレーム ウィンドウが読み込まれた CFrameWnd::LoadFrame
ときに指定されたリソース ID を返します。
CMDIFrameWndEx::GetMDITabGroups
MDI タブ付きウィンドウの一覧を返します。
const CObList& GetMDITabGroups() const;
戻り値
タブ付きウィンドウの CObList
一覧を含むクラス オブジェクトへの参照。 リストを保存または変更しないでください。
解説
タブ付きウィンドウの一覧にアクセスするには、このメソッドを使用します。 個々のタブ付きウィンドウのパラメーターを変更またはクエリする場合に役立ちます。
CMDIFrameWndEx::GetMDITabs
下線付きのタブ付きウィンドウへの参照を返します。
CMFCTabCtrl& GetMDITabs();
戻り値
下線付きのタブ付きウィンドウへの参照。
CMDIFrameWndEx::GetMDITabsContextMenuAllowedItems
MDI タブ付きグループ機能が有効な場合に有効な操作を決定するフラグの組み合わせを返します。
DWORD GetMDITabsContextMenuAllowedItems();
戻り値
次のフラグのビットごとの "or" (|
) の組み合わせ。
AFX_MDI_CREATE_VERT_GROUP
- 垂直タブ グループを作成できます。AFX_MDI_CREATE_HORZ_GROUP
- 水平タブ グループを作成できます。AFX_MDI_CAN_MOVE_PREV
- タブを前のタブ グループに移動できます。AFX_MDI_CAN_MOVE_NEXT
- タブを次のタブ グループに移動できます。
解説
MDI タブ付きグループ機能が有効になっている場合は、特定のウィンドウのタブで許可される操作を把握しておく必要があります。 このメソッドは、タブ付きウィンドウの現在のレイアウトを分析し、ショートカット メニューなどのビルドに使用できるフラグの組み合わせを返します。
すべてのタブ付きウィンドウが垂直方向に配置されている場合、またはタブ付きウィンドウが 1 つしかない場合は、新しい垂直タブ グループを作成できます。
すべてのタブ付きウィンドウが水平方向に配置されている場合、またはタブ付きウィンドウが 1 つしかない場合は、新しい水平タブ グループを作成できます。
タブ付きウィンドウに複数のタブがある場合にのみ、タブを前のグループに移動できます。
タブを次のグループに移動できるのは、タブ付きウィンドウに複数のタブがある場合のみです。
CMDIFrameWndEx::GetMenuBar
フレーム ウィンドウにアタッチされているメニュー バー オブジェクトへのポインターを返します。
const CMFCMenuBar* GetMenuBar() const;
戻り値
メニュー バー オブジェクトへのポインター。
CMDIFrameWndEx::GetPane
指定したコントロール ID を持つペインへのポインターを返します。
CBasePane* GetPane(UINT nID);
パラメーター
nID
[入力] コントロール ID。
戻り値
指定したコントロール ID を持つペインへのポインター (存在する場合)。 それ以外の場合は NULL
。
CMDIFrameWndEx::GetRibbonBar
フレームのリボン バー コントロールが取得されます。
CMFCRibbonBar* GetRibbonBar();
戻り値
フレームの CMFCRibbonBar
クラス へのポインター。
解説
CMDIFrameWndEx::GetTearOffBars
破棄メニューの一覧を返します。
const CObList& GetTearOffBars() const;
戻り値
破棄状態の派生オブジェクトへのCPane
ポインターのコレクションを含むクラス オブジェクトへの参照CObList
。
解説
CMDIFrameWndEx
メインティアオフ メニューのコレクションが含まれます。 このメソッドを使用して、この一覧への参照を取得します。
CMDIFrameWndEx::GetToolbarButtonToolTipText
アプリケーションでツール バーのボタンのツールヒントを表示するときに、フレームワークによって呼び出されます。
virtual BOOL GetToolbarButtonToolTipText(
CMFCToolBarButton* pButton,
CString& strTTText);
パラメーター
pButton
[入力] ツール バーのボタンへのポインター。
strTTText
[入力] ボタンに表示するツールヒントのテキスト。
戻り値
TRUE
ヒントが表示されている場合は 。 それ以外の場合 FALSE
。
解説
CMDIFrameWndEx::InsertPane
指定されたペインがドッキング マネージャーに登録されます。
BOOL InsertPane(
CBasePane* pControlBar,
CBasePane* pTarget,
BOOL bAfter=TRUE);
パラメーター
pControlBar
[in]挿入するペインへのポインター。
pTarget
[in]ペインを挿入する前または後のペインへのポインター。
bAfter
[in]If TRUE
、 pControlBar
の後 pTarget
に挿入されます。 if FALSE
, pControlBar
が前に pTarget
挿入されます。
戻り値
TRUE
メソッドがウィンドウを正常に登録した場合、 FALSE
ペインがドッキング マネージャーに既に登録されている場合。
解説
このメソッドを使用して、ドッキング マネージャーに指定された pControlBar
ウィンドウについて通知します。 ドッキング マネージャーは、ペインの配置とドッキング マネージャーの内部リスト内の位置に従って、このペインを配置します。
CMDIFrameWndEx::IsFullScreen
フレーム ウィンドウが全画面表示モードであるかどうかを判断します。
BOOL IsFullScreen() const;
戻り値
TRUE
フレームウィンドウが全画面表示モードの場合。それ以外の場合 FALSE
は .
解説
このメソッドを呼び出すと、全画面表示モードを CMDIFrameWndEx::EnableFullScreenMode
設定できます。
CMDIFrameWndEx::IsMDITabbedGroup
MDI タブ付きグループ機能を有効にするかどうかを指定します。
BOOL IsMDITabbedGroup() const;
戻り値
TRUE
MDI タブ付きグループ機能が有効になっている場合。それ以外の場合 FALSE
は .
解説
通常の MDI タブまたは MDI タブ付きグループ機能が有効になっているかどうかを確認するには、次を使用します CMDIFrameWndEx::AreMDITabs
。
CMDIFrameWndEx::IsMemberOfMDITabGroup
指定したタブ付きウィンドウが、MDI タブ付きグループ内のウィンドウの一覧に含まれているかどうかを判断します。
BOOL IsMemberOfMDITabGroup(CWnd* pWnd);
パラメーター
pWnd
[in]タブ付きウィンドウへのポインター。
戻り値
TRUE
指定されたタブ付きウィンドウが、MDI タブ付きグループを形成するタブ付きウィンドウの一覧にある場合。 それ以外の場合 FALSE
は .
CMDIFrameWndEx::IsMenuBarAvailable
フレーム ウィンドウにメニュー バーがあるかどうかを指定します。
BOOL IsMenuBarAvailable() const;
戻り値
TRUE
メニュー バー オブジェクトへのポインターが存在しない NULL
場合は 〗。それ以外の場合 FALSE
は 〘
CMDIFrameWndEx::IsPointNearDockSite
指定されたポイントがドッキング サイトに近いかどうかを決定します。
BOOL IsPointNearDockSite(
CPoint point,
DWORD& dwBarAlignment,
BOOL& bOuterEdge) const;
パラメーター
point
[in]画面座標内の指定したポイント。
dwBarAlignment
[入力] ポイントが近くにある端が示されます。 指定できる値はCBRS_ALIGN_LEFT
、 CBRS_ALIGN_TOP
CBRS_ALIGN_RIGHT
CBRS_ALIGN_BOTTOM
bOuterEdge
[in] TRUE
点がドックサイトの外側の境界線の近くにある場合。 FALSE
それ以外の場合。
戻り値
TRUE
ポイントがドック サイトの近くにある場合。それ以外の場合 FALSE
は .
解説
ドッキング マネージャーで設定された感度内にある場合、ポイントはドッキング サイトの近くにあります。 既定の感度は 15 ピクセルです。
CMDIFrameWndEx::IsPrintPreview
フレーム ウィンドウが印刷プレビュー モードかどうかを決定します。
BOOL IsPrintPreview();
戻り値
TRUE
フレーム ウィンドウが印刷プレビュー モードの場合。それ以外の場合は . FALSE
解説
CMDIFrameWndEx::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
ポインター。 このパラメーターは、NULL
に設定できます。
戻り値
TRUE
メソッドが成功した場合は 〗。それ以外の場合 FALSE
は 〗。
CMDIFrameWndEx::LoadMDIState
MDI タブ付きグループの指定されたレイアウトと、以前に開いたドキュメントの一覧を読み込みます。
virtual BOOL LoadMDIState(LPCTSTR lpszProfileName);
パラメーター
lpszProfileName
[in]プロファイル名を指定します。
戻り値
TRUE
読み込みが成功した場合。 FALSE
読み込みに失敗した場合、または読み込むデータがない場合。
解説
MDI タブとグループの状態と、開いているドキュメントの一覧を読み込むか保存するには、次の操作を行います。
- メイン フレームが閉じているときに呼び出す
CMDIFrameWndEx::SaveMDIState
- メイン フレームの作成時に呼び出
CMDIFrameWndEx::LoadMDIState
します。 この呼び出しの推奨される場所は、メイン フレームが初めて表示される前です。 レジストリに格納された位置にメイン フレームを表示するLoadMDIState
呼び出しの後に追加する前pMainFrame->LoadFrame (IDR_MAINFRAME);.
に追加CWinAppEx::EnableLoadWindowPlacement
(FALSE);
CWinAppEx::ReloadWindowPlacement
(pMainFrame);
します。 - ファイルとして保存されていないドキュメントがアプリケーションに表示される場合は、-派生クラスで
CMDIChildWndEx
オーバーライドGetDocumentName
します。 返された文字列は、ドキュメント識別子としてレジストリに保存されます。 基本実装CMDIChildWndEx::GetDocumentName
から取得CDocument::GetPathName
した値を返します。 - レジストリからドキュメントが読み込まれるときにドキュメントを正しく作成するには、オーバーライド
CMDIFrameWndEx::CreateDocumentWindow
します。 最初のパラメーターは、返された文字列GetDocumentName
です。
例
次の例は、VisualStudioDemo サンプル: MFC Visual Studio アプリケーションでの使用方法LoadMDIState
を示しています。
// Parse command line for standard shell commands, DDE, file open
CCommandLineInfo cmdInfo;
ParseCommandLine(cmdInfo);
if (cmdInfo.m_nShellCommand == CCommandLineInfo::FileNew)
{
if (!pMainFrame->LoadMDIState(GetRegSectionPath()))
{
m_pStartDocTemplate->OpenDocumentFile(NULL);
}
}
else
{
// Dispatch commands specified on the command line
if (!ProcessShellCommand(cmdInfo))
{
return FALSE;
}
}
CMDIFrameWndEx::MDITabMoveToNextGroup
アクティブなタブを現在アクティブなタブ付きウィンドウから、次または前のタブ付きグループに移動します。
void MDITabMoveToNextGroup(BOOL bNext=TRUE);
パラメーター
bNext
[in]場合 TRUE
は、タブを次のタブ付きグループに移動します。 場合 FALSE
は、前のタブ付きグループに移動します。
CMDIFrameWndEx::MDITabNewGroup
1 つのウィンドウを持つ新しいタブ付きグループを作成します。
void MDITabNewGroup(BOOL bVert=TRUE);
パラメーター
bVert
[in]新しいグループの配置を指定します。 この場合 TRUE
、新しいグループは垂直方向に配置されます。 の場合 FALSE
、新しいグループは水平方向に配置されます。
解説
この関数を使用して、新しいタブ付きウィンドウ (新しいタブ付きグループ) を作成し、最初のタブを追加します。
例
次の例は、VisualStudioDemo サンプル: MFC Visual Studio アプリケーションでの使用方法MDITabNewGroup
を示しています。
void CMainFrame::OnMdiNewHorzTabGroup()
{
MDITabNewGroup(FALSE);
}
CMDIFrameWndEx::m_bCanConvertControlBarToMDIChild
ドッキング ウィンドウを MDI 子ウィンドウに変換できるかどうかを指定します。
BOOL m_bCanConvertControlBarToMDIChild;
解説
ドッキング コントロール バーを MDI 子ウィンドウに変換できるかどうかを示します。 このフラグの場合、ユーザーが TRUE
Tabbed Document コマンドを選択すると、フレームワークによって変換が自動的に処理されます。 フラグは保護されており、-derived クラスのCMDIFrameWndEx
コンストラクターで設定m_bCanConvertControlBarToMDIChild
するか、オーバーライドすることによって、このオプションをCanConvertControlBarToMDIChild
明示的に有効にする必要があります。
既定値は FALSE
です。
例
次の例は、VisualStudioDemo サンプル: MFC Visual Studio アプリケーションでの使用方法m_bCanConvertControlBarToMDIChild
を示しています。
CMainFrame::CMainFrame()
{
CMFCPopupMenu::SetForceShadow(TRUE);
m_bCanConvertControlBarToMDIChild = TRUE;
}
CMDIFrameWndEx::m_bDisableSetRedraw
MDI 子ウィンドウの再描画の最適化を有効または無効にします。
AFX_IMPORT_DATA static BOOL m_bDisableSetRedraw;
解説
既定値は TRUE
です。
MDI 子の FALSE
再描画を最適化する場合は、このフラグを設定します。 この場合、フレームワークは、アプリケーションがアクティブなタブを変更するときに、メイン フレームを呼び出SetRedraw (FALSE)
します。
このフラグは、望ましくない影響 (表示されるバックグラウンド アプリケーションなど) を引き起こす可能性があります。 したがって、MDI タブのアクティブ化中に目立つちらつきが発生する場合にのみ、既定値を変更することをお勧めします。
CMDIFrameWndEx::NegotiateBorderSpace
OLE のインプレース アクティブ化中に、フレーム ウィンドウ内の罫線スペースをネゴシエートします。
virtual BOOL NegotiateBorderSpace(
UINT nBorderCmd,
LPRECT lpRectBorder);
パラメーター
nBorderCmd
[in]列挙型 CFrameWnd::BorderCmd
の次のいずれかの値が含まれています。
borderGet
= 1borderRequest
= 2borderSet
= 3
lpRectBorder
[入力、出力]境界線の座標をRECT
CRect
指定する構造体またはクラス オブジェクトへのポインター。
戻り値
メソッドが成功した場合は 0 以外、それ以外の場合は 0。
解説
このメソッドは、OLE 罫線スペース ネゴシエーションの実装です。
CMDIFrameWndEx::OnCloseDockingPane
ユーザーがドッキング可能ウィンドウの [閉じる] ボタンをクリックすると、フレームワークによって呼び出されます。
virtual BOOL OnCloseDockingPane(CDockablePane* pWnd);
パラメーター
pWnd
[in]閉じているウィンドウへのポインター。
戻り値
TRUE
ドッキング ウィンドウを閉じることができる場合は 。 それ以外の場合は FALSE
。
解説
ドッキング ウィンドウの非表示を処理するには、このメソッドをオーバーライドします。 ドッキング ウィンドウが非表示にならないようにする場合に返 FALSE
します。
既定の実装では何も実行せず、返されます TRUE
。
CMDIFrameWndEx::OnCloseMiniFrame
ユーザーがフローティング ミニフレーム ウィンドウの [閉じる] ボタンをクリックすると、フレームワークによって呼び出されます。
virtual BOOL OnCloseMiniFrame(CPaneFrameWnd*);
パラメーター
pWnd
[in]閉じているミニフレーム ウィンドウへのポインター。
戻り値
TRUE
浮動ミニフレーム ウィンドウを閉じることができる場合は 〗。 それ以外の場合は FALSE
。
解説
浮動ミニフレーム ウィンドウの非表示を処理するには、このメソッドをオーバーライドします。 フローティング ミニフレーム ウィンドウが非表示にならないようにする場合に返 FALSE
します。
既定の実装では何も実行せず、返されます TRUE
。
CMDIFrameWndEx::OnClosePopupMenu
アクティブなポップアップ メニューがメッセージを処理 WM_DESTROY
するときにフレームワークによって呼び出されます。
virtual void OnClosePopupMenu(CMFCPopupMenu* pMenuPopup);
パラメーター
pMenuPopup
[in]ポップアップ メニューへのポインター。
解説
MDI フレーム ウィンドウに属するクラス オブジェクトがCMFCPopupMenu
メッセージを処理するときに通知を処理WM_DESTROY
する場合は、このメソッドをオーバーライドします。
CMDIFrameWndEx::OnCmdMsg
コマンド メッセージのルーティングとディスパッチ、およびコマンド ユーザー インターフェイス オブジェクトの更新を行うために、フレームワークによって呼び出されます。
virtual BOOL OnCmdMsg(
UINT nID,
int nCode,
void* pExtra,
AFX_CMDHANDLERINFO* pHandlerInfo);
パラメーター
nID
[入力] コマンド ID。
nCode
[in]コマンド通知コードを識別します。 の値 nCode
の詳細については、 を参照してください CCmdTarget::OnCmdMsg
。
pExtra
[in]の値 nCode
に従って使用されます。 pExtra
の詳細については、「CCmdTarget::OnCmdMsg
」を参照してください。
pHandlerInfo
[入力、出力]通常、このパラメーターは NULL
. そうでないNULL
場合は、OnCmdMsg
コマンドをディスパッチするのではなく、pTarget
構造体のpHandlerInfo
メンバーとpmf
メンバーを入力します。
戻り値
メッセージが処理される場合は 0 以外。それ以外の場合は 0。
CMDIFrameWndEx::OnDrawMenuImage
メニュー項目に関連付けられているイメージが描画されるときに、フレームワークによって呼び出されます。
virtual BOOL OnDrawMenuImage(
CDC* pDC,
const CMFCToolBarMenuButton* pMenuButton,
const CRect& rectImage);
パラメーター
pDC
[in]デバイス コンテキストへのポインター。
pMenuButton
[入力] メニュー ボタンへのポインター。
rectImage
[in]画像の外接する四角形。
戻り値
TRUE
メソッドがイメージを描画する場合は 。 既定の実装では、FALSE
が返されます。
解説
派生オブジェクトが所有するメニュー バーに属するメニュー項目のイメージ レンダリングをカスタマイズする場合は、このメソッドを CMDIFrameWndEx
オーバーライドします。 既定の実装では、何も行われません。
CMDIFrameWndEx::OnDrawMenuLogo
メッセージを処理WM_PAINT
するときにCMFCPopupMenu
フレームワークによって呼び出されます。
virtual void OnDrawMenuLogo(
CDC*,
CMFCPopupMenu*,
const CRect&);
解説
派生オブジェクトが所有するメニュー バーに属するポップアップ メニューにロゴを表示するには、この関数を CMDIFrameWndEx
オーバーライドします。 既定の実装では、何も行われません。
CMDIFrameWndEx::OnEraseMDIClientBackground
MDI フレーム ウィンドウがメッセージを処理 WM_ERASEBKGND
するときにフレームワークによって呼び出されます。
virtual BOOL OnEraseMDIClientBackground(CDC*);
戻り値
TRUE
アプリケーションがメッセージを処理し、バックグラウンドを消去する場合は 。
解説
-derived クラスでメッセージを処理 WM_ERASEBKGND
する場合は、このメンバー関数を CMDIFrameWndEx
オーバーライドします。
CMDIFrameWndEx::OnMenuButtonToolHitTest
オブジェクトがメッセージを処理WM_NCHITTEST
するときにCMFCToolBarButton
フレームワークによって呼び出されます。
virtual BOOL OnMenuButtonToolHitTest(
CMFCToolBarButton* pButton,
TOOLINFO* pTI);
パラメーター
pButton
[in]ツール バー ボタン。
pTI
[out] TOOLINFO
構造体へのポインター。
戻り値
TRUE
アプリケーションがパラメーターを入力する pTI
場合は 。 既定の実装では、FALSE
が返されます。
解説
特定のメニュー項目に関する情報をヒントに提供する場合は、このメソッドをオーバーライドします。 既定の実装では、何も行われません。
CMDIFrameWndEx::OnMoveMiniFrame
ミニフレーム ウィンドウを移動するためにフレームワークによって呼び出されます。
virtual BOOL OnMoveMiniFrame(CWnd* pFrame);
パラメーター
pFrame
[入力] ミニフレーム ウィンドウへのポインター。
戻り値
TRUE
メソッドが成功した場合は 〗。それ以外の場合 FALSE
は 〗。
CMDIFrameWndEx::OnSetPreviewMode
アプリケーションのメイン フレーム ウィンドウの印刷プレビュー モードを設定します。
virtual void OnSetPreviewMode(
BOOL bPreview,
CPrintPreviewState* pState);
パラメーター
bPreview
[in]の場合 TRUE
は、印刷プレビュー モードを設定します。 の場合 FALSE
は、プレビュー モードを取り消します。
pState
[in]構造体への CPrintPreviewState
ポインター。
解説
このメソッドは、CFrameWnd::OnSetPreviewMode
をオーバーライドします。
CMDIFrameWndEx::OnShowCustomizePane
クイック カスタマイズ ウィンドウがアクティブになったときにフレームワークによって呼び出されます。
virtual BOOL OnShowCustomizePane(
CMFCPopupMenu* pMenuPane,
UINT uiToolbarID);
パラメーター
pMenuPane
[in][クイック カスタマイズ] ウィンドウへのポインター。
uiToolbarID
[in]カスタマイズするツール バーのコントロール ID。
戻り値
このメソッドは常に TRUE
を返します。
解説
[クイック カスタマイズ] ウィンドウは、ユーザーがツール バーの [カスタマイズ] をクリックしたときに開くメニューです。
[クイック カスタマイズ] ウィンドウで変更を加えるために、派生クラスでこのメソッドをオーバーライドします。
CMDIFrameWndEx::OnShowMDITabContextMenu
いずれかのタブにショートカット メニューが表示される前に、フレームワークによって呼び出されます。 MDI タブ付きグループにのみ有効です。
virtual BOOL OnShowMDITabContextMenu(
CPoint point,
DWORD dwAllowedItems,
BOOL bTabDrop);
パラメーター
point
[in]画面座標内のメニューの位置。
dwAllowedItems
[in]現在のタブで許可されるアクションを示すフラグのビットごとの "or" (|
) の組み合わせ。
AFX_MDI_CREATE_VERT_GROUP
- 垂直タブ グループを作成できます。AFX_MDI_CREATE_HORZ_GROUP
- 水平タブ グループを作成できます。AFX_MDI_CAN_MOVE_PREV
- タブを前のタブ グループに移動できます。AFX_MDI_CAN_MOVE_NEXT
- タブを次のタブ グループに移動できます。AFX_MDI_CAN_BE_DOCKED
- タブ付きドキュメントをドッキング状態に切り替えます (タブ付きドキュメントにのみ関連します)。
bTabDrop
[in] TRUE
をクリックすると、タブを別のタブ付きグループにドラッグした結果としてメニューが表示されます。 FALSE
をクリックすると、現在アクティブなタブにショートカット メニューとしてメニューが表示されます。
戻り値
派生クラスでこのメソッドを CMDIFrameWndEx
オーバーライドします。
解説
処理 OnShowMDITabContextMenu
しない場合、ショートカット メニューは表示されません。 この関数は、MDI タブ付きグループ機能を有効にすると、MFC アプリケーション ウィザードによって生成されます。
例
次の例は、VisualStudioDemo サンプル: MFC Visual Studio アプリケーションでの使用方法OnShowMDITabContextMenu
を示しています。
BOOL CMainFrame::OnShowMDITabContextMenu(CPoint point, DWORD dwAllowedItems, BOOL bDrop)
{
CMenu menu;
VERIFY(menu.LoadMenu(bDrop ? IDR_POPUP_DROP_MDITABS : IDR_POPUP_MDITABS));
CMenu* pPopup = menu.GetSubMenu(0);
ASSERT(pPopup != NULL);
if ((dwAllowedItems & AFX_MDI_CREATE_HORZ_GROUP) == 0)
{
pPopup->DeleteMenu(ID_MDI_NEW_HORZ_TAB_GROUP, MF_BYCOMMAND);
}
if ((dwAllowedItems & AFX_MDI_CREATE_VERT_GROUP) == 0)
{
pPopup->DeleteMenu(ID_MDI_NEW_VERT_GROUP, MF_BYCOMMAND);
}
if ((dwAllowedItems & AFX_MDI_CAN_MOVE_NEXT) == 0)
{
pPopup->DeleteMenu(ID_MDI_MOVE_TO_NEXT_GROUP, MF_BYCOMMAND);
}
if ((dwAllowedItems & AFX_MDI_CAN_MOVE_PREV) == 0)
{
pPopup->DeleteMenu(ID_MDI_MOVE_TO_PREV_GROUP, MF_BYCOMMAND);
}
if ((dwAllowedItems & AFX_MDI_CAN_BE_DOCKED) == 0)
{
pPopup->DeleteMenu(ID_MDI_TABBED_DOCUMENT, MF_BYCOMMAND);
}
CMFCPopupMenu* pPopupMenu = new CMFCPopupMenu;
pPopupMenu->SetAutoDestroy(FALSE);
pPopupMenu->Create(this, point.x, point.y, pPopup->GetSafeHmenu());
return TRUE;
}
CMDIFrameWndEx::OnShowPanes
ペインを表示または非表示するために、フレームワークによって呼び出されます。
virtual BOOL OnShowPanes(BOOL bShow);
パラメーター
bShow
[in] TRUE
をクリックしてペインを表示し、 FALSE
ペインを非表示にします。
戻り値
TRUE
このメソッドの呼び出しの結果としてペインの状態が変更された場合、 FALSE
ペインが既に指定された bShow
状態にある場合は 、 たとえば、ペインが非表示でbShow
FALSE
、表示されている場合、戻り値は FALSE
.
解説
既定の実装では、最上位レベルのフレーム ウィンドウからツール バーが削除されます。
(TRUE
既定値) の場合CDockingManager::m_bHideDockingBarsInContainerMode
、すべてのドッキング ウィンドウは非表示になります。
CMDIFrameWndEx::OnShowPopupMenu
ポップアップ メニューを開いたときにフレームワークによって呼び出されます。
virtual BOOL OnShowPopupMenu(CMFCPopupMenu*);
戻り値
TRUE
ポップアップ メニューが表示される場合は〘。 それ以外の場合は FALSE
。 既定の実装では、TRUE
が返されます。
解説
ポップアップ メニューのアクティブ化時に特別な処理を実装する場合は、このメソッドをオーバーライドします。 たとえば、通常のメニュー項目をカラー メニュー ボタンに変更する場合は、ティアオフ バーなどを設定します。
既定の実装では、何も行われません。
CMDIFrameWndEx::OnSizeMDIClient
クライアント MDI ウィンドウのサイズが変更されたときにフレームワークによって呼び出されます。
virtual void OnSizeMDIClient(
const CRect& rectOld,
const CRect& rectNew);
パラメーター
rectOld
[in]MDI クライアント ウィンドウの現在のサイズ。
rectNew
[in]MDI クライアント ウィンドウの新しいサイズ。
解説
CMDIFrameWndEx::OnTearOffMenu
ティアオフ バーのあるメニューがアクティブ化されるときにフレームワークによって呼び出されます。
virtual BOOL OnTearOffMenu(
CMFCPopupMenu* pMenuPopup,
CPane* pBar);
パラメーター
pMenuPopup
[in]ポップアップ メニューへのポインター。
pBar
[in]ティアオフ バーへのポインター。
戻り値
TRUE
ティアオフバー付きのポップアップメニューをアクティブ化できるようにする場合。それ以外の場合 FALSE
は . 既定値は、TRUE
です。
解説
ティアオフ バーの特別なセットアップを実装する場合は、この関数をオーバーライドします。 既定の実装では、何も行われません。
CMDIFrameWndEx::OnUpdateFrameMenu
フレーム メニューを更新するためにフレームワークによって呼び出されます。
virtual void OnUpdateFrameMenu(HMENU hMenuAlt);
パラメーター
hMenuAlt
[in]メニューへのハンドル。
CMDIFrameWndEx::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
パラメーターは無視されます。
pRTCBarType
[in]非場合 NULL
、メソッドは指定された型のペインのみを反復処理します。
dwAlignment
[out]ペインが見つかった場合、このパラメーターは、指定したポイントに最も近いペインの側を指定します。
戻り値
ドッキング ウィンドウへのポインター、または NULL
コントロールに指定された point
ポイントが含まれている場合。
解説
呼び出しはクラスにCDockingManager
リダイレクトされます。 詳細については、CDockingManager::ControlBarFromPoint
を参照してください。
CMDIFrameWndEx::RecalcLayout
フレーム ウィンドウのレイアウトを再計算するためにフレームワークによって呼び出されます。
virtual void RecalcLayout(BOOL bNotify = TRUE);
パラメーター
bNotify
[in]フレーム ウィンドウのアクティブなインプレース項目がレイアウト変更の通知を受け取るかどうかを決定します。 場合 TRUE
は、アイテムに通知されます。それ以外の場合 FALSE
は .
解説
このメソッドは、CFrameWnd::RecalcLayout をオーバーライドします。
CMDIFrameWndEx::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
[入力] 削除されたペインを置き換えるペインへのポインター。
解説
ドッキング レイアウトに参加するには、各ペインをドッキング マネージャーに登録する必要があります。 ペインを使用 CMDIFrameWndEx::AddPane
または CMDIFrameWndEx::InsertPane
登録します。
ウィンドウがフレーム ウィンドウのドッキング レイアウトの一部ではなくなった場合は、このメソッドを使用します。
CMDIFrameWndEx::SaveMDIState
MDI タブ付きグループの現在のレイアウトと、以前に開いたドキュメントの一覧を保存します。
virtual BOOL SaveMDIState(LPCTSTR lpszProfileName);
パラメーター
lpszProfileName
[in]プロファイル名を指定します。
戻り値
TRUE
保存に成功した場合。 FALSE
保存に失敗した場合は 。
解説
MDI タブとグループの状態と、開いているドキュメントの一覧を読み込むか保存するには、次の操作を行います。
- メイン フレームが閉じているときに呼び出す
SaveMDIState
- メイン フレームの作成時に呼び出
CMDIFrameWndEx::LoadMDIState
します。 この呼び出しの推奨される場所は、メイン フレームが初めて表示される前です。 - 前に呼び出す
CWinAppEx::EnableLoadWindowPlacement(FALSE);
pMainFrame->LoadFrame (IDR_MAINFRAME);
LoadMDIState
後で呼び出CWinAppEx::ReloadWindowPlacement(pMainFrame)
して、レジストリに格納された位置にメイン フレームを表示します。- ファイルとして保存されていないドキュメントがアプリケーションに表示される場合は、-派生クラスで
CMDIChildWndEx
オーバーライドGetDocumentName
します。 返された文字列は、ドキュメント識別子としてレジストリに保存されます。 詳細については、CMDIChildWndEx::GetDocumentName
を参照してください。 CMDIFrameWndEx::CreateDocumentWindow
オーバーライドすると、レジストリからドキュメントが読み込まれるときにドキュメントが正しく作成されます。 パラメーターCreateDocumentWindow
は、前に返された文字列GetDocumentName
です。
例
次の例は、VisualStudioDemo サンプル: MFC Visual Studio アプリケーションでの使用方法SaveMDIState
を示しています。
void CMainFrame::OnClose()
{
SaveMDIState(theApp.GetRegSectionPath());
CMDIFrameWndEx::OnClose();
}
CMDIFrameWndEx::SetPrintPreviewFrame
印刷プレビュー フレーム ウィンドウが設定されます。
void SetPrintPreviewFrame(CFrameWnd* pWnd);
パラメーター
pWnd
[入力] 印刷プレビュー フレーム ウィンドウへのポインター。
解説
CMDIFrameWndEx::SetupToolbarMenu
ダミー項目をユーザー定義項目に置き換えて、ツール バー オブジェクトを変更します。
void SetupToolbarMenu(
CMenu& menu,
const UINT uiViewUserToolbarCmdFirst,
const UINT uiViewUserToolbarCmdLast);
パラメーター
menu
[in]変更する CMenu
クラス オブジェクトへの参照。
uiViewUserToolbarCmdFirst
[入力] 最初のユーザー定義コマンドを指定します。
uiViewUserToolbarCmdLast
[入力] 最後のユーザー定義コマンドを指定します。
CMDIFrameWndEx::ShowFullScreen
メインフレームを通常モードから全画面表示モードに切り替えます。
void ShowFullScreen();
解説
CMDIFrameWndEx::ShowPane
指定したペインが表示または非表示になります。
void ShowPane(
CBasePane* pBar,
BOOL bShow,
BOOL bDelay,
BOOL bActivate);
パラメーター
pBar
[in]表示または非表示にするペインへのポインター。
bShow
[in] TRUE
をクリックしてペインを表示します。 FALSE
をクリックしてペインを非表示にします。
bDelay
[in] TRUE
ドッキング レイアウトの再計算を遅らせる場合は 。 FALSE
をクリックすると、ドッキング レイアウトが直ちに再計算されます。
bActivate
[in] TRUE
をクリックすると、ペインがアクティブとして表示されます。 FALSE
をクリックすると、ペインが非アクティブとして表示されます。
解説
ウィンドウを表示または非表示にするには、このメソッドを呼び出します。 ペインのドッキングには使用 ShowWindow
しないでください。
例
次の例は、VisualStudioDemo サンプル: MFC Visual Studio アプリケーションでの使用方法ShowPane
を示しています。
void COutputList1::OnViewOutput()
{
CBasePane* pParentBar = DYNAMIC_DOWNCAST(CBasePane, GetOwner());
CFrameWndEx* pMainFrame = DYNAMIC_DOWNCAST(CFrameWndEx, GetTopLevelFrame());
if (pMainFrame != NULL && pParentBar != NULL)
{
pMainFrame->SetFocus();
pMainFrame->ShowPane(pParentBar, FALSE, FALSE, FALSE);
}
}
CMDIFrameWndEx::ShowWindowsDialog
ボックスを CMFCWindowsManagerDialog
作成して開きます。
void ShowWindowsDialog();
例
次の例は、VisualStudioDemo サンプル: MFC Visual Studio アプリケーションでの使用方法ShowWindowsDialog
を示しています。
void CMainFrame::OnWindowManager()
{
ShowWindowsDialog();
}
CMDIFrameWndEx::TabbedDocumentToControlBar
指定したタブ付きドキュメントをドッキング ウィンドウに変換します。
virtual BOOL TabbedDocumentToControlBar(CMDIChildWndEx* pMDIChildWnd);
パラメーター
pMDIChildWnd
ドッキング ウィンドウを含む MDI 子ウィンドウへのポインター。
戻り値
TRUE
メソッドが成功した場合は失敗 FALSE
します。
解説
タブ付きドキュメントをドッキング ウィンドウに変換するには、このメソッドを使用します。 タブ付きドキュメントは、次を使用 CMDIFrameWndEx::ControlBarToTabbedDocument
して作成されている必要があります。
例
次の例は、VisualStudioDemo サンプル: MFC Visual Studio アプリケーションでの使用方法TabbedDocumentToControlBar
を示しています。
void CMainFrame::OnMdiTabbedDocument()
{
CMDIChildWndEx* pMDIChild = DYNAMIC_DOWNCAST(CMDIChildWndEx, MDIGetActive());
if (pMDIChild == NULL)
{
ASSERT(FALSE);
return;
}
TabbedDocumentToControlBar(pMDIChild);
}
CMDIFrameWndEx::UpdateCaption
ウィンドウ フレーム キャプションを更新するために、フレームワークによって呼び出されます。
void UpdateCaption();
解説
CMDIFrameWndEx::UpdateMDITabbedBarsIcons
各 MDI タブ 付きペインのアイコンを設定します。
void UpdateMDITabbedBarsIcons();
CMDIFrameWndEx::WinHelp
WinHelp アプリケーションまたはコンテキスト ヘルプを起動するために、フレームワークによって呼び出されます。
virtual void WinHelp(
DWORD dwData,
UINT nCmd = HELP_CONTEXT);
パラメーター
dwData
[in]で指定されたヘルプの種類に必要なデータを nCmd
指定します。
nCmd
[入力] 要求するヘルプの種類を指定します。 指定できる値とパラメーターに与える影響の詳細については、次を dwData
参照してください WinHelp
。
解説
このメソッドは、CWnd::WinHelp
をオーバーライドします。
関連項目
フィードバック
https://aka.ms/ContentUserFeedback」を参照してください。
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「フィードバックの送信と表示