CMDIChildWndEx クラス

[アーティクル]
10/12/2023

CMDIChildWndEx クラスにより、Windows のマルチドキュメントインターフェイス (MDI) の子ウィンドウの機能が提供されます。 CMDIChildWnd クラスの機能が拡張されます。ある特定の MFC クラスを MDI アプリケーションで使用するときは、フレームワークにこのクラスが必要です。

詳細については、Visual Studio インストールの VC\atlmfc\src\mfc フォルダーにあるソースコードを参照してください。

構文

class CMDIChildWndEx : public CMDIChildWnd

メンバー

パブリックメソッド

名前	説明
CMDIChildWndEx::ActivateTopLevelFrame	アプリケーションをタスクバータブからアクティブ化する必要がある場合に、トップレベルフレームをアクティブ化するために、フレームワークによって内部的に呼び出されます。
`CMDIChildWndEx::AddDockSite`	このメソッドは使用されることも実装されることもありません。
CMDIChildWndEx::AddPane	ペインを追加します。
CMDIChildWndEx::AddTabbedPane	タブ付きペインが追加されます。
CMDIChildWndEx::AdjustDockingLayout	ドッキングレイアウトが調整されます。
CMDIChildWndEx::CanShowOnMDITabs
CMDIChildWndEx::CanShowOnTaskBarTabs	この MDI 子を Windows 7 タスクバータブに表示できるかどうかがフレームワークに示されます。
CMDIChildWndEx::CanShowOnWindowsList	[CMFCWindowsManagerDialog クラス] ダイアログボックスに MDI 子ウィンドウ名を表示できる場合は、TRUE が返されます。それ以外の場合は、FALSE を返します。
`CMDIChildWndEx::CreateObject`	このクラス型の動的インスタンスを作成するために、フレームワークによって呼び出されます。
CMDIChildWndEx::DockPane	ペインがドッキングされます。
CMDIChildWndEx::DockPaneLeftOf	ウィンドウを別のウィンドウの左側にドッキングします。
CMDIChildWndEx::EnableAutoHidePanes	ペインがウィンドウの指定された側にドッキングされている場合に、そのペインの自動非表示モードが有効になります。
CMDIChildWndEx::EnableDocking	子ウィンドウをメインフレームにドッキングできるようにします。
CMDIChildWndEx::EnableTaskbarThumbnailClipRect	タスクバーにウィンドウのサムネイルとして表示する、そのウィンドウのクライアント領域の一部の自動選択が有効または無効になります。
CMDIChildWndEx::GetDockingManager
CMDIChildWndEx::GetDocumentName	MDI 子ウィンドウに表示されるドキュメントの名前が返されます。
CMDIChildWndEx::GetFrameIcon	MDI 子ウィンドウアイコンを取得するために、フレームワークによって呼び出されます。
CMDIChildWndEx::GetFrameText	MDI 子ウィンドウを取得するために、フレームワークによって呼び出されます。
CMDIChildWndEx::GetPane	指定されたコントロール ID でペインが検索されます。
CMDIChildWndEx::GetRelatedTabGroup
CMDIChildWndEx::GetTabbedPane	タブ付きドキュメントに変換された埋め込みドッキングペインへのポインターが返されます。
CMDIChildWndEx::GetTabProxyWnd	Windows 7 タスクバータブに実際に登録されているタブプロキシウィンドウが返されます。
CMDIChildWndEx::GetTaskbarPreviewWnd	Windows 7 タスクバーのサムネイルに表示される子ウィンドウ (通常はビューまたは分割ウィンドウ) を取得する必要があるときに、フレームワークによって呼び出されます。
CMDIChildWndEx::GetTaskbarThumbnailClipRect	タスクバーにウィンドウのサムネイルとして表示する、そのウィンドウのクライアント領域の一部を選択する必要がある場合に、フレームワークによって呼び出されます。
`CMDIChildWndEx::GetThisClass`	このクラス型に関連付けられている CRuntimeClass オブジェクトへのポインターを取得するために、フレームワークによって呼び出されます。
CMDIChildWndEx::GetToolbarButtonToolTipText	ツールバーボタンのツールヒントを取得するために、フレームワークによって呼び出されます。
CMDIChildWndEx::InsertPane	指定されたペインがドッキングマネージャーに登録されます。
CMDIChildWndEx::InvalidateIconicBitmaps	MDI 子のアイコン化されたビットマップ表現が無効になります。
CMDIChildWndEx::IsPointNearDockSite	指定されたポイントがドッキングサイトに近いかどうかを決定します。
CMDIChildWndEx::IsReadOnly	子ウィンドウに表示されるドキュメントが読み取り専用の場合は、TRUE が返されます。それ以外の場合は、FALSE を返します。
CMDIChildWndEx::IsRegisteredWithTaskbarTabs	MDI 子が Windows 7 タスクバータブに正常に登録された場合は、TRUE が返されます。
CMDIChildWndEx::IsTabbedPane	MDI 子ウィンドウにドッキングペインが含まれている場合は、TRUE が返されます。それ以外の場合は、FALSE を返します。
CMDIChildWndEx::IsTaskbarTabsSupportEnabled	MDI 子を Windows 7 タスクバータブに表示できるかどうかが示されます。
CMDIChildWndEx::IsTaskbarThumbnailClipRectEnabled	タスクバーにウィンドウのサムネイルとして表示する、そのウィンドウのクライアント領域の一部の自動選択が有効であるか無効であるかが示されます。
CMDIChildWndEx::m_dwDefaultTaskbarTabPropertyFlags	タブ (MDI 子) が Windows 7 タスクバータブに登録されている場合に、フレームワークによって SetTaskbarTabProperties メソッドに渡されるフラグの組み合わせ。既定の組み合わせは .`STPF_USEAPPTHUMBNAILWHENACTIVE \| STPF_USEAPPPEEKWHENACTIVE`
CMDIChildWndEx::OnGetIconicLivePreviewBitmap	MDI 子のライブプレビューのビットマップを取得する必要がある場合に、フレームワークによって呼び出されます。
CMDIChildWndEx::OnGetIconicThumbnail	MDI 子のアイコン化されたサムネイルのビットマップを取得する必要があるときに、フレームワークによって呼び出されます。
CMDIChildWndEx::OnMoveMiniFrame	ミニフレームウィンドウを移動するためにフレームワークによって呼び出されます。
CMDIChildWndEx::OnPressTaskbarThmbnailCloseButton	ユーザーがタスクバータブサムネイルで [閉じる] ボタンを押したときに、フレームワークによって呼び出されます。
CMDIChildWndEx::OnSetPreviewMode	印刷プレビューモードを開始または終了するために、フレームワークによって呼び出されます。
CMDIChildWndEx::OnTaskbarTabThumbnailActivate	タスクバータブサムネイルで WM_ACTIVATE メッセージを処理する必要があるときに、フレームワークによって呼び出されます。
CMDIChildWndEx::OnTaskbarTabThumbnailMouseActivate	タスクバータブサムネイルで WM_MOUSEACTIVATE メッセージを処理する必要があるときに、フレームワークによって呼び出されます。
CMDIChildWndEx::OnTaskbarTabThumbnailStretch	MDI 子の Windows 7 タスクバータブサムネイルプレビューのビットマップを拡大する必要がある場合に、フレームワークによって呼び出されます。
CMDIChildWndEx::OnUpdateFrameTitle	フレームタイトルを更新するために、フレームワークによって呼び出されます。 ( `CMDIChildWnd::OnUpdateFrameTitle`をオーバーライドします)。
CMDIChildWndEx::PaneFromPoint	特定のポイントを含むペインが返されます。
`CMDIChildWndEx::PreTranslateMessage`	TranslateMessage および DispatchMessage の各 Windows 関数にディスパッチされる前に、ウィンドウメッセージを変換するためにクラス CWinApp で使用されます。 ( CWnd::PreTranslateMessageをオーバーライドします)。
CMDIChildWndEx::RecalcLayout	ウィンドウのレイアウトが再計算されます。
CMDIChildWndEx::RegisterTaskbarTab	MDI 子が Windows 7 タスクバータブに登録されます。
CMDIChildWndEx::RemovePaneFromDockManager	ドッキングマネージャーからペインが削除されます。
CMDIChildWndEx::SetRelatedTabGroup
CMDIChildWndEx::SetTaskbarTabActive	対応する Windows 7 タスクバータブをアクティブにします。
CMDIChildWndEx::SetTaskbarTabOrder	Windows 7 タスクバータブで、指定されたウィンドウの前に MDI 子が挿入されます。
CMDIChildWndEx::SetTaskbarTabProperties	Windows 7 のタスクバータブのプロパティを設定します。
CMDIChildWndEx::SetTaskbarThumbnailClipRect	タスクバーにウィンドウのサムネイルとして表示する、そのウィンドウのクライアント領域の一部を選択するクリッピング四角形を設定するために、フレームワークによって内部的に呼び出されます。
CMDIChildWndEx::ShowPane
CMDIChildWndEx::UnregisterTaskbarTab	Windows 7 タスクバータブから MDI 子が削除されます。
CMDIChildWndEx::UpdateTaskbarTabIcon	Windows 7 タスクバータブのアイコンが更新されます。

解説

MDI アプリケーションで拡張されたドッキング機能を利用するには、CMDIChildWnd ではなく、CMDIChildWndEx からアプリケーションの MDI 子ウィンドウクラスを派生させます。

例

次の例では、CMDIChildWndEx からクラスを派生させます。このコードスニペットは、VisualStudioDemo サンプル: MFC Visual Studio アプリケーションから取得したものです。

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

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

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

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

protected:
   afx_msg int OnCreate(LPCREATESTRUCT lpCreateStruct);

   DECLARE_MESSAGE_MAP()
};

継承階層

要件

ヘッダー: afxMDIChildWndEx.h

CMDIChildWndEx::AddPane

ペインを追加します。

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

パラメーター

pControlBar
[入力] ペインへのポインター。

bTail
[入力] ドッキングマネージャーのペインの一覧の末尾にペインを追加する場合は、TRUE。それ以外の場合は、FALSE。

戻り値

ペインがドッキングマネージャーに正常に登録された場合は TRUE、それ以外の場合は FALSE。

CMDIChildWndEx::AddTabbedPane

タブ付きペインが追加されます。

void AddTabbedPane(CDockablePane* pControlBar);

パラメーター

pControlBar
[入力] ペインへのポインター。

CMDIChildWndEx::AdjustDockingLayout

ドッキングレイアウトが調整されます。

virtual void AdjustDockingLayout(HDWP hdwp = NULL);

パラメーター

hdwp
[入力] 遅延ウィンドウ位置の構造体へのハンドル。

CMDIChildWndEx::CanShowOnMDITabs

virtual BOOL CanShowOnMDITabs();

戻り値

解説

CMDIChildWndEx::CanShowOnWindowsList

[CMFCWindowsManagerDialog クラス] ダイアログボックスに MDI 子ウィンドウ名を表示できるかどうかが指定されます。

virtual BOOL CanShowOnWindowsList();

戻り値

ウィンドウを [Windows] ダイアログボックスに表示できる場合は、TRUE。それ以外の場合は、FALSE。

解説

派生クラスでこのメソッドがオーバーライドされ、ウィンドウを [Windows] ダイアログボックスに表示できない場合は FALSE が返されます。この関数は CMFCWindowsManagerDialog から呼び出されます。

CMDIChildWndEx::DockPane

ペインがドッキングされます。

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

パラメーター

pBar
[入力] ペインへのポインター。

nDockBarID
[入力] ペインの ID。

lpRect
[入力] 四角形へのポインター。

解説

lpRect パラメーターは使用されません。

CMDIChildWndEx::DockPaneLeftOf

ウィンドウを別のウィンドウの左側にドッキングします。

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

パラメーター

pBar
ドッキングされるペインへのポインター。

pLeftOf
参照ポイントとして機能するペインへのポインター。

戻り値

成功した場合は TRUE、失敗した場合は FALSE。

解説

このメソッドでは、pBar で指定されたペインを受け取り、pLeftOf で指定されたペインの左側にドッキングします。

定義済みの順序で複数のペインをドッキングする場合は、このメソッドを呼び出します。

CMDIChildWndEx::EnableAutoHidePanes

ペインがウィンドウの指定された側にドッキングされている場合に、そのペインの自動非表示モードが有効になります。

BOOL EnableAutoHidePanes(DWORD dwDockStyle);

パラメーター

dwDockStyle
[入力] 有効になっているメインフレームウィンドウの辺が指定されます。次のフラグの 1 つまたは複数を使用します。

CBRS_ALIGN_LEFT
CBRS_ALIGN_RIGHT
CBRS_ALIGN_TOP
CBRS_ALIGN_BOTTOM

戻り値

メソッドが成功した場合は TRUE、それ以外の場合は FALSE。

CMDIChildWndEx::EnableDocking

子ウィンドウをメインフレームにドッキングできるようにします。

BOOL EnableDocking(DWORD dwDockStyle);

パラメーター

dwDockStyle
[入力] 有効にするドッキング配置が指定されます。

戻り値

メソッドが成功した場合は TRUE、それ以外の場合は FALSE。

解説

メインフレームへのドッキング配置を有効にするには、このメソッドを呼び出します。 CBRS_ALIGN_ フラグの組み合わせを渡すことができます (詳細については、「CControlBar::EnableDocking」を参照してください)。

CMDIChildWndEx::GetDockingManager

CDockingManager* GetDockingManager();

戻り値

解説

CMDIChildWndEx::GetDocumentName

MDI 子ウィンドウに表示されるドキュメントの名前が返されます。

virtual LPCTSTR GetDocumentName(CObject** pObj);

戻り値

ドキュメントの名前を含む文字列へのポインター。

解説

ドキュメントは、MDI 子ウィンドウに表示されます。一般に、ウィンドウには、ファイルから読み込まれたデータまたはファイルに保存されたデータが表示されます。したがって、ドキュメントの名前はファイルの名前です。 GetDocumentName の既定の実装では、CDocument::GetPathName から取得された文字列が返されます。

ファイルから読み込まれないドキュメントがウィンドウに表示される場合は、派生クラスでこのメソッドがオーバーライドされ、一意のドキュメント識別子が返されます。

GetDocumentName は、開いているすべてのドキュメントの状態を保存するときに、フレームワークによって呼び出されます。返される文字列はレジストリに書き込まれます。

フレームワークによって後で状態が復元されるときに、ドキュメント名がレジストリから読み取られ、CMDIFrameWndEx::CreateDocumentWindow に渡されます。 CMDIFrameWndEx 派生クラスでこのメソッドがオーバーライドされ、この名前を持つドキュメントが作成されるか開かれて、この名前を持つファイルで読み取られます。ドキュメントがファイルに基づいていない場合は、ドキュメント識別子自体に基づいてドキュメントが作成されます。ドキュメントを保存および復元する場合にのみ、上記の操作を行う必要があります。

例

GetDocumentName メソッドの使用例を次に示します。このコードスニペットは、VisualStudioDemo サンプル: MFC Visual Studio アプリケーションから取得したものです。

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

CMDIChildWndEx::GetFrameIcon

MDI 子ウィンドウのアイコンを取得するために、フレームワークによって呼び出されます。

virtual HICON GetFrameIcon() const;

戻り値

ウィンドウアイコンへのハンドル。

解説

このメソッドは、MDI 子フレームウィンドウを含む MDI タブに表示するアイコンを決定するために、フレームワークによって呼び出されます。

既定では、このメソッドからウィンドウアイコンが返されます。 CMDIChildWndEx 派生クラスで GetFrameIcon がオーバーライドされて、この動作がカスタマイズされます。

CMDIChildWndEx::GetFrameText

MDI 子ウィンドウを取得するために、フレームワークによって呼び出されます。

virtual CString GetFrameText() const;

戻り値

フレームウィンドウのテキストを含む文字列。

解説

このメソッドは、MDI 子フレームウィンドウを含む MDI タブに表示するテキストを決定するために、フレームワークによって呼び出されます。

既定では、このメソッドからウィンドウテキストが返されます。 CMDIChildWndEx 派生クラスで GetFrameText がオーバーライドされて、この動作がカスタマイズされます。

CMDIChildWndEx::GetPane

指定されたコントロール ID でペインが検索されます。

CBasePane* GetPane(UINT nID);

パラメーター

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

戻り値

見つかった場合はペインへのポインター。それ以外の場合は NULL。

CMDIChildWndEx::GetRelatedTabGroup

CMFCTabCtrl* GetRelatedTabGroup();

戻り値

解説

CMDIChildWndEx::GetTabbedPane

MDI タブ付きドキュメントのグループの一部であるドッキングペインへのポインターが返されます。

CDockablePane* GetTabbedPane() const;

戻り値

MDI タブ付きドキュメントのグループの一部であるドッキングペインへのポインター。

CMDIChildWndEx::GetToolbarButtonToolTipText

ツールバーボタンのツールヒントを取得するために、フレームワークによって呼び出されます。

virtual BOOL GetToolbarButtonToolTipText(
    CMFCToolBarButton*,
    CString&);

戻り値

ツールヒントが表示されている場合は TRUE。既定の実装では FALSE が返されます。

解説

ツールバーボタンのカスタムツールヒントを表示する場合は、このメソッドがオーバーライドされます。

CMDIChildWndEx::InsertPane

指定されたペインがドッキングマネージャーに登録されます。

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

パラメーター

pControlBar
[入力] 挿入するペインへのポインター。

pTarget
[入力] 隣接するペインへのポインター。

bAfter
[入力] TRUE の場合、pControlBar は pTarget の後に挿入されます。 [入力] FALSE の場合、pControlBar は pTarget の前に挿入されます。

戻り値

メソッドが成功した場合は TRUE、それ以外の場合は FALSE。

CMDIChildWndEx::IsPointNearDockSite

指定されたポイントがドッキングサイトに近いかどうかを決定します。

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

パラメーター

point
[入力] 指定されたポイント。

dwBarAlignment
[入力] ポイントが近くにある端が示されます。使用可能な値は CBRS_ALIGN_LEFT、CBRS_ALIGN_RIGHT、CBRS_ALIGN_TOP、CBRS_ALIGN_BOTTOM です

bOuterEdge
[入力] ポイントがドッキングサイトの外側の境界線の近くにある場合は TRUE。それ以外の場合は FALSE。

戻り値

ポイントがドッキングサイトの近くにある場合は TRUE。それ以外の場合は FALSE。

解説

ドッキングマネージャーで設定された感度内にある場合、ポイントはドッキングサイトの近くにあります。既定の感度は 15 ピクセルです。

CMDIChildWndEx::IsReadOnly

子ウィンドウに表示されるドキュメントが読み取り専用かどうかが示されます。

virtual BOOL IsReadOnly();

戻り値

ドキュメントが読み取り専用の場合は TRUE。それ以外の場合は FALSE。

解説

この関数は、読み取り専用ドキュメントが保存されないようにするために使用されます。

例

次の例では、IsReadOnly メソッドをオーバーライドする方法が示されます。このコードスニペットは、VisualStudioDemo サンプル: MFC Visual Studio アプリケーションから取得したものです。

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

CMDIChildWndEx::IsTabbedPane

MDI 子ウィンドウにドッキングペインが含まれているかどうかが示されます。

BOOL IsTabbedPane() const;

戻り値

MDI 子ウィンドウに、タブ付きドキュメントに変換されたドッキングペインが含まれている場合は TRUE。それ以外の場合は FALSE。

CMDIChildWndEx::OnMoveMiniFrame

ミニフレームウィンドウを移動するためにフレームワークによって呼び出されます。

virtual BOOL OnMoveMiniFrame(CWnd* pFrame);

パラメーター

pFrame
[入力] ミニフレームウィンドウへのポインター。

戻り値

このメソッドが成功した場合は TRUE、それ以外の場合は FALSE。

CMDIChildWndEx::OnSetPreviewMode

印刷プレビューモードを開始または終了するために、フレームワークによって呼び出されます。

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

パラメーター

bPreview
[入力] TRUE の場合は、印刷プレビューモードを開始します。 FALSE の場合は、印刷プレビューモードを終了します。

pState
[入力] 印刷プレビュー状態の構造体へのポインター。

CMDIChildWndEx::OnUpdateFrameTitle

フレームタイトルを更新するために、フレームワークによって呼び出されます。

virtual void OnUpdateFrameTitle(BOOL bAddToTitle);

パラメーター

bAddToTitle
[入力] TRUE の場合は、ドキュメント名をタイトルに追加します。

CMDIChildWndEx::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
[入力] "nSensitivity パラメーターを無視する場合は " TRUE、それ以外の場合は FALSE。

pRTCBarType
[入力] NULL 以外の場合、メソッドで指定された型のペインのみが検索されます。

dwAlignment
[入力] 指定されたポイントでペインが見つかった場合、このパラメーターには、その指定されたポイントに最も近かったペインの側が含まれます。詳細については、「解説」を参照してください。

戻り値

特定のポイントを含む CBasePane 派生オブジェクトへのポインター。ペインが見つからなかった場合は NULL。

解説

このメソッドを呼び出して、ランタイムクラスや可視性などの指定された条件に従って、指定されたポイントがペインに含まれているかどうかを判断します。

関数が戻り、ペインが見つかった場合、dwAlignment には指定されたポイントの配置が含まれます。たとえば、ポイントがペインの上側に最も近い場合、dwAlignment は CBRS_ALIGN_TOP に設定されます。

CMDIChildWndEx::RecalcLayout

ウィンドウのレイアウトが再計算されます。

virtual void RecalcLayout(BOOL bNotify = TRUE);

パラメーター

bNotify
[入力] TRUE の場合、ウィンドウのアクティブなインプレース項目ではレイアウト変更の通知を受け取ります。

CMDIChildWndEx::RemovePaneFromDockManager

ドッキングマネージャーからペインが削除されます。

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

パラメーター

pControlBar
[入力] 削除するペインへのポインター。

bDestroy
[入力] TRUE の場合、削除されたペインが破棄されます。

bAdjustLayout
[入力] TRUE の場合は、ドッキングレイアウトをすぐに調整します。

bAutoHide
[入力] TRUE の場合、ドッキングレイアウトは自動非表示バーの一覧に関連します。 FALSE の場合、ドッキングレイアウトは通常のペインの一覧に関連します。

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

CMDIChildWndEx::SetRelatedTabGroup

void SetRelatedTabGroup(CMFCTabCtrl* p);

パラメーター

[入力] p

解説

CMDIChildWndEx::ShowPane

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

パラメーター

[入力] pBar

[入力] bShow

[入力] bDelay

[入力] bActivate

解説

CMDIChildWndEx::UpdateTaskbarTabIcon

Windows 7 タスクバータブのアイコンが更新されます。

virtual void UpdateTaskbarTabIcon(HICON hIcon);

パラメーター

hIcon
Windows 7 タスクバータブに表示するアイコンへのハンドル。

解説

CMDIChildWndEx::UnregisterTaskbarTab

Windows 7 タスクバータブから MDI 子が削除されます。

void UnregisterTaskbarTab(BOOL bCheckRegisteredMDIChildCount = TRUE);

パラメーター

bCheckRegisteredMDIChildCount
MDI タブに登録されている MDI 子の数を、この関数で確認する必要があるかどうかが指定されます。この数値が 0 の場合、この関数では、アプリケーションのタスクバーサムネイルからクリッピング四角形が削除されます。

解説

CMDIChildWndEx::SetTaskbarThumbnailClipRect

タスクバーにウィンドウのサムネイルとして表示する、そのウィンドウのクライアント領域の一部を選択するクリッピング四角形を設定するために、フレームワークによって呼び出されます。

virtual BOOL SetTaskbarThumbnailClipRect(CRect rect);

パラメーター

rect
新しいクリッピング四角形が指定されます。四角形が空または null の場合、クリッピングは削除されます。

戻り値

成功した場合は TRUE、それ以外の場合は FALSE。

解説

CMDIChildWndEx::SetTaskbarTabProperties

Windows 7 のタスクバータブのプロパティを設定します。

void SetTaskbarTabProperties(DWORD dwFlags);

パラメーター

dwFlags
STPFLAG の値の組み合わせ。詳細については、「ITaskbarList4::SetTabProperties」を参照してください。

解説

CMDIChildWndEx::SetTaskbarTabOrder

Windows 7 タスクバータブで、指定されたウィンドウの前に MDI 子を挿入します。

void SetTaskbarTabOrder(CMDIChildWndEx* pWndBefore = NULL);

パラメーター

pWndBefore
サムネイルが左側に挿入される MDI 子ウィンドウへのポインター。このウィンドウは、RegisterTaskbarTab を通じて既に登録されている必要があります。この値が NULL の場合、新しいサムネイルが一覧の末尾に追加されます。

解説

CMDIChildWndEx::SetTaskbarTabActive

対応する Windows 7 タスクバータブがアクティブになります。

void SetTaskbarTabActive();

解説

CMDIChildWndEx::RegisterTaskbarTab

MDI 子が Windows 7 タスクバータブに登録されます。

virtual void RegisterTaskbarTab(CMDIChildWndEx* pWndBefore = NULL);

パラメーター

解説

CMDIChildWndEx::OnTaskbarTabThumbnailStretch

MDI 子の Windows 7 タスクバータブサムネイルプレビューのビットマップを拡大する必要がある場合に、フレームワークによって呼び出されます。

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

パラメーター

hBmpDst
対象のビットマップへのハンドル。

rectDst
対象の四角形が指定されます。

hBmpSrc
ソースのビットマップへのハンドル。

rectSrc
ソースの四角形が指定されます。

解説

必要条件: afxmdichildwndex.h

CMDIChildWndEx::OnTaskbarTabThumbnailMouseActivate

タスクバータブサムネイルで WM_MOUSEACTIVATE メッセージを処理する必要があるときに、フレームワークによって呼び出されます。

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

パラメーター

pDesktopWnd
アクティブ化されるウィンドウのトップレベルの親ウィンドウへのポインターが指定されます。ポインターは一時的なものである可能性があるため、格納しないでください。

nHitTest
ヒットテスト領域コードが指定されます。ヒットテストは、カーソルの位置を判断するテストです。

message
マウスのメッセージ番号が指定されます。

解説

既定の実装では、関連する MDI 子フレームがアクティブになります。

CMDIChildWndEx::OnTaskbarTabThumbnailActivate

タスクバータブサムネイルで WM_ACTIVATE メッセージを処理する必要があるときに、フレームワークによって呼び出されます。

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

パラメーター

nState
CWnd がアクティブ化または非アクティブ化されているかどうかが示されます。

pWndOther
アクティブ化または非アクティブ化されている CWnd へのポインター。ポインターは NULL にすることができます。これは一時的なものである可能性があります。

bMinimized
アクティブ化または非アクティブ化されている CWnd の最小化された状態が示されます。値が TRUE の場合は、ウィンドウが最小化されていることが示されます。

解説

既定の実装では、関連する MDI 子フレームがアクティブになります。

CMDIChildWndEx::OnPressTaskbarThmbnailCloseButton

ユーザーがタスクバータブサムネイルで [閉じる] ボタンを押したときに、フレームワークによって呼び出されます。

virtual void OnPressTaskbarThmbnailCloseButton();

解説

CMDIChildWndEx::OnGetIconicThumbnail

MDI 子のアイコン化されたサムネイルのビットマップを取得する必要があるときに、フレームワークによって呼び出されます。

virtual HBITMAP OnGetIconicThumbnail(
    int nWidth,
    int nHeight);

パラメーター

nWidth
必要なビットマップの幅が指定されます。

nHeight
必要なビットマップの高さが指定されます。

解説

CMDIChildWndEx::OnGetIconicLivePreviewBitmap

MDI 子のライブプレビューのビットマップを取得する必要がある場合に、フレームワークによって呼び出されます。

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

パラメーター

bIsMDIChildActive
現在アクティブであり、メインウィンドウが最小化されていない MDI 子に対してビットマップが要求されている場合、このパラメーターは TRUE です。この場合の既定の処理では、メインウィンドウのスナップショットが取得されます。

ptLocation
メイン (トップレベル) ウィンドウのクライアント座標におけるビットマップの位置が指定されます。このポイントは、呼び出し先によって指定される必要があります。

戻り値

処理された場合、有効な 32 bpp ビットマップへのハンドルが、それ以外の場合は NULL が返されます。

解説

派生クラスでこのメソッドがオーバーライドされ、MDI 子のライブプレビューの有効な 32 bpp ビットマップが返されます。このメソッドは、MDI 子が Windows 7 タスクバータブに表示される場合にのみ呼び出されます。 NULL を返すと、MFC により既定のハンドラーが呼び出され、PrintClient または PrintWindow を使用してビットマップが取得されます。

CMDIChildWndEx::m_dwDefaultTaskbarTabPropertyFlags

タブ (MDI 子) が Windows 7 タスクバータブに登録されている場合に、フレームワークによって SetTaskbarTabProperties メソッドに渡されるフラグの組み合わせ。

AFX_IMPORT_DATA static DWORD m_dwDefaultTaskbarTabPropertyFlags;

解説

既定の組み合わせは .STPF_USEAPPTHUMBNAILWHENACTIVE | STPF_USEAPPPEEKWHENACTIVE

CMDIChildWndEx::IsTaskbarThumbnailClipRectEnabled

タスクバーにウィンドウのサムネイルとして表示する、そのウィンドウのクライアント領域の一部の自動選択が有効であるか無効であるかが示されます。

BOOL IsTaskbarThumbnailClipRectEnabled() const;

戻り値

表示するウィンドウのクライアント領域の一部の自動選択が有効である場合は、TRUE、それ以外の場合は FALSE が返されます。

解説

CMDIChildWndEx::IsTaskbarTabsSupportEnabled

MDI 子を Windows 7 タスクバータブに表示できるかどうかが示されます。

BOOL IsTaskbarTabsSupportEnabled();

戻り値

MDI 子が Windows 7 のタスクバータブに表示される場合は TRUE。FAL Standard Edition MDI 子が Windows 7 タスクバータブに表示されない場合。

解説

CMDIChildWndEx::IsRegisteredWithTaskbarTabs

MDI 子が Windows 7 タスクバータブに正常に登録された場合は、TRUE が返されます。

BOOL IsRegisteredWithTaskbarTabs();

戻り値

MDI 子が Windows 7 タスクバータブに登録されている場合は TRUE。それ以外の場合は FALSE。

解説

CMDIChildWndEx::InvalidateIconicBitmaps

MDI 子のアイコン化されたビットマップ表現が無効になります。

BOOL InvalidateIconicBitmaps();

戻り値

Windows 7 タスクバーのサポートが無効になっている場合、または MDI 子が Windows 7 タスクバータブに登録されていない場合は FALSE が返されます。それ以外の場合は TRUE が返されます。

解説

MDI 子のライブコンテンツまたはサイズが変更された場合に呼び出す必要があります。

CMDIChildWndEx::GetTaskbarThumbnailClipRect

タスクバーにウィンドウのサムネイルとして表示する、そのウィンドウのクライアント領域の一部を選択する必要がある場合に、フレームワークによって呼び出されます。

virtual CRect GetTaskbarThumbnailClipRect() const;

戻り値

ウィンドウ座標の四角形。この四角形は、トップレベルフレームのクライアント領域にマップされます。クリッピング四角形をクリアするには、四角形を空にする必要があります。

解説

CMDIChildWndEx::GetTaskbarPreviewWnd

Windows 7 タスクバーサムネイルに表示される子ウィンドウ (通常はビューまたは分割ウィンドウ) を取得する必要があるときに、フレームワークによって呼び出されます。

virtual CWnd* GetTaskbarPreviewWnd();

戻り値

CWnd オブジェクトへの有効なポインターを返す必要があります。このオブジェクトのプレビューは、この MDI 子に関連する Windows 7 タスクバータブに表示される必要があります。既定の実装では、AFX_IDW_PANE_FIRST コントロール ID (通常は CView 派生クラス) を持つこの MDI 子の子ウィンドウが返されます。

解説

CMDIChildWndEx::GetTabProxyWnd

Windows 7 タスクバータブに登録されているタブプロキシウィンドウが返されます。

CMDITabProxyWnd* GetTabProxyWnd();

戻り値

Windows 7 タスクバータブに登録されている、CMDITabProxyWnd オブジェクトへのポインター。

解説

CMDIChildWndEx::EnableTaskbarThumbnailClipRect

タスクバーにウィンドウのサムネイルとして表示する、そのウィンドウのクライアント領域の一部の自動選択が有効または無効になります。

void EnableTaskbarThumbnailClipRect(BOOL bEnable = TRUE);

パラメーター

bEnable
表示するウィンドウのクライアント領域の一部の自動選択を有効にする (TRUE) か、無効にする (FALSE) かが指定されます。

解説

CMDIChildWndEx::CanShowOnTaskBarTabs

この MDI 子を Windows 7 タスクバータブに表示できるかどうかがフレームワークに示されます。

virtual BOOL CanShowOnTaskBarTabs();

戻り値

MDI 子のコンテンツを Windows 7 タスク　バーのサムネイルに表示できる場合は TRUE。

解説

派生クラスでこのメソッドがオーバーライドされ、FALSE が返されて、Windows 7 タスクバータブでのこの MDI 子の表示が無効になります。

CMDIChildWndEx::ActivateTopLevelFrame

アプリケーションがタスクバータブからアクティブ化される場合に、トップレベルフレームをアクティブ化するために、フレームワークによって呼び出されます。

virtual void ActivateTopLevelFrame();

Share via

CMDIChildWndEx クラス

構文

メンバー

パブリック メソッド

解説

例

継承階層

要件

CMDIChildWndEx::AddPane

パラメーター

戻り値

CMDIChildWndEx::AddTabbedPane

パラメーター

CMDIChildWndEx::AdjustDockingLayout

パラメーター

CMDIChildWndEx::CanShowOnMDITabs

戻り値

解説

CMDIChildWndEx::CanShowOnWindowsList

戻り値

解説

CMDIChildWndEx::DockPane

パラメーター

解説

CMDIChildWndEx::DockPaneLeftOf

パラメーター

戻り値

解説

CMDIChildWndEx::EnableAutoHidePanes

パラメーター

戻り値

CMDIChildWndEx::EnableDocking

パラメーター

戻り値

解説

CMDIChildWndEx::GetDockingManager

戻り値

解説

CMDIChildWndEx::GetDocumentName

戻り値

解説

例

CMDIChildWndEx::GetFrameIcon

戻り値

解説

CMDIChildWndEx::GetFrameText

戻り値

解説

CMDIChildWndEx::GetPane

パラメーター

戻り値

CMDIChildWndEx::GetRelatedTabGroup

戻り値

解説

CMDIChildWndEx::GetTabbedPane

戻り値

CMDIChildWndEx::GetToolbarButtonToolTipText

戻り値

解説

CMDIChildWndEx::InsertPane

パラメーター

戻り値

CMDIChildWndEx::IsPointNearDockSite

パラメーター

戻り値

解説

CMDIChildWndEx::IsReadOnly

戻り値

解説

例

CMDIChildWndEx::IsTabbedPane

戻り値

CMDIChildWndEx::OnMoveMiniFrame

パラメーター

戻り値

CMDIChildWndEx::OnSetPreviewMode

パラメーター

CMDIChildWndEx::OnUpdateFrameTitle

パラメーター

パブリックメソッド