次の方法で共有


CMFCRibbonBar::FindByID

更新 : 2007 年 11 月

指定したコマンド ID を持つリボン要素を検索します。

CMFCRibbonBaseElement* FindByID(
   UINT uiCmdID,
   BOOL bVisibleOnly=TRUE,
   BOOL bExcludeQAT=FALSE 
) const;

パラメータ

  • [入力] uiCmdID
    リボン要素の検索に使用するコマンド ID を指定します。

  • [入力] bVisibleOnly
    TRUE の場合、表示されている要素のリストのみが検索されます。

  • [入力] bExcludeQAT
    TRUE の場合、クイック アクセス ツール バー要素は除外されます。

戻り値

指定したコマンド ID を持つリボン要素への有効なポインタ。指定したコマンド ID を持つ要素が存在しないか、要素が非表示で bVisibleOnly フラグが TRUE の場合は NULL。

解説

リボン要素は、リボンに追加できるリボン ボタンなどのリボン コントロール、リボン カテゴリ、またはリボン スライダです。

このメソッドを使用して、コマンド ID でリボン要素を検索します。通常は、指定したコマンド ID を持つ複数の要素が存在します。指定された ID を使用するすべての要素へのポインタを取得するには、CMFCRibbonBar::GetElementsByID メソッドを使用します。

必要条件

ヘッダー : afxribbonbar.h

参照

概念

MFC 階層図

参照

CMFCRibbonBar クラス