CMFCOutlookBarTabCtrl クラス

[アーティクル]
08/04/2024

Microsoft Outlook の ナビゲーションウィンドウ と同じ外観を持つタブコントロールです。詳細については、Visual Studio のインストールの VC\atlmfc\src\mfc フォルダーにあるソースコードを参照してください。

構文

class CMFCOutlookBarTabCtrl : public CMFCBaseTabCtrl

メンバー

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

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

パブリックメソッド

名前	説明
CMFCOutlookBarTabCtrl::AddControl	Outlook バーの新しいタブとして Windows コントロールを追加します。
`CMFCOutlookBarTabCtrl::CalcRectEdit`	ユーザーがタブの名前を変更したときに表示される編集ボックスのディメンションを決定するために、フレームワークによって呼び出されます ( `CMFCBaseTabCtrl::CalcRectEdit`オーバーライドします)。
CMFCOutlookBarTabCtrl::CanShowFewerPageButtons	サイズ変更操作中にフレームワークによって呼び出され、表示できる Outlook バーのタブページボタンが現在表示されているボタンよりも少ないかどうかを判断します。
CMFCOutlookBarTabCtrl::CanShowMorePageButtons	サイズ変更操作中にフレームワークによって呼び出され、現在表示されているよりも多くの Outlook バータブページボタンを表示できるかどうかを判断します。
CMFCOutlookBarTabCtrl::Create	Outlook バータブコントロールを作成します。
`CMFCOutlookBarTabCtrl::CreateObject`	このクラス型の動的インスタンスを作成するために、フレームワークで使用されます。
CMFCOutlookBarTabCtrl::EnableAnimation	アクティブなタブ間の切り替え中に発生するアニメーションを有効にするかどうかを指定します。
CMFCOutlookBarTabCtrl::EnableInPlaceEdit	ユーザーが Outlook バーのタブボタンのテキストラベルを変更できるかどうかを指定します。 ( をオーバーライドしますCMFCBaseTabCtrl::EnableInPlaceEdit.)
CMFCOutlookBarTabCtrl::EnableScrollButtons	Outlook バーウィンドウでユーザーがボタンをスクロールできるようにするボタンを有効にするために、フレームワークによって呼び出されます。
`CMFCOutlookBarTabCtrl::FindTargetWnd`	指定された点を含むペインを特定します。 ( をオーバーライドしますCMFCBaseTabCtrl::FindTargetWnd.)
CMFCOutlookBarTabCtrl::GetBorderSize	Outlook タブコントロールの境界線のサイズを返します。
`CMFCOutlookBarTabCtrl::GetTabArea`	タブコントロールのタブ領域のサイズと位置を取得します。 ( をオーバーライドしますCMFCBaseTabCtrl::GetTabArea.)
`CMFCOutlookBarTabCtrl::GetThisClass`	このクラス型に関連付けられている CRuntimeClass オブジェクトへのポインターを取得するためにフレームワークによって使用されます。
CMFCOutlookBarTabCtrl::GetVisiblePageButtons
CMFCOutlookBarTabCtrl::IsAnimation	アクティブなタブ間の切り替え中に発生するアニメーションを有効にするかどうかを指定します。
CMFCOutlookBarTabCtrl::IsMode2003	Outlook バータブコントロールが、Microsoft Outlook 2003 をエミュレートするモードであるかどうかを判断します。
`CMFCOutlookBarTabCtrl::IsPtInTabArea`	ポイントがタブ領域内にあるかどうかを指定します。 ( をオーバーライドしますCMFCBaseTabCtrl::IsPtInTabArea.)
`CMFCOutlookBarTabCtrl::IsTabDetachable`	タブが切り離し可能であるかどうかを指定します。 ( をオーバーライドしますCMFCBaseTabCtrl::IsTabDetachable.)
`CMFCOutlookBarTabCtrl::OnChangeTabs`	タブが挿入または削除されたときにフレームワークによって呼び出されます。 ( `CMFCBaseTabCtrl::OnChangeTabs`をオーバーライドします)。
CMFCOutlookBarTabCtrl::OnShowFewerPageButtons	表示されるタブページボタンの数を減らすためにフレームワークによって呼び出されます。
CMFCOutlookBarTabCtrl::OnShowMorePageButtons	表示されるタブページボタンの数を増やすためにフレームワークによって呼び出されます。
CMFCOutlookBarTabCtrl::OnShowOptions	[ ナビゲーションウィンドウのオプションダイアログを表示します。
`CMFCOutlookBarTabCtrl::RecalcLayout`	タブコントロールの内部レイアウトを再計算します。 ( をオーバーライドしますCMFCBaseTabCtrl::RecalcLayout.)
CMFCOutlookBarTabCtrl::SetActiveTab	アクティブなタブを設定します (CMFCBaseTabCtrl::SetActiveTab をオーバーライドします)。
CMFCOutlookBarTabCtrl::SetBorderSize	Outlook タブコントロールの罫線のサイズを設定します。
CMFCOutlookBarTabCtrl::SetPageButtonTextAlign	Outlook バーのタブボタンのテキストラベルの配置を設定します。
CMFCOutlookBarTabCtrl::SetToolbarImageList	Outlook 2003 モードで Outlook バーの下部に表示されるアイコンを含むビットマップを設定します ( CMFCOutlookBar クラスを参照)。
CMFCOutlookBarTabCtrl::SetVisiblePageButtons

解説

ドッキングをサポートする Outlook バーを作成するには、 CMFCOutlookBar オブジェクトを使用して Outlook バータブコントロールをホストします。詳細については、「 CMFCOutlookBar クラスを参照してください。

例

次の例では、 CMFCOutlookBarTabCtrl オブジェクトを初期化し、 CMFCOutlookBarTabCtrl クラスのさまざまなメソッドを使用する方法を示します。この例では、Outlook バーのタブページボタンでテキストラベルのインプレース編集を有効にする方法、アニメーションを有効にする方法、ユーザーが Outlook バーウィンドウのボタンをスクロールできるようにするスクロールハンドルを有効にする方法、Outlook タブコントロールの境界線サイズを設定する方法、Outlook バーのタブボタンにテキストラベルの配置を設定する方法を示します。このコードスニペットは、 Outlook デモサンプルの一部です。

// CMFCOutlookBar& bar
CMFCOutlookBarTabCtrl *pOutlookBar = (CMFCOutlookBarTabCtrl*)bar.GetUnderlyingWindow();

pOutlookBar->EnableInPlaceEdit(TRUE);
pOutlookBar->EnableAnimation();
pOutlookBar->EnableScrollButtons();
pOutlookBar->SetBorderSize(10);
pOutlookBar->SetPageButtonTextAlign(TA_LEFT);

継承階層

CMFCOutlookBarTabCtrl

要件

Header: afxoutlookbartabctrl.h

CMFCOutlookBarTabCtrl::AddControl

Outlook バーの新しいタブとして Windows コントロールを追加します。

void AddControl(
    CWnd* pWndCtrl,
    LPCTSTR lpszName,
    int nImageID=-1,
    BOOL bDetachable=TRUE,
    DWORD dwControlBarStyle=AFX_CBRS_FLOAT |  AFX_CBRS_CLOSE | AFX_CBRS_RESIZE |  CBRS_AFX_AUTOHIDE);

パラメーター

pWndCtrl
[in]追加するコントロールへのポインター。

lpszName
[in]タブの名前を指定します。

bDetachable
[in]TRUE の場合、ページはデタッチ可能として作成されます。

nImageID
[in]新しいタブに表示するイメージの内部イメージリスト内のイメージインデックス。

dwControlBarStyle
[in]ラップされたドッキングウィンドウのAFX_ CBRS_* スタイルを指定します。

解説

この関数を使用して、Outlook バーの新しいページとしてコントロールを追加します。

この関数は、 CMFCBaseTabCtrl::AddTab を内部的に呼び出します。

bDetachable を TRUE に設定すると、AddControl内部でCDockablePaneAdapter オブジェクトが作成され、追加されたコントロールがラップされます。タブ付きウィンドウのランタイムクラスが CMFCOutlookBar のランタイムクラスに自動的に設定され、フローティングフレームのランタイムクラスが CMultiPaneFrameWndに設定されます。

例

次の例では、CMFCOutlookBarTabCtrl クラスで AddControl メソッドを使用する方法を示します。このコードスニペットは、 Outlook デモサンプルの一部です。

// CMFCOutlookBarTabCtrl* pOutlookBar
// DWORD dwStyle = AFX_CBRS_FLOAT | AFX_CBRS_AUTOHIDE | AFX_CBRS_RESIZE
// CMFCOutlookBarPane pane1
// The third parameter is the image index.
pOutlookBar->AddControl(&pane1, _T("General"), 0, TRUE, dwStyle);

CMFCOutlookBarTabCtrl::CanShowFewerPageButtons

サイズ変更操作中にフレームワークによって呼び出され、表示できる Outlook バーのタブページボタンが現在表示されているボタンよりも少ないかどうかを判断します。

virtual BOOL CanShowFewerPageButtons() const;

戻り値

複数のボタンがある場合は TRUE。それ以外の場合は FALSE。

解説

Outlook バータブコントロールは、利用可能なスペースの量に応じて、ディスプレイにタブを動的に追加または削除します。このメソッドは、そのプロセスを支援するためにフレームワークによって使用されます。

CMFCOutlookBarTabCtrl::CanShowMorePageButtons

サイズ変更操作中にフレームワークによって呼び出され、現在表示されているよりも多くの Outlook バータブページボタンを表示できるかどうかを判断します。

virtual BOOL CanShowMorePageButtons() const;

戻り値

現在表示されていないボタンがある場合は TRUE。それ以外の場合は FALSE。

解説

Outlook バータブコントロールは、利用可能な会議室の量に応じて、ディスプレイにタブを動的に追加または削除します。このメソッドは、そのプロセスを支援するためにフレームワークによって使用されます。

CMFCOutlookBarTabCtrl::Create

Outlook バータブコントロールを作成します。

virtual BOOL Create(
    const CRect& rect,
    CWnd* pParentWnd,
    UINT nID);

パラメーター

rect
[in]初期サイズと位置をピクセル単位で指定します。

pParentWnd
[in]親ウィンドウをポイントします。 NULL は指定できません。

nID
[入力] コントロール ID。

戻り値

コントロールが正常に作成された場合は 0 以外。それ以外の場合は 0。

解説

通常、outlook バータブコントロールは、 CMFCOutlookBar クラスプロセスのWM_CREATE メッセージを制御するときに作成されます。

CMFCOutlookBarTabCtrl::EnableAnimation

アクティブなタブ間の切り替え中に発生するアニメーションを有効にするかどうかを指定します。

static void EnableAnimation(BOOL bEnable=TRUE);

パラメーター

bEnable
[in]アニメーションを有効にするか無効にするかを指定します。

解説

アニメーションを有効または無効にするには、この関数を呼び出します。ユーザーがタブページを開くと、アニメーションが有効になっている場合、ページのキャプションが上下にスライドします。アニメーションが無効になっている場合、ページはすぐにアクティブになります。

既定では、アニメーションは有効になっています。

CMFCOutlookBarTabCtrl::EnableInPlaceEdit

ユーザーが Outlook バーのタブページボタンのテキストラベルを変更できるかどうかを指定します。

virtual void EnableInPlaceEdit(BOOL bEnable);

パラメーター

bEnable
TRUE の場合は、テキストラベルのインプレース編集を有効にします。 FALSE の場合は、インプレース編集を無効にします。

解説

この関数を呼び出して、タブページボタンのテキストラベルのインプレース編集を有効または無効にします。既定では、インプレース編集は無効になっています。

CMFCOutlookBarTabCtrl::EnableScrollButtons

Outlook バーウィンドウでユーザーがボタンをスクロールできるようにするスクロールハンドルを有効にするために、フレームワークによって呼び出されます。

void EnableScrollButtons(
    BOOL bEnable = TRUE,
    BOOL bIsUp = TRUE,
    BOOL bIsDown = TRUE);

パラメーター

bEnable
[in]スクロールボタンを表示するかどうかを指定します。

bIsUp
[in]上部のスクロールバーを表示するかどうかを指定します。

bIsDown
[in]下のスクロールバーを表示するかどうかを指定します。

解説

スクロールボタンの表示を有効にします。このメソッドは、スクロールボタンを復元するためにアクティブなタブが変更されたときにフレームワークによって呼び出されます。

CMFCOutlookBarTabCtrl::GetBorderSize

Outlook タブコントロールの境界線のサイズを返します。

int GetBorderSize() const;

戻り値

境界線のサイズ (ピクセル単位)。

CMFCOutlookBarTabCtrl::GetVisiblePageButtons

int GetVisiblePageButtons() const;

戻り値

解説

CMFCOutlookBarTabCtrl::IsAnimation

アクティブなタブ間の切り替え中に発生するアニメーションを有効にするかどうかを指定します。

static BOOL IsAnimation();

戻り値

アニメーションが有効な場合は 0 以外。それ以外の場合は 0。

解説

アニメーションを有効または無効にするには、 CMFCOutlookBarTabCtrl::EnableAnimation 関数を呼び出します。

CMFCOutlookBarTabCtrl::IsMode2003

Outlook バータブコントロールが Microsoft Outlook 2003 をエミュレートするモードであるかどうかを判断します。

BOOL IsMode2003() const;

戻り値

Outlook バータブコントロールが Outlook 2003 モードの場合は TRUE。それ以外の場合は FALSE。

解説

この値は、 CMFCOutlookBar::SetMode2003 によって設定されます。

CMFCOutlookBarTabCtrl::OnShowFewerPageButtons

表示されるタブページボタンの数を減らすためにフレームワークによって呼び出されます。

virtual void OnShowFewerPageButtons();

解説

このメソッドは、コントロールのサイズが変更されたときに表示されるページタブボタンの数を調整します。

CMFCOutlookBarTabCtrl::OnShowMorePageButtons

表示されるタブページボタンの数を増やすためにフレームワークによって呼び出されます。

virtual void OnShowMorePageButtons();

解説

このメソッドは、コントロールのサイズが変更されたときに表示されるタブページボタンの数を調整します。

CMFCOutlookBarTabCtrl::OnShowOptions

[ ナビゲーションウィンドウのオプション ] ダイアログボックスを表示します。

virtual void OnShowOptions();

解説

[ ナビゲーションウィンドウのオプション ] ダイアログボックスでは、表示するタブページボタンと表示順序を選択できます。

このメソッドは、ユーザーがコントロールのカスタマイズメニューから Navigation Pane Options メニュー項目を選択すると、フレームワークによって呼び出されます。

CMFCOutlookBarTabCtrl::SetActiveTab

アクティブなタブを設定します。アクティブなタブは開いているタブで、その内容が表示されます。

virtual BOOL SetActiveTab(int iTab);

パラメーター

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

戻り値

指定したタブが正常に開かれた場合は 0 以外。それ以外の場合は 0。

解説

アクティブなタブを設定した場合の視覚効果は、アニメーションを有効にしているかどうかによって異なります。詳細については、「 CMFCOutlookBarTabCtrl::EnableAnimationを参照してください。

CMFCOutlookBarTabCtrl::SetBorderSize

Outlook タブコントロールの罫線のサイズを設定します。

void SetBorderSize(int nBorderSize);

パラメーター

nBorderSize
[in]新しい境界線のサイズをピクセル単位で指定します。

解説

新しい罫線のサイズを設定し、Outlook ウィンドウのレイアウトを再計算します。

CMFCOutlookBarTabCtrl::SetPageButtonTextAlign

Outlook バーのタブボタンのテキストラベルの配置を設定します。

void SetPageButtonTextAlign(
    UINT uiAlign,
    BOOL bRedraw=TRUE);

パラメーター

uiAlign
[in]テキストの配置を指定します。

bRedraw
[in]TRUE の場合、Outlook ウィンドウが再描画されます。

解説

この関数を使用して、ページボタンのテキストの配置を変更します。

uiAlign には、次のいずれかの値を指定できます。

定数	意味
TA_LEFT	左揃え
TA_CENTER	中央揃え
TA_RIGHT	右揃え

既定値は TA_CENTER です。

CMFCOutlookBarTabCtrl::SetToolbarImageList

Outlook 2003 モードの Outlook バーの下部に表示されるアイコンを含むビットマップを設定します。

BOOL SetToolbarImageList(
    UINT uiID,
    int cx,
    COLORREF clrTransp=RGB(255, 0, 255));

パラメーター

uiID
[in]読み込むイメージのリソース ID を指定します。

cx
[in]イメージリスト内のイメージの幅をピクセル単位で指定します。

clrTransp
[in]透明な色を指定する RGB 値。

戻り値

成功した場合は TRUE を返します。それ以外の場合は FALSE を返します。

解説

この関数を使用して、Microsoft Office 2003 モードのツールバーボタンに画像が表示されるイメージリストを添付します。イメージインデックスはページインデックスに対応している必要があります。

Microsoft Office 2003 モードでない場合は、このメソッドを呼び出さないでください。詳細については、「 CMFCOutlookBar クラスを参照してください。

CMFCOutlookBarTabCtrl::SetVisiblePageButtons

void SetVisiblePageButtons(int nVisiblePageButtons);

パラメーター

[入力] nVisiblePageButtons

次の方法で共有

CMFCOutlookBarTabCtrl クラス

構文

メンバー

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

パブリック メソッド

解説

例

継承階層

要件

CMFCOutlookBarTabCtrl::AddControl

パラメーター

解説

例

CMFCOutlookBarTabCtrl::CanShowFewerPageButtons

戻り値

解説

CMFCOutlookBarTabCtrl::CanShowMorePageButtons

戻り値

解説

CMFCOutlookBarTabCtrl::Create

パラメーター

戻り値

解説

CMFCOutlookBarTabCtrl::EnableAnimation

パラメーター

解説

CMFCOutlookBarTabCtrl::EnableInPlaceEdit

パラメーター

解説

CMFCOutlookBarTabCtrl::EnableScrollButtons

パラメーター

解説

CMFCOutlookBarTabCtrl::GetBorderSize

戻り値

CMFCOutlookBarTabCtrl::GetVisiblePageButtons

戻り値

解説

CMFCOutlookBarTabCtrl::IsAnimation

戻り値

解説

CMFCOutlookBarTabCtrl::IsMode2003

戻り値

解説

CMFCOutlookBarTabCtrl::OnShowFewerPageButtons

解説

CMFCOutlookBarTabCtrl::OnShowMorePageButtons

解説

CMFCOutlookBarTabCtrl::OnShowOptions

解説

CMFCOutlookBarTabCtrl::SetActiveTab

パラメーター

戻り値

解説

CMFCOutlookBarTabCtrl::SetBorderSize

パラメーター

解説

CMFCOutlookBarTabCtrl::SetPageButtonTextAlign

パラメーター

解説

CMFCOutlookBarTabCtrl::SetToolbarImageList

パラメーター

戻り値

解説

CMFCOutlookBarTabCtrl::SetVisiblePageButtons

パラメーター

解説

関連項目

フィードバック

その他のリソース

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

パブリックメソッド