`CMFCTabCtrl` クラス

[アーティクル]
04/03/2023

CMFCTabCtrl クラスは、タブコントロールの機能を提供します。タブコントロールは、上または下にフラットまたは 3D のタブを持つ、ドッキング可能なウィンドウを表示します。タブにはテキストとイメージを表示でき、アクティブな状態のときに色を変更することもできます。

構文

class CMFCTabCtrl : public CMFCBaseTabCtrl

メンバー

パブリックコンストラクター

名前	説明
`CMFCTabCtrl::CMFCTabCtrl`	既定のコンストラクターです。
`CMFCTabCtrl::~CMFCTabCtrl`	デストラクターです。

パブリックメソッド

名前	説明
`CMFCTabCtrl::ActivateMDITab`	現在のタブコントロールの指定したタブを表示し、そのタブにフォーカスを設定します。
`CMFCTabCtrl::AllowDestroyEmptyTabbedPane`
`CMFCTabCtrl::AutoSizeWindow`	タブコントロールのユーザーインターフェイス要素が変更されたときに、フレームワークがすべてのタブコントロールウィンドウのクライアント領域のサイズを変更するかどうかを指定します。
`CMFCTabCtrl::CalcRectEdit`	指定したタブ領域のサイズを縮小します。 (`CMFCBaseTabCtrl::CalcRectEdit` をオーバーライドします)。
`CMFCTabCtrl::Create`	タブコントロールを作成し、 `CMFCTabCtrl` オブジェクトにアタッチします。
`CMFCTabCtrl::CreateObject`	このクラス型の動的インスタンスを作成するために、フレームワークで使用されます。
`CMFCTabCtrl::EnableActiveTabCloseButton`	アクティブなタブの [閉じる] ボタン ( X) を表示または非表示にします。
`CMFCTabCtrl::EnableInPlaceEdit`	編集可能なタブラベルを有効または無効にします。 ( `CMFCBaseTabCtrl::EnableInPlaceEdit`をオーバーライドします)。
`CMFCTabCtrl::EnableTabDocumentsMenu`	ウィンドウタブをスクロールする 2 つのボタンを、タブ付きウィンドウのメニューを開くボタンに置き換えます。
`CMFCTabCtrl::EnsureVisible`	タブが表示されていることを確認します。
`CMFCTabCtrl::GetDocumentIcon`	タブ付きウィンドウのポップアップメニューのタブに関連付けられているシンボルを取得します。
`CMFCTabCtrl::GetFirstVisibleTabNum`	現在のタブコントロールに表示される最初のタブのインデックスを取得します。
`CMFCTabCtrl::GetResizeMode`	現在のタブコントロールのサイズを変更する方法を指定する値を取得します。
`CMFCTabCtrl::GetScrollBar`	タブコントロールに関連付けられているスクロールバーオブジェクトへのポインターを取得します。
`CMFCTabCtrl::GetTabArea`	タブコントロールの上部または下部にあるタブラベル領域の外接する四角形を取得します。 ( `CMFCBaseTabCtrl::GetTabArea`をオーバーライドします)。
`CMFCTabCtrl::GetTabFromPoint`	指定したポイントを含むタブを取得します。 ( `CMFCBaseTabCtrl::GetTabFromPoint`をオーバーライドします)。
`CMFCTabCtrl::GetTabMaxWidth`	タブの最大幅を取得します。
`CMFCTabCtrl::GetTabsHeight`	現在のタブコントロールのタブ領域の高さを取得します。
`CMFCTabCtrl::GetTabsRect`	現在のタブコントロールのタブ領域を囲む四角形を取得します。 ( `CMFCBaseTabCtrl::GetTabsRect`をオーバーライドします)。
`CMFCTabCtrl::GetThisClass`	フレームワークによって、このクラス型に関連付けられている `CRuntimeClass` オブジェクトへのポインターを取得するために使用されます。
`CMFCTabCtrl::GetWndArea`	現在のタブコントロールのクライアント領域の境界を取得します。
`CMFCTabCtrl::HideActiveWindowHorzScrollBar`	アクティブなウィンドウの水平スクロールバー (存在する場合) を非表示にします。
`CMFCTabCtrl::HideInactiveWindow`	フレームワークが非アクティブなタブコントロールウィンドウを表示するかどうかを指定します。
`CMFCTabCtrl::HideNoTabs`	タブが表示されていない場合は、タブ領域の描画を有効または無効にします。
`CMFCTabCtrl::HideSingleTab`	タブ付きウィンドウが 1 つある場合にタブの描画を有効または無効にします。 ( `CMFCBaseTabCtrl::HideSingleTab`をオーバーライドします)。
`CMFCTabCtrl::IsActiveInMDITabGroup`	タブコントロールの現在のタブが、複数のドキュメントインターフェイスタブグループ内のアクティブなタブであるかどうかを示します。
`CMFCTabCtrl::IsActiveTabBoldFont`	アクティブなタブのテキストが太字のフォントを使用して表示されるかどうかを示します。
`CMFCTabCtrl::IsActiveTabCloseButton`	アクティブなタブまたはタブ領域の右上隅に [閉じる] ボタン ( X) を表示するかどうかを示します。
`CMFCTabCtrl::IsDrawFrame`	タブ付きウィンドウが埋め込みペインの周囲にフレームの四角形を描画するかどうかを示します。
`CMFCTabCtrl::IsFlatFrame`	タブ領域の周囲のフレームがフラットか 3D かを示します。
`CMFCTabCtrl::IsFlatTab`	現在のタブコントロールのタブの外観がフラットかどうかを示します。
`CMFCTabCtrl::IsLeftRightRounded`	現在のタブコントロールのタブの左右の外観を丸めるかどうかを示します。
`CMFCTabCtrl::IsMDITabGroup`	現在のタブコントロールが複数ドキュメントインターフェイスウィンドウのクライアント領域に含まれているかどうかを示します。
`CMFCTabCtrl::IsOneNoteStyle`	現在のタブコントロールが Microsoft OneNote のスタイルで表示されるかどうかを示します。
`CMFCTabCtrl::IsPtInTabArea`	ポイントがタブ領域内にあるかどうかを指定します。 ( `CMFCBaseTabCtrl::IsPtInTabArea`をオーバーライドします)。
`CMFCTabCtrl::IsSharedScroll`	現在のタブコントロールに、タブをグループとしてスクロールできるスクロールバーがあるかどうかを示します。
`CMFCTabCtrl::IsTabDocumentsMenu`	タブコントロールにスクロールボタンを表示するか、タブ付きウィンドウのメニューを表示するボタンを表示するかを示します。
`CMFCTabCtrl::IsVS2005Style`	Visual Studio .NET 2005 のスタイルでタブが表示されるかどうかを示します。
`CMFCTabCtrl::ModifyTabStyle`	現在のタブコントロールのタブの外観を指定します。
`CMFCTabCtrl::MoveTab`	タブを別のタブ位置に移動します。 ( `CMFCBaseTabCtrl::MoveTab`をオーバーライドします)。
`CMFCTabCtrl::OnDragEnter`	カーソルが最初にタブコントロールウィンドウにドラッグされたときにフレームワークによって呼び出されます。
`CMFCTabCtrl::OnDragOver`	ドラッグ操作中にドロップターゲットウィンドウ上でマウスを移動すると、フレームワークによって呼び出されます。 ( `CMFCBaseTabCtrl::OnDragOver`をオーバーライドします)。
`CMFCTabCtrl::OnShowTabDocumentsMenu`	タブ付きウィンドウのポップアップメニューを表示し、ユーザーがタブを選択するまで待機し、選択したタブをアクティブなタブにします。
`CMFCTabCtrl::PreTranslateMessage`	ウィンドウメッセージを `TranslateMessage` にディスパッチする前に変換し、Windows 関数 `DispatchMessage` します。 ( `CMFCBaseTabCtrl::PreTranslateMessage`をオーバーライドします)。
`CMFCTabCtrl::RecalcLayout`	タブコントロールの内部レイアウトを再計算します。 ( `CMFCBaseTabCtrl::RecalcLayout`をオーバーライドします)。
`CMFCTabCtrl::SetActiveInMDITabGroup`	タブコントロールの現在のタブを、複数のドキュメントインターフェイスタブグループのアクティブなタブとして設定します。
`CMFCTabCtrl::SetActiveTab`	タブをアクティブにします ( `CMFCBaseTabCtrl::SetActiveTab`をオーバーライドします)。
`CMFCTabCtrl::SetActiveTabBoldFont`	アクティブなタブでの太字フォントの使用を有効または無効にします。
`CMFCTabCtrl::SetDrawFrame`	埋め込みバーの周囲にフレームの四角形を描画するかどうかを指定します。
`CMFCTabCtrl::SetFlatFrame`	タブ領域の周囲にフラットフレームと 3D フレームのどちらを描画するかを指定します。
`CMFCTabCtrl::SetImageList`	イメージリストを指定します。 ( `CMFCBaseTabCtrl::SetImageList`をオーバーライドします)。
`CMFCTabCtrl::SetResizeMode`	現在のタブコントロールのサイズを変更し、コントロールを再表示する方法を指定します。
`CMFCTabCtrl::SetTabMaxWidth`	タブ付きウィンドウの最大タブ幅を指定します。
`CMFCTabCtrl::StopResize`	タブコントロールの現在のサイズ変更操作を終了します。
`CMFCTabCtrl::SwapTabs`	タブのペアを入れ替えます。 ( `CMFCBaseTabCtrl::SwapTabs`をオーバーライドします)。
`CMFCTabCtrl::SynchronizeScrollBar`	フラットタブを表示するタブコントロールに水平スクロールバーを描画します。

データメンバー

名前	説明
`CMFCTabCtrl::m_bEnableActivate`	新しいタブを挿入して有効にすると、アクティブなビューがフォーカスを失わないようにします。

解説

CMFCTabCtrl クラスでは、次の機能がサポートされます。

共有の水平スクロールバーを備えた 3D、フラット、フラットを含むタブコントロールスタイル。
ウィンドウの上部または下部にあるタブ。
テキスト、画像、またはテキストと画像を表示するタブ。
タブがアクティブな場合に色を変更するタブ。
調整可能なタブの罫線のサイズが変更されます。
取り外し可能なタブ付きウィンドウ。

CMFCTabCtrl クラスはダイアログボックスで使用できますが、Microsoft Excel や Visual Studio などのドッキングコントロールバーを使用するアプリケーションを対象としています。詳細については、「CDockablePane クラス」を参照してください。

サイズ変更可能なドッキングタブコントロールをアプリケーションに追加するには、次の手順に従います。

CTabbedPane Class のインスタンスを作成します。
CDockablePane::Create を呼び出します。
CBaseTabbedPane::AddTabまたはCMFCBaseTabCtrl::InsertTabを使用して、新しいタブを追加します。
現在のドッキングタブコントロールがメインフレームウィンドウにドッキングできるように、 CBasePane::EnableDocking を呼び出します。
CFrameWndEx::DockPaneを呼び出して、タブ付きウィンドウをメインフレームにドッキングします。

タブ付きウィンドウをドッキングコントロールバーとして作成する方法の例については、「 CTabbedPane クラス」を参照してください。 CMFCTabCtrlを非ドッキングコントロールとして使用するには、CMFCTabCtrl オブジェクトを作成し、CMFCTabCtrl::Createを呼び出します。

継承階層

例

次の例は、CMFCTabCtrl オブジェクトを構成するための CMFCTabCtrl クラスのさまざまなメソッドの使用方法を示しています。この例では、タブを追加する方法、アクティブなタブに [閉じる] ボタンを表示する方法、編集可能なタブラベルを有効にする方法、タブ付きウィンドウラベルのポップアップメニューを表示する方法について説明します。この例は、 State Collection サンプルの一部です。

CMFCTabCtrl m_wndTabs;

// Attach list windows to tab:
// CListCtrl m_wndList1
// CListCtrl m_wndList2
// CListCtrl m_wndList3
m_wndTabs.AddTab(&m_wndList1, _T("Output 1"), (UINT)-1);
m_wndTabs.AddTab(&m_wndList2, _T("Output 2"), (UINT)-1);
m_wndTabs.AddTab(&m_wndList3, _T("Output 3"), (UINT)-1);

m_wndTabs.EnableActiveTabCloseButton();
m_wndTabs.EnableInPlaceEdit(true);
m_wndTabs.EnableTabDocumentsMenu();
m_wndTabs.SetActiveTab(1);
m_wndTabs.SetDrawFrame();
m_wndTabs.SetFlatFrame();

要件

ヘッダー: afxtabctrl.h

`CMFCTabCtrl::ActivateMDITab`

現在のタブコントロールの指定したタブを表示し、そのタブにフォーカスを設定します。

void ActivateMDITab(int nTab = -1);

パラメーター

nTab
[in]表示するタブの 0 から始まるインデックス。現在アクティブなタブを指定する場合は -1。

`CMFCTabCtrl::AllowDestroyEmptyTabbedPane`

詳細については、Visual Studio インストール先の mfc フォルダーにあるソースコードを参照してください。たとえば、%ProgramFiles(x86)%\Microsoft Visual Studio\2019\Enterprise\VC\Tools\MSVC\14.29.30133\atlmfc\src\mfc のようにします。

virtual BOOL AllowDestroyEmptyTabbedPane() const;

戻り値

常に TRUE です。

解説

`CMFCTabCtrl::AutoSizeWindow`

タブコントロールのユーザーインターフェイス要素が変更されたときに、フレームワークがすべてのタブコントロールウィンドウのクライアント領域のサイズを変更するかどうかを指定します。

void AutoSizeWindow(BOOL bAutoSize = TRUE);

パラメーター

bAutoSize
[入力] TRUE タブコントロールウィンドウのサイズを自動的に変更する。それ以外の場合は FALSE。既定値は TRUE です。

解説

`CMFCTabCtrl::Create`

タブコントロールを作成し、 CMFCTabCtrl オブジェクトにアタッチします。

BOOL Create(
    Style style,
    const RECT& rect,
    CWnd* pParentWnd,
    UINT nID,
    Location location=LOCATION_BOTTOM,
    BOOL bCloseBtn=FALSE);

パラメーター

style
[in]タブコントロールのスタイル。詳細については、「解説」を参照してください。

rect
[in]タブコントロールを囲む四角形。

pParentWnd
[in]親ウィンドウへのポインター。 NULL にすることはできません。

nID
[in]タブコントロールの ID。

location
[in]タブの場所。既定値は LOCATION_BOTTOM です。詳細については、「解説」をご覧ください。

bCloseBtn
[入力] TRUE タブに閉じるボタンを表示する場合。それ以外の場合は FALSE。既定値は FALSE です。

戻り値

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

解説

次の表では、 style パラメーターに指定できる値について説明します。

Style	説明
`STYLE_3D`	3 次元の外観を持つタブコントロールを作成します。
`STYLE_FLAT`	フラットタブを含むタブコントロールを作成します。
`STYLE_FLAT_SHARED_HORZ_SCROLL`	親ウィンドウでクリップされた場合にタブをスクロールできるフラットタブとスクロールバーを含むタブコントロールを作成します。
`STYLE_3D_ONENOTE`	Microsoft OneNote のスタイルでタブコントロールを作成します。
`STYLE_3D_VS2005`	Microsoft Visual Studio 2005 のスタイルでタブコントロールを作成します。
`STYLE_3D_ROUNDED`	Microsoft Visual Studio 2005 のスタイルで丸いタブを持つタブコントロールを作成します。
`STYLE_3D_ROUNDED_SCROLL`	Microsoft Visual Studio 2005 のスタイルで丸いタブとスクロールボタンを含むタブコントロールを作成します。

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

場所	説明
`LOCATION_BOTTOM`	タブはタブコントロールの下部にあります。
`LOCATION_TOP`	タブはタブコントロールの上部にあります。

例

次の例では、CMFCTabCtrl クラスで Create メソッドを使用する方法を示します。この例は、 State Collection サンプルの一部です。

CMFCTabCtrl m_wndTabs;

// Create tabs window:
// CRect rectDummy
// this is a pointer to a parent window
// fourth parameter is the id of the tab control
if (!m_wndTabs.Create (CMFCTabCtrl::STYLE_FLAT, rectDummy, this, 1))
{
    TRACE0("Failed to create output tab window\n");
    return -1;      // fail to create
}

`CMFCTabCtrl::CalcRectEdit`

指定したタブ領域のサイズを縮小します。

virtual void CalcRectEdit(CRect& rectEdit);

パラメーター

rectEdit
[in]タブの領域を指定する四角形。

解説

このメソッドは、タブのラベルを変更するときに呼び出されます。このメソッドは、指定した四角形の左右の辺を現在のタブの高さの 2 分の 1 だけデフレートし、上下を 1 単位だけデフレートします。

`CMFCTabCtrl::EnableActiveTabCloseButton`

アクティブなタブの Close ボタン ( X) を表示または非表示にします。

void EnableActiveTabCloseButton(BOOL bEnable=TRUE);

パラメーター

bEnable
[入力] TRUEClose ボタンをアクティブなタブに表示する場合はFALSE、タブ領域の右上隅に Close ボタンを表示します。既定値は TRUE です。

`CMFCTabCtrl::EnableInPlaceEdit`

編集可能なタブラベルを有効または無効にします。

virtual void EnableInPlaceEdit(BOOL bEnable);

パラメーター

bEnable
[入力] TRUE 編集可能なタブラベルを有効にする場合。編集可能なタブラベルを無効にする FALSE 。

解説

`CMFCTabCtrl::EnableTabDocumentsMenu`

2 つのボタンを使用してウィンドウタブをスクロールするユーザーインターフェイスと、タブ付きウィンドウのポップアップメニューを表示するインターフェイスを切り替えます。

void EnableTabDocumentsMenu(BOOL bEnable=TRUE);

パラメーター

bEnable
[入力] TRUE タブ付きウィンドウラベルのポップアップメニューを表示する場合。前方スクロールボタンと後方スクロールボタンを表示する FALSE 。既定値は TRUE です。

解説

ユーザーがタブラベルをクリックすると、フレームワークに対応するタブ付きウィンドウが表示されます。タブラベルが表示されている場合、タブ付きウィンドウは位置を変更せずに開かれます。ユーザーがポップアップメニューからドキュメントを選択し、対応するタブ付きウィンドウが画面外の場合、タブ付きウィンドウが最初のタブになります。

`CMFCTabCtrl::EnsureVisible`

タブが表示されていることを確認します。

virtual BOOL EnsureVisible(int iTab);

パラメーター

iTab
[in] タブの 0 から始まるインデックス。

戻り値

TRUE成功した場合は〘。iTab パラメーターのインデックスが無効な場合にFALSEします。

解説

指定したタブが表示されることを保証するには、このメソッドを使用します。必要に応じて、タブコントロールがスクロールします。

`CMFCTabCtrl::GetDocumentIcon`

タブ付きウィンドウのポップアップメニューのタブに関連付けられているイメージを取得します。

static HICON __stdcall GetDocumentIcon(UINT nCmdID);

パラメーター

nCmdID
[in]タブ付きウィンドウのポップアップメニュー内のタブのコマンド ID。

戻り値

ビットマップイメージのハンドル。

`CMFCTabCtrl::GetFirstVisibleTabNum`

現在のタブコントロールに表示される最初のタブのインデックスを取得します。

virtual int GetFirstVisibleTabNum() const;

戻り値

タブコントロール内のタブの 0 から始まるインデックス。

解説

このメソッドは、タブコントロールが Microsoft OneNote のスタイルで表示されている場合にのみ使用します。スタイルを決定するには、 CMFCTabCtrl::IsOneNoteStyle メソッドを使用します。

`CMFCTabCtrl::GetResizeMode`

現在のタブコントロールのサイズを変更する方法を指定する値を取得します。

ResizeMode GetResizeMode() const;

戻り値

タブコントロールのサイズを変更する方法を指定する CMFCTabCtrl::ResizeMode 列挙値の 1 つ。使用可能な値の一覧については、 CMFCTabCtrl::SetResizeMode メソッドの「解説」セクションを参照してください。

`CMFCTabCtrl::GetScrollBar`

タブコントロールに関連付けられているスクロールバーオブジェクトへのポインターを取得します。

CScrollBar* GetScrollBar();

戻り値

スクロールバーオブジェクトへのポインター。タブコントロールがSTYLE_FLAT_SHARED_HORZ_SCROLL スタイルを使用して作成されなかった場合はNULL。

解説

このメソッドを使用して、タブコントロールの埋め込みスクロールバーにアクセスします。スクロールバーオブジェクトは、タブコントロールに STYLE_FLAT_SHARED_HORZ_SCROLL スタイルがある場合にのみ作成されます。

`CMFCTabCtrl::GetTabArea`

タブコントロールの上部または下部にあるタブラベル領域の外接する四角形を取得します。

void GetTabArea(
    CRect& rectTabAreaTop,
    CRect& rectTabAreaBottom) const;

パラメーター

rectTabAreaTop
[out]このメソッドから制御が戻るときに、この参照には、上部のタブラベル領域を囲む四角形が含まれます。四角形はクライアント座標内にあります。タブコントロールの上部にタブラベル領域が存在しない場合、この参照は空です。

rectTabAreaBottom
[out]このメソッドから制御が戻るときに、この参照には、下部タブラベル領域を囲む四角形が含まれます。四角形はクライアント座標内にあります。タブコントロールの下部にタブラベル領域が存在しない場合、この参照は空になります。

解説

このメソッドを使用して、タブ付きウィンドウ内のタブ領域のサイズと位置を決定します。

`CMFCTabCtrl::GetTabMaxWidth`

タブの最大幅を取得します。

int GetTabMaxWidth() const;

戻り値

タブの最大幅 (ピクセル単位)。戻り値が 0 の場合、タブの幅は無制限です。

解説

CMFCTabCtrl::SetTabMaxWidth メソッドを使用して、タブの最大幅を設定します。

`CMFCTabCtrl::GetTabsHeight`

現在のタブコントロールのタブ領域の高さを取得します。

virtual int GetTabsHeight() const;

戻り値

タブが表示されている場合はタブ領域の高さ、タブが表示されない場合は 0。

`CMFCTabCtrl::GetTabsRect`

現在のタブコントロールのタブ領域を囲む四角形を取得します。

virtual void GetTabsRect(CRect& rect) const;

パラメーター

rect
[out]このメソッドから制御が戻るときに、 rect パラメーターにはタブ領域を囲む四角形が含まれます。

`CMFCTabCtrl::GetWndArea`

現在のタブコントロールのクライアント領域の境界を取得します。

void GetWndArea(CRect& rect) const;

パラメーター

rect
[入力、出力]このメソッドから制御が戻るときに、このパラメーターには、現在のタブコントロールを境界とする四角形が含まれます。

解説

`CMFCTabCtrl::HideActiveWindowHorzScrollBar`

アクティブウィンドウ内の水平スクロールバー (存在する場合) を非表示にします。

void HideActiveWindowHorzScrollBar();

解説

ユーザーがタブコントロールページを切り替えたときにタブコントロールが点滅しないようにするには、このメソッドを使用します。

`CMFCTabCtrl::HideInactiveWindow`

フレームワークが非アクティブなタブコントロールウィンドウを表示するかどうかを指定します。

void HideInactiveWindow(BOOL bHide = TRUE);

パラメーター

bHide
[入力] TRUE 非アクティブなウィンドウを表示しない。非アクティブなウィンドウを表示する FALSE 。既定値は TRUE です。

解説

`CMFCTabCtrl::HideNoTabs`

タブが表示されていない場合は、タブ領域の描画を有効または無効にします。

void HideNoTabs(BOOL bHide=TRUE);

パラメーター

bHide
[入力] TRUE タブ領域の描画を有効にするには、図面を無効にする FALSE 。既定値は TRUE です。

解説

`CMFCTabCtrl::HideSingleTab`

タブ付きウィンドウが 1 つある場合、タブ描画を有効または無効にします。

virtual void HideSingleTab(BOOL bHide=TRUE);

パラメーター

bHide
[入力] TRUE 単一のタブ付きウィンドウのタブを描画しない場合。1 つのタブを描画する FALSE します。既定値は TRUE です。

解説

`CMFCTabCtrl::IsActiveInMDITabGroup`

タブコントロールの現在のタブが、複数のドキュメントインターフェイスタブグループ内のアクティブなタブであるかどうかを示します。

BOOL IsActiveInMDITabGroup() const;

戻り値

TRUE タブコントロールの現在のタブが MDI タブグループのアクティブなタブの場合。それ以外の場合は FALSE。

解説

複数のドキュメントウィンドウを縦または横のタブグループに整理し、1 つのタブグループから別のタブグループにドキュメントを簡単にシャッフルできます。

`CMFCTabCtrl::IsActiveTabBoldFont`

アクティブなタブのテキストが太字のフォントを使用して表示されるかどうかを示します。

BOOL IsActiveTabBoldFont() const;

戻り値

TRUE アクティブなタブが太字のフォントを使用して表示される場合。それ以外の場合は FALSE。

解説

CMFCTabCtrl::SetActiveTabBoldFontメソッドを使用して、アクティブなタブフォントを変更します。

`CMFCTabCtrl::IsActiveTabCloseButton`

Close ボタン (X) がアクティブなタブまたはタブ領域の右上隅に表示されるかどうかを示します。

virtual BOOL IsActiveTabCloseButton() const;

戻り値

TRUEClose ボタンがアクティブなタブに表示されている場合はFALSE。Close ボタンがタブ領域の右上隅に表示されている場合は。

解説

`CMFCTabCtrl::IsDrawFrame`

タブ付きウィンドウが埋め込みペインの周囲にフレームの四角形を描画するかどうかを示します。

BOOL IsDrawFrame() const;

戻り値

TRUE フレームの四角形が描画される場合。それ以外の場合は FALSE。

解説

フレーム四角形の描画を有効または無効にするには、 CMFCTabCtrl::SetDrawFrame メソッドを使用します。

`CMFCTabCtrl::IsFlatFrame`

タブ領域の周囲のフレームがフラットか 3D かを示します。

BOOL IsFlatFrame() const;

戻り値

TRUE タブ領域の周囲のフレームが平らである場合。フレームが 3 次元の場合に FALSE します。

解説

CMFCTabCtrl::SetFlatFrameメソッドを使用して、フレームの描画方法を変更します。

`CMFCTabCtrl::IsFlatTab`

現在のタブコントロールのタブの外観がフラットかどうかを示します。

virtual BOOL IsFlatTab() const;

戻り値

TRUE 現在のタブコントロール内のタブの外観がフラットの場合。それ以外の場合は FALSE。

`CMFCTabCtrl::IsLeftRightRounded`

現在のタブコントロールのタブの左右の外観を丸めるかどうかを示します。

virtual BOOL IsLeftRightRounded() const;

戻り値

TRUE 各タブの辺が丸められた場合は〘。それ以外の場合は FALSE。

`CMFCTabCtrl::IsMDITabGroup`

現在のタブコントロールが複数ドキュメントインターフェイスウィンドウのクライアント領域に含まれているかどうかを示します。

virtual BOOL IsMDITabGroup() const;

戻り値

TRUE 現在のタブコントロールが MDI クライアント領域ウィンドウ内にある場合。それ以外の場合は FALSE。

`CMFCTabCtrl::IsOneNoteStyle`

現在のタブコントロールが Microsoft OneNote のスタイルで表示されるかどうかを示します。

virtual BOOL IsOneNoteStyle() const;

戻り値

TRUE タブコントロールが Microsoft OneNote のスタイルで表示される場合。それ以外の場合は FALSE。

`CMFCTabCtrl::IsSharedScroll`

現在のタブコントロールに、タブをグループとしてスクロールできるスクロールバーがあるかどうかを示します。

BOOL IsSharedScroll() const;

戻り値

TRUE タブコントロールに共有スクロールバーがある場合。それ以外の場合は FALSE。

解説

このメソッドは、CMFCTabCtrl::Create メソッドのstyle パラメーターがSTYLE_FLAT_SHARED_HORZ_SCROLL場合にTRUEを返します。

`CMFCTabCtrl::IsTabDocumentsMenu`

タブコントロールにスクロールボタンを表示するか、タブ付きウィンドウのメニューを表示するボタンを表示するかを示します。

BOOL IsTabDocumentsMenu() const;

戻り値

TRUE タブ付きウィンドウラベルのポップアップメニューを使用してタブ付きウィンドウをスクロールする場合。タブ付きウィンドウが前方スクロールボタンと後方スクロールボタンを使用してスクロールされる場合に FALSE します。

解説

CMFCTabCtrl::EnableTabDocumentsMenuメソッドを使用して、タブ付きウィンドウをスクロールする方法を指定します。

`CMFCTabCtrl::IsVS2005Style`

Visual Studio 2005 のスタイルを使用してタブを描画するかどうかを示します。

virtual BOOL IsVS2005Style() const;

戻り値

TRUE Visual Studio 2005 のスタイルを使用してタブを描画する場合。それ以外の場合は FALSE。

解説

タブの描画方法を指定するには、CMFCTabCtrl::Create メソッドの style パラメーターを使用します。

`CMFCTabCtrl::m_bEnableActivate`

新しいタブを挿入して有効にすると、アクティブなビューがフォーカスを失わないようにします。

static BOOL m_bEnableActivate;

解説

フォーカスは、通常、タブが挿入されてアクティブになったときに、新しいタブ付きウィンドウによって取得されます。元のフォーカスを保持するには、 CMFCTabCtrl::m_bEnableActivate メンバー変数を FALSE に設定します。既定値は TRUE です。

`CMFCTabCtrl::ModifyTabStyle`

現在のタブコントロールのタブの外観を指定します。

BOOL ModifyTabStyle(Style style);

パラメーター

style
[in]タブコントロールの外観を指定する列挙値の 1 つ。詳細については、 Remarks の表を参照してください。

戻り値

常に TRUE です。

解説

style パラメーターの値には、次のいずれかのCMFCTabCtrl::Style列挙体を指定できます。

名前	説明
`STYLE_3D`	角が丸い 3 次元の四角形のタブを表示します。
`STYLE_3D_ONENOTE`	1 つの垂直面と 1 つの傾斜した側面があり、角が丸い 3 次元のタブを表示します。
`STYLE_3D_ROUNDED`	傾斜した側面と角が丸い 3 次元タブを表示します。
`STYLE_3D_ROUNDED_SCROLL`	傾斜した側面と角が丸い 3 次元タブを表示します。同時に表示できるタブが多い場合、フレームワークにはドロップダウン矢印とタブのメニューが表示され、アクティブになります。
`STYLE_3D_SCROLLED`	3 次元の四角形のタブを表示します。同時に表示できるタブが多い場合、フレームワークにはドロップダウン矢印とタブのメニューが表示され、アクティブになります。
`STYLE_3D_VS2005`	1 つの傾斜した側面と 1 つの垂直面を持つ、3 次元の丸いタブを表示します。
`STYLE_FLAT`	左右に傾斜した 2 次元タブを表示します。
`STYLE_FLAT_SHARED_HORZ_SCROLL`	2 次元タブを表示します。同時に表示できるタブが多い場合、フレームワークはタブ領域の端にスクロール矢印を表示します。

`CMFCTabCtrl::OnDragEnter`

カーソルが現在のタブコントロールのウィンドウに最初に入ったときに、ドラッグアンドドロップ操作中にフレームワークによって呼び出されます。

virtual DROPEFFECT OnDragEnter(
    COleDataObject* pDataObject,
    DWORD dwKeyState,
    CPoint point);

パラメーター

pDataObject
[in]ユーザーがドラッグするデータを含むデータオブジェクトを指します。

dwKeyState
[in]修飾子キーの状態を格納します。このパラメーターは、MK_CONTROL、MK_SHIFT、MK_ALT、MK_LBUTTON、MK_MBUTTON、MK_RBUTTONの値のビットごとの組み合わせ "or" (|) です。詳細については、「マウス入力について」の「Message パラメーター」セクションを参照してください。

point
[in]カーソルの現在の位置をクライアント座標で格納します。

戻り値

常に DROPEFFECT_NONE。つまり、ドロップターゲットはデータを受け入れられません。

解説

ドラッグアンドドロップ操作をサポートするには、このメソッドを使用します。独自のカスタム動作を実装するには、このメソッドをオーバーライドします。

既定では、このメソッドは常にDROPEFFECT_NONEを返すCMFCTabCtrl::OnDragOverのみを呼び出します。

`CMFCTabCtrl::OnDragOver`

ドラッグ操作中にドロップターゲットウィンドウ上でマウスを移動すると、フレームワークによって呼び出されます。

virtual DROPEFFECT OnDragOver(
    COleDataObject* pDataObject,
    DWORD dwKeyState,
    CPoint point);

パラメーター

pDataObject
[in]ドロップターゲットの上にドラッグされている COleDataObject オブジェクトへのポインター。

dwKeyState
[in]修飾キーの状態。これは、MK_CONTROL、MK_SHIFT、MK_ALT、MK_LBUTTON、MK_MBUTTON、およびMK_RBUTTONのビットごとの組み合わせ "or" (|) です。詳細については、「 About Mouse Input」の「メッセージパラメーター」を参照してください。

point
[in]現在のマウス位置。

戻り値

常に DROPEFFECT_NONE です。

解説

このメソッドをカスタム実装でオーバーライドします。詳細については、CView::OnDragOver メソッドを参照してください。

`CMFCTabCtrl::OnShowTabDocumentsMenu`

タブ付きウィンドウのポップアップメニューを表示し、ユーザーがタブを選択するまで待機し、選択したタブをアクティブなタブにします。

virtual void OnShowTabDocumentsMenu(CPoint point);

パラメーター

point
[in]ポップアップメニューを表示する場所の座標。

解説

`CMFCTabCtrl::SetActiveInMDITabGroup`

タブコントロールの現在のタブを、複数のドキュメントインターフェイスタブグループのアクティブなタブとして設定します。

void SetActiveInMDITabGroup(BOOL bActive);

パラメーター

bActive
[入力] TRUE 現在のタブをアクティブなタブにします。現在のタブを非アクティブにするには、 FALSE します。

解説

`CMFCTabCtrl::SetActiveTab`

タブをアクティブにします。

virtual BOOL SetActiveTab(int iTab);

パラメーター

iTab
[in]アクティブにするタブの 0 から始まるインデックスを指定します。

戻り値

TRUE指定したタブがアクティブになっている場合。指定したiTabパラメーター値が無効な場合にFALSEします。

解説

これにより、 AFX_WM_CHANGE_ACTIVE_TAB 通知が親ウィンドウとタブコントロールの親のフレームに送信されます。

SetActiveTab メソッドは、CMFCTabCtrl::HideActiveWindowHorzScrollBar メソッドを自動的に呼び出して、画面が点滅しないようにします。

`CMFCTabCtrl::SetActiveTabBoldFont`

アクティブなタブでの太字フォントの使用を有効または無効にします。

void SetActiveTabBoldFont(BOOL bIsBold=TRUE);

パラメーター

bIsBold
[入力] TRUE 太字のフォントを使用してアクティブなタブのラベルを表示する場合。標準フォントを使用してラベルを表示 FALSE 。既定値は TRUE です。

解説

`CMFCTabCtrl::SetDrawFrame`

埋め込みバーの周囲に枠の四角形を描画するかどうかを指定します。

void SetDrawFrame(BOOL bDraw=TRUE);

パラメーター

bDraw
[入力] TRUE 埋め込みバーの周囲にフレームの四角形を表示する場合。それ以外の場合は FALSE。既定値は TRUE です。

解説

`CMFCTabCtrl::SetFlatFrame`

タブ領域の周囲にフラットフレームと 3D フレームのどちらを描画するかを指定します。

void SetFlatFrame(
    BOOL bFlat=TRUE,
    BOOL bRepaint=TRUE);

パラメーター

bFlat
[入力] TRUE タブ領域の周りにフラット(2D)フレームを描画する。 FALSE 、3 次元 (3D) フレームを描画します。既定値は TRUE です。

bRepaint
[入力] TRUE ウィンドウをすぐに再描画する場合。それ以外の場合は FALSE。既定値は TRUE です。

解説

`CMFCTabCtrl::SetImageList`

イメージリストを指定します。

virtual BOOL SetImageList(
    UINT uiID,
    int cx=15,
    COLORREF clrTransp=RGB(255, 0, 255));

virtual BOOL SetImageList(HIMAGELIST hImageList);

パラメーター

uiID
[in]イメージリストを含むビットマップリソースの ID。

cx
[in]各イメージの幅 (ピクセル単位)。既定値は 15です。

clrTransp
[in]透明なイメージの色。この色である画像の部分は透明になります。既定値は、色マゼンタ、RGB(255,0,255) です。

hImageList
[in] 事前に読み込まれた画像リストへのハンドル。

戻り値

TRUE このメソッドが成功した場合は。 FALSE フラットスタイルを使用してタブコントロールを作成する場合、または最初のメソッドオーバーロードが、 uiID パラメーターで指定されたビットマップを読み込めない場合。

解説

タブコントロールのイメージリストを設定するには、このメソッドを使用します。画像一覧の画像がタブラベルの横に表示されます。このメソッドは、タブの高さを再計算して、画像とテキストの両方が含まれるようにタブのサイズを設定します。

タブコントロールによって継承される CMFCBaseTabCtrl::AddTab メソッドを使用して、表示するイメージのインデックスを指定します。

`CMFCTabCtrl::SetResizeMode`

現在のタブコントロールのサイズを変更し、コントロールを再表示する方法を指定します。

void SetResizeMode(ResizeMode resizeMode);

パラメーター

resizeMode
[in]タブコントロールのサイズを変更する方法を指定する CMFCTabCtrl::ResizeMode 列挙値の 1 つ。使用可能な値の一覧については、 Remarksの表を参照してください。

解説

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

名前	説明
`RESIZE_NO`	タブコントロールのサイズを変更することはできません。
`RESIZE_VERT`	タブコントロールのサイズは垂直方向に変更できますが、水平方向にはサイズ変更できません。
`RESIZE_HORIZ`	タブコントロールのサイズは水平方向に変更できますが、垂直方向には変更できません。

`CMFCTabCtrl::SetTabMaxWidth`

タブ付きウィンドウの最大タブ幅を指定します。

void SetTabMaxWidth(int nTabMaxWidth);

パラメーター

nTabMaxWidth
[in]タブの最大幅 (ピクセル単位)。

解説

タブ付きウィンドウ内の各タブの幅を制限するには、このメソッドを使用します。このメソッドは、タブに非常に長いラベルがある場合に便利です。 CMFCTabCtrl クラスコンストラクターは、タブの最大幅を 0 に初期化します。これは、実際には幅が制限されていないことを意味します。

`CMFCTabCtrl::StopResize`

タブコントロールの現在のサイズ変更操作を終了します。

void StopResize(BOOL bCancel);

パラメーター

bCancel
[入力] TRUE 現在のサイズ変更操作を破棄する場合。現在のサイズ変更操作を完了 FALSE 。どちらの場合も、フレームワークはサイズ変更四角形の描画を停止します。

`CMFCTabCtrl::SynchronizeScrollBar`

フラットタブを表示するタブコントロールに水平スクロールバーを描画します。

BOOL SynchronizeScrollBar(SCROLLINFO* pScrollInfo = NULL);

パラメーター

pScrollInfo
[out] SCROLLINFO 構造体または NULLへのポインター。このメソッドが戻り、このパラメーターが NULLでない場合、構造体にはスクロールバーのすべてのパラメーターが含まれます。既定値は NULL です。

戻り値

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

解説

このメソッドは、フラットタブを表示するタブコントロールにのみ影響します。スクロールバーは、すべてのタブに同時に影響します。

次の方法で共有

CMFCTabCtrl クラス

構文

メンバー

パブリック コンストラクター

パブリック メソッド

データ メンバー

解説

継承階層

例

要件

CMFCTabCtrl::ActivateMDITab

パラメーター

CMFCTabCtrl::AllowDestroyEmptyTabbedPane

戻り値

解説

CMFCTabCtrl::AutoSizeWindow

パラメーター

解説

CMFCTabCtrl::Create

パラメーター

戻り値

解説

例

CMFCTabCtrl::CalcRectEdit

パラメーター

解説

CMFCTabCtrl::EnableActiveTabCloseButton

パラメーター

CMFCTabCtrl::EnableInPlaceEdit

パラメーター

解説

CMFCTabCtrl::EnableTabDocumentsMenu

パラメーター

解説

CMFCTabCtrl::EnsureVisible

パラメーター

戻り値

解説

CMFCTabCtrl::GetDocumentIcon

パラメーター

戻り値

CMFCTabCtrl::GetFirstVisibleTabNum

戻り値

解説

CMFCTabCtrl::GetResizeMode

戻り値

CMFCTabCtrl::GetScrollBar

戻り値

解説

CMFCTabCtrl::GetTabArea

パラメーター

解説

CMFCTabCtrl::GetTabMaxWidth

戻り値

解説

CMFCTabCtrl::GetTabsHeight

戻り値

CMFCTabCtrl::GetTabsRect

パラメーター

CMFCTabCtrl::GetWndArea

パラメーター

解説

CMFCTabCtrl::HideActiveWindowHorzScrollBar

解説

CMFCTabCtrl::HideInactiveWindow

パラメーター

解説

CMFCTabCtrl::HideNoTabs

パラメーター

解説

CMFCTabCtrl::HideSingleTab

パラメーター

解説

CMFCTabCtrl::IsActiveInMDITabGroup

戻り値

解説

CMFCTabCtrl::IsActiveTabBoldFont

戻り値

解説

`CMFCTabCtrl` クラス

パブリックコンストラクター

パブリックメソッド

データメンバー

`CMFCTabCtrl::ActivateMDITab`

`CMFCTabCtrl::AllowDestroyEmptyTabbedPane`

`CMFCTabCtrl::AutoSizeWindow`

`CMFCTabCtrl::Create`

`CMFCTabCtrl::CalcRectEdit`

`CMFCTabCtrl::EnableActiveTabCloseButton`

`CMFCTabCtrl::EnableInPlaceEdit`

`CMFCTabCtrl::EnableTabDocumentsMenu`

`CMFCTabCtrl::EnsureVisible`

`CMFCTabCtrl::GetDocumentIcon`

`CMFCTabCtrl::GetFirstVisibleTabNum`

`CMFCTabCtrl::GetResizeMode`

`CMFCTabCtrl::GetScrollBar`

`CMFCTabCtrl::GetTabArea`

`CMFCTabCtrl::GetTabMaxWidth`

`CMFCTabCtrl::GetTabsHeight`

`CMFCTabCtrl::GetTabsRect`

`CMFCTabCtrl::GetWndArea`

`CMFCTabCtrl::HideActiveWindowHorzScrollBar`

`CMFCTabCtrl::HideInactiveWindow`

`CMFCTabCtrl::HideNoTabs`

`CMFCTabCtrl::HideSingleTab`

`CMFCTabCtrl::IsActiveInMDITabGroup`

`CMFCTabCtrl::IsActiveTabBoldFont`

`CMFCTabCtrl::IsActiveTabCloseButton`

`CMFCTabCtrl::IsDrawFrame`

`CMFCTabCtrl::IsFlatFrame`

`CMFCTabCtrl::IsFlatTab`

`CMFCTabCtrl::IsLeftRightRounded`

`CMFCTabCtrl::IsMDITabGroup`

`CMFCTabCtrl::IsOneNoteStyle`

`CMFCTabCtrl::IsSharedScroll`

`CMFCTabCtrl::IsTabDocumentsMenu`

`CMFCTabCtrl::IsVS2005Style`

`CMFCTabCtrl::m_bEnableActivate`

`CMFCTabCtrl::ModifyTabStyle`

`CMFCTabCtrl::OnDragEnter`

`CMFCTabCtrl::OnDragOver`

`CMFCTabCtrl::OnShowTabDocumentsMenu`

`CMFCTabCtrl::SetActiveInMDITabGroup`

`CMFCTabCtrl::SetActiveTab`

`CMFCTabCtrl::SetActiveTabBoldFont`

`CMFCTabCtrl::SetDrawFrame`

`CMFCTabCtrl::SetFlatFrame`

`CMFCTabCtrl::SetImageList`

`CMFCTabCtrl::SetResizeMode`

`CMFCTabCtrl::SetTabMaxWidth`