CMFCRibbonStatusBar クラス

[アーティクル]
09/17/2008

更新 : 2007 年 11 月

CMFCRibbonStatusBar クラスは、リボン要素を表示できるステータスバーコントロールを実装します。

class CMFCRibbonStatusBar : public CMFCRibbonBar

メンバ

パブリックメソッド

名前	説明
CMFCRibbonStatusBar::AddDynamicElement	リボンステータスバーに動的な要素を追加します。
CMFCRibbonStatusBar::AddElement	新しいリボン要素をリボンステータスバーに追加します。
CMFCRibbonStatusBar::AddExtendedElement	リボンステータスバーの拡張領域にリボン要素を追加します。
CMFCRibbonStatusBar::AddSeparator	リボンステータスバーに区分線を追加します。
CMFCRibbonStatusBar::Create	リボンステータスバーを作成します。
CMFCRibbonStatusBar::CreateEx	拡張スタイルを持つリボンステータスバーを作成します。
CMFCRibbonStatusBar::FindByID
CMFCRibbonStatusBar::FindElement	指定したコマンド ID を持つ要素へのポインタを返します。
CMFCRibbonStatusBar::GetCount	リボンステータスバーのメイン領域にある要素数を返します。
CMFCRibbonStatusBar::GetElement	指定されたインデックスにある要素へのポインタを返します。
CMFCRibbonStatusBar::GetExCount	リボンステータスバーの拡張領域にある要素数を返します。
CMFCRibbonStatusBar::GetExElement	リボンステータスバーの拡張領域で、指定されたインデックスにある要素へのポインタを返します。
CMFCRibbonStatusBar::GetExtendedArea
CMFCRibbonStatusBar::GetSpace
CMFCRibbonStatusBar::IsBottomFrame
CMFCRibbonStatusBar::IsExtendedElement
CMFCRibbonStatusBar::IsInformationMode	リボンステータスバーの情報モードが有効かどうかを判断します。
CMFCRibbonStatusBar::RecalcLayout	(CMFCRibbonBar::RecalcLayout をオーバーライドします)。
CMFCRibbonStatusBar::RemoveAll	リボンステータスバーからすべての要素を削除します。
CMFCRibbonStatusBar::RemoveElement	指定したコマンド ID を持つ要素をリボンステータスバーから削除します。
CMFCRibbonStatusBar::SetInformation	リボンステータスバーの情報モードを有効または無効にします。

プロテクトメソッド

名前	説明
CMFCRibbonStatusBar::OnDrawInformation	情報モードが有効である場合に、リボンステータスバーに表示される情報文字列を表示します。

解説

ユーザーは、リボンステータスバーの組み込みコンテキストメニューを使用して、リボンステータスバー上のリボン要素の表示状態を変更できます。要素の追加または削除を動的に行うことができます。

リボンステータスバーには、メイン領域と拡張領域の 2 つの領域があります。拡張領域は、リボンステータスバーの右側にメイン領域とは異なる色で表示されます。

通常、ステータスバーのメイン領域には状態通知が表示され、拡張領域にはビューコントロールが表示されます。拡張領域は、ユーザーがリボンステータスバーのサイズを変更した場合も、可能な限り表示されています。

使用例

CMFCRibbonStatusBar クラスのさまざまなメソッドの使用方法を次の例に示します。リボンステータスバーへの新しいリボン要素の追加、リボンステータスバーの拡張領域へのリボン要素の追加、区分線の追加、およびリボンステータスバーの通常モードの有効化を行う方法を示しています。

  // CMFCRibbonStatusBar  m_wndStatusBar
    m_wndStatusBar.AddElement(rsbp, strTitlePane1);
    m_wndStatusBar.AddExtendedElement(new CMFCRibbonStatusBarPane(ID_STATUSBAR_PANE2, strTitlePane2, TRUE), 
        strTitlePane2);


...


    m_wndStatusBar.AddSeparator();
    m_wndStatusBar.SetInformation(NULL);