CMFCOutlookBarPane クラス

[アーティクル]
08/09/2011

このトピックは、完全を期すために含まれています。詳細については、Visual Studio のインストールの VC\atlmfc\src\mfc フォルダーにあるソースコードを参照してください。

Outlook バー (CMFCOutlookBar クラス) に挿入できる、CMFCToolBar クラスから派生したコントロールです。 Outlook バーペインには、大きいボタンの列があります。ボタンのリストがペインより長い場合、ユーザーはリストを上下にスクロールできます。ユーザーが Outlook バーペインを Outlook バーから切り離すと、そのペインをフローティング状態にするかメインフレームウィンドウにドッキングできます。

class CMFCOutlookBarPane : public CMFCToolBar

メンバー

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

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

パブリックメソッド

[名前]	説明
CMFCOutlookBarPane::AddButton	Outlook バーペインにボタンを追加します。
CMFCOutlookBarPane::CanBeAttached	ペインを別のペインまたはフレームウィンドウにドッキングできるかどうかを判定します。 (CBasePane::CanBeAttached をオーバーライドします)。
CMFCOutlookBarPane::CanBeRestored	カスタマイズ後にツールバーを元の状態に復元できるかどうかを判断します (CMFCToolBar::CanBeRestored をオーバーライドします)。
CMFCOutlookBarPane::ClearAll	Outlook バーペインのイメージで使用されているリソースを解放します。
CMFCOutlookBarPane::Create	Outlook バーペインを作成します。
CMFCOutlookBarPane::CreateObject	このクラス型の動的インスタンスを作成するために、フレームワークによって使用されます。
CMFCOutlookBarPane::Dock	Outlook バーペインをドッキングするには、フレームワークによって呼び出されます。(上書きCPane::Dock.)
CMFCOutlookBarPane::EnablePageScrollMode	Outlook バーペインのスクロールバーの矢印ボタンをクリックしたときに、ボタンのリストをページ単位で進めるかリストのボタン単位で進めるかを指定します。
CMFCOutlookBarPane::GetRegularColor	Outlook バーペイン用の標準の (選択されていない) テキストの色を返します。
CMFCOutlookBarPane::GetThisClass	このクラス型に関連付けられた CRuntimeClass オブジェクトへのポインターを取得するために、フレームワークによって使用されます。
CMFCOutlookBarPane::IsBackgroundTexture	Outlook バーペイン用として読み込まれた背景イメージがあるかどうかを判定します。
CMFCOutlookBarPane::IsChangeState	フローティング状態のペインをドッキングできるかどうかを判断します (CPane::IsChangeState をオーバーライドします)。
CMFCOutlookBarPane::IsDrawShadedHighlight	ボタンが強調表示され、背景イメージが表示されたときに、ボタンの境界線を影付きにするかどうかを決定します。
CMFCOutlookBarPane::OnBeforeFloat	ペインがフローティング状態になる直前に、フレームワークによって呼び出されます (CPane::OnBeforeFloat をオーバーライドします)。
CMFCOutlookBarPane::RemoveButton	指定されたコマンド ID のボタンを削除します。
CMFCOutlookBarPane::RestoreOriginalstate	ツールバーの元の状態を復元します (CMFCToolBar::RestoreOriginalstate をオーバーライドします)。
CMFCOutlookBarPane::SetBackColor	背景色を設定します。
CMFCOutlookBarPane::SetBackImage	背景イメージを設定します。
CMFCOutlookBarPane::SetDefaultState	Outlook バーペインを元のボタンのセットにリセットします。
CMFCOutlookBarPane::SetExtraSpace	Outlook バーペインのボタンの周囲に使用される埋め込みのピクセル数を設定します。
CMFCOutlookBarPane::SetTextColor	Outlook バーペインでの通常のテキストと強調表示されたテキストの色を設定します。
CMFCOutlookBarPane::SetTransparentColor	Outlook バーペインの透明色を設定します。
CMFCOutlookBarPane::SmartUpdate	Outlook バーを更新するために内部で使用されます (CMFCToolBar::SmartUpdate をオーバーライドします)。

プロテクトメソッド

[名前]	説明
CMFCOutlookBarPane::EnableContextMenuItems	カスタマイズモードで表示するショートカットメニュー項目を指定します。
CMFCOutlookBarPane::RemoveAllButtons	Outlook バーペインからすべてのボタンを削除します (CMFCToolBar::RemoveAllButtons をオーバーライドします)。

解説

Outlook バーの実装方法の詳細については、「CMFCOutlookBar クラス」を参照してください。

Outlook バーの例については、OutlookDemo サンプルプロジェクトを参照してください。

使用例

次の例は、CMFCOutlookBarPane クラスのさまざまなメソッドの使用方法を説明しています。例では、Outlook バーペインの作成、ページスクロールモードの有効化、ドッキングの有効化、Outlook バーの背景色の設定について、その方法を示しています。このコードスニペットは、「OutlookMultiViews サンプル:複数のビューと Outlook バーのコントロールに SDI アプリケーション」の一部です。

    CMFCOutlookBarPane      m_wndShortcutsPane1;


...


    CImageList images;
    images.Create (IDB_SHORTCUTS, 32, 0, RGB (255, 0, 255));

    // Create first page:
    m_wndShortcutsPane1.Create (&m_wndShortcutsBar, AFX_DEFAULT_TOOLBAR_STYLE, ID_SHORTCUTS_PANE_1);
    // The this pointer points to a CMainFrame class which extends the CFrameWnd class
    m_wndShortcutsPane1.SetOwner (this);
    m_wndShortcutsPane1.EnableTextLabels ();
    m_wndShortcutsPane1.EnableDocking (CBRS_ALIGN_ANY);
    m_wndShortcutsPane1.EnablePageScrollMode();
    m_wndShortcutsPane1.SetBackColor(RGB(0,255,0));
    
    m_wndShortcutsPane1.AddButton (images.ExtractIcon (0), _T("View 1"), ID_SHORTCUT_1);
    m_wndShortcutsPane1.AddButton (images.ExtractIcon (1), _T("View 2"), ID_SHORTCUT_2);
    m_wndShortcutsPane1.AddButton (images.ExtractIcon (2), _T("View 3"), ID_SHORTCUT_3);
    m_wndShortcutsPane1.AddButton (images.ExtractIcon (3), _T("View 4"), ID_SHORTCUT_4);