リボン バー (CMFCRibbonBar クラス) に配置されているクイック アクセス ツール バーの既定の状態を管理するヘルパー クラス。
構文
class CMFCRibbonQuickAccessToolBarDefaultState
メンバー
パブリック コンストラクター
| 名前 | 説明 |
|---|---|
CMFCRibbonQuickAccessToolBarDefaultState::CMFCRibbonQuickAccessToolBarDefaultState |
CMFCRibbonQuickAccessToolbarDefaultState オブジェクトを構築します。 |
パブリック メソッド
| 名前 | 説明 |
|---|---|
CMFCRibbonQuickAccessToolBarDefaultState::AddCommand |
クイック アクセス ツール バーの既定の状態にコマンドを追加します。 このメソッドでは、ツール バー自体は変更されません。 |
CMFCRibbonQuickAccessToolBarDefaultState::CopyFrom |
クイック アクセス ツール バーのプロパティを別のクイック アクセス ツール バーにコピーします。 |
CMFCRibbonQuickAccessToolBarDefaultState::RemoveAll |
クイック アクセス ツール バーからすべてのコマンドを削除します。 このメソッドでは、ツール バー自体は変更されません。 |
解説
アプリケーションでクイック アクセス ツール バーを作成した後、 CMFCRibbonBar::SetQuickAccessDefaultStateを呼び出して既定の状態を設定することをお勧めします。 この既定の状態は、ユーザーがアプリケーションの Options ダイアログ ボックスの Customize ページで Reset ボタンを選択すると復元されます。
継承階層
CMFCRibbonQuickAccessToolBarDefaultState
例
次の例では、 CMFCRibbonQuickAccessToolbarDefaultState クラスのオブジェクトを作成する方法と、クイック アクセス ツール バーの既定の状態にコマンドを追加する方法を示します。
CMFCRibbonQuickAccessToolBarDefaultState *qaToolBarState =
new CMFCRibbonQuickAccessToolBarDefaultState();
qaToolBarState->AddCommand(ID_FILE_NEW, true);
qaToolBarState->AddCommand(ID_FILE_OPEN, true);
要件
Header: afxribbonquickaccesstoolbar.h
CMFCRibbonQuickAccessToolBarDefaultState::AddCommand
クイック アクセス ツール バーの既定の状態にコマンドを追加します。
void AddCommand(
UINT uiCmd,
BOOL bIsVisible=TRUE);
パラメーター
uiCmd
[in]コマンド ID を指定します。
bIsVisible
[in]クイック アクセス ツール バーが既定の状態にある場合のコマンドの表示を設定します。
解説
CMFCRibbonQuickAccessToolBarDefaultStateにコマンドを追加すると、3 つの結果が得られます。 最初に、追加された各コマンドがクイック アクセス ツール バーの右側のドロップダウンリストに表示されます。 この方法では、ユーザーはクイック アクセス ツール バーでそのコマンドを簡単に追加または削除できます。 次に、クイック アクセス ツール バーがリセットされ、ユーザーが [Customize] ダイアログ ボックスで [Reset] ボタンを選択すると、既定の状態で表示されるコマンドのみが表示されます。 3 番目に、 CMFCRibbonBar::SetQuickAccessCommandsを呼び出していない場合、クイック アクセス ツール バーでは、ユーザーが初めてアプリケーションを実行するときに、この一覧から表示されるコマンドが既定の表示コマンドとして使用されます。 必要なすべてのコマンドを追加したら、 CMFCRibbonBar::SetQuickAccessDefaultState を呼び出して、このインスタンスをリボン バーのクイック アクセス ツール バーの既定の状態として設定します。
CMFCRibbonQuickAccessToolBarDefaultState::CopyFrom
クイック アクセス ツール バーのプロパティを別のクイック アクセス ツール バーにコピーします。
void CopyFrom(const CMFCRibbonQuickAccessToolBarDefaultState& src);
パラメーター
src
[in]コピー元 CMFCRibbonQuickAccessToolBarDefaultState オブジェクトへの参照。
解説
このメソッドは、CMFCRibbonQuickAccessToolBarDefaultState::AddCommand メソッドを使用して、ソース CMFCRibbonQuickAccessToolBarDefaultState オブジェクトからこのオブジェクトに各コマンドをコピーします。
CMFCRibbonQuickAccessToolBarDefaultState::CMFCRibbonQuickAccessToolBarDefaultState
クイック アクセス ツール バーの既定の状態オブジェクトを構築します。
CMFCRibbonQuickAccessToolBarDefaultState();
解説
既定では、 CMFRibbonQuickAccessToolBarDefaultState の新しいインスタンスに含まれるコマンドの一覧は空です。
CMFCRibbonQuickAccessToolBarDefaultState::RemoveAll
クイック アクセス ツール バーの既定のコマンドの一覧をクリアします。
void RemoveAll();
解説
この関数は、前の呼び出しで追加されたすべてのコマンド CMFCRibbonQuickAccessToolBarDefaultState::AddCommand このインスタンスから削除します。