次の方法で共有


CMFCTabCtrl クラス

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 クラス」を参照してください。

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

  1. CTabbedPane Class のインスタンスを作成します。

  2. CDockablePane::Create を呼び出します。

  3. CBaseTabbedPane::AddTabまたはCMFCBaseTabCtrl::InsertTabを使用して、新しいタブを追加します。

  4. 現在のドッキング タブ コントロールがメイン フレーム ウィンドウにドッキングできるように、 CBasePane::EnableDocking を呼び出します。

  5. CFrameWndEx::DockPaneを呼び出して、タブ付きウィンドウをメイン フレームにドッキングします。

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

継承階層

CObject

CCmdTarget

CWnd

CMFCBaseTabCtrl

CMFCTabCtrl

次の例は、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 ボタンがアクティブなタブに表示されている場合はFALSEClose ボタンがタブ領域の右上隅に表示されている場合は。

解説

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_CONTROLMK_SHIFTMK_ALTMK_LBUTTONMK_MBUTTONMK_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_CONTROLMK_SHIFTMK_ALTMK_LBUTTONMK_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 します。

解説

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

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

解説

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

関連項目

階層図
クラス
CDockablePane クラス
CMFCBaseTabCtrl クラス