Share via

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 Windows 関数と DispatchMessage Windows 関数にディスパッチされる前に、ウィンドウ メッセージをTranslateMessage変換します。 ( 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 作成します。

  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
[in] 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
[in] TRUEタブに閉じるボタンを表示する場合。それ以外の場合は . FALSE 既定値は FALSE です。

戻り値

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

解説

次の表では、パラメーターに指定できる値について 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 タブはタブ コントロールの上部にあります。

例

次の例では、クラスでメソッドを使用する Create 方法を CMFCTabCtrl 示します。 この例は、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

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

void EnableActiveTabCloseButton(BOOL bEnable=TRUE);

パラメーター

bEnable
[in] TRUEをクリックすると、アクティブなタブに [閉じる] FALSE ボタンが表示されます。タブ領域の右上隅に [閉じる] ボタンが表示されます。 既定値は TRUE です。

CMFCTabCtrl::EnableInPlaceEdit

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

virtual void EnableInPlaceEdit(BOOL bEnable);

パラメーター

bEnable
[in] TRUE 編集可能なタブ ラベルを有効にする場合。 FALSE をクリックすると、編集可能なタブ ラベルが無効になります。

解説

CMFCTabCtrl::EnableTabDocumentsMenu

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

void EnableTabDocumentsMenu(BOOL bEnable=TRUE);

パラメーター

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

解説

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

CMFCTabCtrl::EnsureVisible

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

virtual BOOL EnsureVisible(int iTab);

パラメーター

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

戻り値

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

解説

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

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();

戻り値

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

解説

このメソッドを使用して、タブ コントロールの埋め込みスクロール バーにアクセスします。 スクロール バー オブジェクトは、タブ コントロールにスタイルがある 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
[in] TRUE 非アクティブなウィンドウを表示しない。 FALSE をクリックすると、非アクティブなウィンドウが表示されます。 既定値は TRUE です。

解説

CMFCTabCtrl::HideNoTabs

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

void HideNoTabs(BOOL bHide=TRUE);

パラメーター

bHide
[in] TRUE タブ領域の描画を有効にするには、 FALSE を選択すると、描画が無効になります。 既定値は TRUE です。

解説

CMFCTabCtrl::HideSingleTab

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

virtual void HideSingleTab(BOOL bHide=TRUE);

パラメーター

bHide
[in] TRUE 単一のタブ付きウィンドウのタブを描画しない場合。 FALSE をクリックすると、1 つのタブが描画されます。既定値は TRUE.

解説

CMFCTabCtrl::IsActiveInMDITabGroup

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

BOOL IsActiveInMDITabGroup() const;

戻り値

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

解説

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

CMFCTabCtrl::IsActiveTabBoldFont

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

BOOL IsActiveTabBoldFont() const;

戻り値

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

解説

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

CMFCTabCtrl::IsActiveTabCloseButton

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

virtual BOOL IsActiveTabCloseButton() const;

戻り値

TRUE[閉じる] ボタンがアクティブなタブFALSEに表示されている場合は [閉じる] ボタンがタブ領域の右上隅に表示されます。

解説

CMFCTabCtrl::IsDrawFrame

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

BOOL IsDrawFrame() const;

戻り値

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

解説

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

CMFCTabCtrl::IsFlatFrame

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

BOOL IsFlatFrame() const;

戻り値

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

解説

このメソッドを 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

解説

このメソッドは、TRUEメソッドSTYLE_FLAT_SHARED_HORZ_SCROLLのCMFCTabCtrl::Createパラメーターが style .

CMFCTabCtrl::IsTabDocumentsMenu

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

BOOL IsTabDocumentsMenu() const;

戻り値

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

解説

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

CMFCTabCtrl::IsVS2005Style

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

virtual BOOL IsVS2005Style() const;

戻り値

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

解説

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

CMFCTabCtrl::m_bEnableActivate

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

static BOOL m_bEnableActivate;

解説

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

CMFCTabCtrl::ModifyTabStyle

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

BOOL ModifyTabStyle(Style style);

パラメーター

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

戻り値

常に 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]修飾子キーの状態を格納します。 このパラメーターは、次の値のビットごとの組み合わせ "or" (|) です。 MK_MBUTTONMK_CONTROLMK_SHIFTMK_ALTMK_LBUTTONMK_RBUTTON 詳細については、「マウス入力について」の「メッセージパラメーター」セクションを参照してください。

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

戻り値

常に DROPEFFECT_NONE、ドロップ ターゲットがデータを受け入れることができないことを意味します。

解説

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

既定では、このメソッドは常CMFCTabCtrl::OnDragOverに .DROPEFFECT_NONE

CMFCTabCtrl::OnDragOver

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

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

パラメーター

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

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

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

戻り値

常に DROPEFFECT_NONE です。

解説

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

CMFCTabCtrl::OnShowTabDocumentsMenu

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

virtual void OnShowTabDocumentsMenu(CPoint point);

パラメーター

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

解説

CMFCTabCtrl::SetActiveInMDITabGroup

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

void SetActiveInMDITabGroup(BOOL bActive);

パラメーター

bActive
[in] TRUE 現在のタブをアクティブなタブにします。 FALSE 現在のタブを非アクティブにします。

解説

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

CMFCTabCtrl::SetActiveTab

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

virtual BOOL SetActiveTab(int iTab);

パラメーター

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

戻り値

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

解説

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

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

CMFCTabCtrl::SetActiveTabBoldFont

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

void SetActiveTabBoldFont(BOOL bIsBold=TRUE);

パラメーター

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

解説

CMFCTabCtrl::SetDrawFrame

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

void SetDrawFrame(BOOL bDraw=TRUE);

パラメーター

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

解説

CMFCTabCtrl::SetFlatFrame

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

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

パラメーター

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

bRepaint
[in] 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 つ。 使用可能な値の一覧については、「解説」の表を参照してください。

解説

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
[in] TRUE 現在のサイズ変更操作を破棄する場合。 FALSE をクリックして、現在のサイズ変更操作を完了します。 どちらの場合も、フレームワークはサイズ変更四角形の描画を停止します。

CMFCTabCtrl::SynchronizeScrollBar

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

BOOL SynchronizeScrollBar(SCROLLINFO* pScrollInfo = NULL);

パラメーター

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

戻り値

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

解説

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

関連項目

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