CTabbedPane クラス
切り離し可能なタブを持つペインの機能を実装します。
または、Visual Studio インストールの VC\atlmfc\src\mfc フォルダーにあるソース コードを参照してください。
構文
class CTabbedPane : public CBaseTabbedPane
メンバー
パブリック コンストラクター
| 名前 | 説明 |
|---|---|
CTabbedPane::CTabbedPane |
既定のコンストラクターです。 |
パブリック メソッド
| 名前 | 説明 |
|---|---|
| CTabbedPane::D etachPane | (オーバーライド CBaseTabbedPane::D etachPane.) |
| CTabbedPane::EnableTabAutoColor | タブの色の自動設定を有効または無効にします。 |
| CTabbedPane::FloatTab | ペインが現在デタッチ可能なタブに存在する場合にのみ、ペインを浮動表示します (CBaseTabbedPane::FloatTab をオーバーライドします)。 |
| CTabbedPane::GetTabArea | タブ付きウィンドウ内のタブ領域のサイズと位置を返します。 |
| CTabbedPane::GetTabWnd | |
| CTabbedPane::HasAutoHideMode | タブ付きペインを AutoHide モードに切り替えられるかどうかを判断します。 (オーバーライド CBaseTabbedPane::HasAutoHideMode.) |
| CTabbedPane::IsTabLocationBottom | タブがウィンドウの下部にあるかどうかを判断します。 |
| CTabbedPane::ResetTabs | すべてのタブ付きペインを既定の状態にリセットします。 |
| CTabbedPane::SetTabAutoColors | 色の自動設定機能が有効になっているときに使用できるカスタム色の一覧を設定します。 |
データ メンバー
| 名前 | 説明 |
|---|---|
| CTabbedPane::m_bTabsAlwaysTop | アプリケーション内のタブの既定の場所。 |
| CTabbedPane::m_pTabWndRTC | カスタムの CMFCTabCtrl から派生したオブジェクトに関するランタイム クラス情報。 |
解説
2 つ目のペインのキャプションをポイントして、ユーザーがあるペインを別のペインにアタッチすると、フレームワークにより自動的にこのクラスのインスタンスが作成されます。 -1 の ID を持つフレームワークにより作成される、すべてのタブ付きペイン。
Outlook スタイルのタブではなく通常のタブを指定するには、AFX_CBRS_REGULAR_TABS スタイルを CDockablePane::CreateEx メソッドに渡します。
切り離し可能なタブを持つタブ付きペインを作成すると、フレームワークによってペインが自動的に破棄される可能性があるため、ポインターを格納しないでください。 タブ付きペインへのポインターを取得するには、CBasePane::GetParentTabbedPane メソッドを呼び出します。
例
この例では CTabbedPane オブジェクトを作成します。 次に、CBaseTabbedPane::AddTab を使用 して、追加の タブをアタッチします。
CTabbedPane* pTabbededBar = new CTabbedPane (TRUE);
if (!pTabbededBar->Create (_T(""),
this,
CRect (0,
0,
200,
200),
TRUE,
(UINT) -1,
WS_CHILD | WS_VISIBLE | WS_CLIPSIBLINGS |
WS_CLIPCHILDREN | CBRS_LEFT |
CBRS_FLOAT_MULTI))
{
TRACE0("Failed to create Solution Explorer bar\n");
return FALSE; // fail to create
}
pTabbededBar->AddTab (&m_wndClassView);
pTabbededBar->AddTab (&m_wndResourceView);
pTabbededBar->AddTab (&m_wndFileView);
pTabbededBar->EnableDocking(CBRS_ALIGN_ANY);
DockPane(pTabbededBar);
タブ付きコントロール バー オブジェクトを作成するもう 1 つの方法は、CDockablePane::AttachToTabWnd を使用することです。 このメソッドはAttachToTabWnd、CDockablePane::SetTabbedPaneRTC によって設定されたランタイム クラス情報を使用して、タブ付きペイン オブジェクトを動的に作成します。
この例では、タブ付きペインを動的に作成し、2 つのタブをアタッチし、2 番目のタブを切り離し不可能にします。
DockPane(&m_wndClassView);
CTabbedPane* pTabbedBar = NULL;
m_wndResourceView.AttachToTabWnd (&m_wndClassView,
DM_SHOW,
TRUE,
(CDockablePane**) &pTabbedBar);
m_wndFileView.AttachToTabWnd (pTabbedBar,
DM_SHOW,
TRUE,
(CDockablePane**) &pTabbedBar);
pTabbedBar->GetUnderlyingWindow ()->EnableTabDetach (1,
FALSE);
継承階層
必要条件
ヘッダー: afxTabbedPane.h
CTabbedPane::D etachPane
virtual BOOL DetachPane(
CWnd* pBar,
BOOL bHide = FALSE);
パラメーター
[入力] pBar
[in] bHide
戻り値
解説
CTabbedPane::EnableTabAutoColor
タブの色の自動設定を有効または無効にします。
static void EnableTabAutoColor(BOOL bEnable = TRUE);
パラメーター
bEnable
[in]タブの自動色分けを有効にする場合は TRUE。それ以外の場合は FAL Standard Edition。
解説
この静的メソッドを使用して、アプリケーション内のすべてのタブ付きペインでタブの自動色分けを有効または無効にします。 この機能を有効にすると、各タブは独自の色で塗りつぶされます。 CMFCBaseTabCtrl::GetAutoColors メソッドを呼び出 すと、タブの色付けに使用される色の 一覧を確認できます。
CTabbedPane::SetTabAutoColors を呼び出すことで、タブに使用する色の一覧を指定できます。
既定では、このオプションは無効になっています。
CTabbedPane::FloatTab
virtual BOOL FloatTab(
CWnd* pBar,
int nTabID,
AFX_DOCK_METHOD dockMethod,
BOOL bHide = FALSE);
パラメーター
[入力] pBar
[in] nTabID
[in] dockMethod
[in] bHide
戻り値
解説
CTabbedPane::GetTabArea
タブ付きウィンドウ内のタブ領域のサイズと位置を返します。
virtual void GetTabArea(
CRect& rectTabAreaTop,
CRect& rectTabAreaBottom) const;
パラメーター
rectTabAreaTop
[out]上部タブ領域のサイズと位置を画面座標で格納します。
rectTabAreaBottom
[out]下部タブ領域のサイズと位置を画面座標で格納します。
解説
フレームワークは、このメソッドを呼び出して、ユーザーがドラッグしているウィンドウをドッキングする方法を決定します。 ユーザーがターゲット ウィンドウのタブ領域の上にウィンドウをドラッグすると、フレームワークは、それをターゲット ウィンドウの新しいタブとして追加しようとします。 それ以外の場合は、ウィンドウをターゲット ペインの横にドッキングしようとします。これには、2 つのペインを区切るウィンドウ分割線を含む新しいペイン コンテナーの作成が含まれます。
この動作を変更するには、 CTabbedPane-derived クラスでこのメソッドをオーバーライドします。
CTabbedPane::GetTabWnd
CMFCTabCtrl* GetTabWnd() const;
戻り値
解説
CTabbedPane::HasAutoHideMode
virtual BOOL HasAutoHideMode() const;
戻り値
解説
CTabbedPane::IsTabLocationBottom
タブがウィンドウの下部にあるかどうかを判断します。
virtual BOOL IsTabLocationBottom() const;
戻り値
タブ領域がタブ付きウィンドウの下部にある場合は TRUE。それ以外の場合は FAL Standard Edition。
解説
CTabbedPane::m_bTabsAlwaysTop
アプリケーション内のタブの既定の場所。
AFX_IMPORT_DATA static BOOL m_bTabsAlwaysTop;
解説
この静的メンバーを TRUE に設定すると、アプリケーション内のすべてのタブがタブ付きペインの上部に強制的に表示されます。
タブ付きペインが作成される前に、この値を設定する必要があります。
既定値は FALSE です。
CTabbedPane::m_pTabWndRTC
カスタムの CMFCTabCtrl から派生したオブジェクトに関するランタイム クラス情報。
AFX_IMPORT_DATA static CRuntimeClass* m_pTabWndRTC;
解説
タブ付きペイン内でカスタム タブ付きウィンドウを使用している場合は、この静的メンバー変数を -derived オブジェクトのランタイム クラス情報 CMFCTabCtrlへのポインターに設定します。
CTabbedPane::ResetTabs
すべてのタブ付きペインを既定の状態にリセットします。
static void ResetTabs();
解説
タブ付きペインをすべて既定の状態に戻すには、このメソッドを呼び出します。 このメソッドを呼び出すと、すべてのタブ付きペインの境界線のサイズと自動色の状態がリセットされます。
CTabbedPane::SetTabAutoColors
自動色機能が有効な場合に使用されるカスタム 色の一覧を設定します。
static void SetTabAutoColors(const CArray<COLORREF, COLORREF>& arColors);
パラメーター
arColors
[in]設定する色の配列を格納します。
解説
自動色機能が有効になっているときに使用される色の一覧をカスタマイズするには、このメソッドを使用します。 これは静的関数であり、アプリケーション内のすべてのタブ付きペインに影響します。
CTabbedPane::EnableTabAutoColor を使用して、自動色機能を有効または無効にします。
関連項目
階層図
クラス
CDockablePane クラス
CBaseTabbedPane クラス
CMFCOutlookBar クラス
フィードバック
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「https://aka.ms/ContentUserFeedback」を参照してください。
フィードバックの送信と表示