CMFCRibbonCheckBox クラス

CMFCRibbonCheckBox クラスは、リボン パネル、クイック アクセス ツール バー、またはポップアップ メニューに追加できるチェック ボックスを実装します。

構文

class CMFCRibbonCheckBox : public CMFCRibbonButton

メンバー

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

名前	説明
CMFCRibbonCheckBox::CMFCRibbonCheckBox	コンストラクター。

パブリック メソッド

名前	説明
CMFCRibbonCheckBox::GetCompactSize	(オーバーライド CMFCRibbonButton::GetCompactSize.)
CMFCRibbonCheckBox::GetIntermediateSize	(オーバーライド CMFCRibbonButton::GetIntermediateSize.)
CMFCRibbonCheckBox::GetRegularSize	(オーバーライド CMFCRibbonButton::GetRegularSize.)
CMFCRibbonCheckBox::IsDrawTooltipImage	( CMFCRibbonButton::IsDrawTooltipImageをオーバーライドします)。
CMFCRibbonCheckBox::OnDraw	(オーバーライド CMFCRibbonButton::OnDraw.)
CMFCRibbonCheckBox::OnDrawMenuImage	(オーバーライド CMFCRibbonBaseElement::OnDrawMenuImage.)
CMFCRibbonCheckBox::OnDrawOnList	( CMFCRibbonButton::OnDrawOnListをオーバーライドします)。
CMFCRibbonCheckBox::SetACCData	(オーバーライド CMFCRibbonButton::SetACCData.)

解説

CMFCRibbonCheckBox をアプリケーションで使用するには、次のコンストラクターをコードに追加します。

CMFCRibbonCheckBox (UINT nID, LPCTSTR lpszText)

ここで、nID は チェック ボックス コマンド ID、lpszText は チェック ボックスのテキスト ラベルです。

CMFCRibbonPanel::Add を使用して、リボン パネルにチェック ボックスを追加できます。

継承階層

CObject

CMFCRibbonBaseElement

CMFCRibbonButton

CMFCRibbonCheckBox

必要条件

ヘッダー: afxribbonチェックbox.h

CMFCRibbonCheckBox::CMFCRibbonCheckBox

リボン チェック ボックス オブジェクトのコンストラクター

CMFCRibbonCheckBox(
    UINT nID,
    LPCTSTR lpszText);

パラメーター

nID
[in]コマンド ID を指定します。

lpszText
[in]テキスト ラベルを指定します。

戻り値

リボン チェックボックス オブジェクトを作成します。

例

次の例では、クラスのオブジェクトを構築する方法を CMFCRibbonCheckBox 示します。

strTemp.LoadString(IDS_RIBBON_STATUSBAR);
CMFCRibbonButton *pBtnStatusBar = new CMFCRibbonCheckBox(ID_VIEW_STATUS_BAR, strTemp);

CMFCRibbonCheckBox::GetCompactSize

オーバーライドされると、チェック ボックスのコンパクト サイズを取得します。

virtual CSize GetCompactSize(CDC* pDC);

パラメーター

pDC
[in]チェック ボックスに関連付けられている CDC へのポインター。

戻り値

CSizeチェック ボックスのコンパクト サイズを含むオブジェクトを返します。

解説

オーバーライドされない場合は、チェック ボックスの中間サイズを返します。

CMFCRibbonCheckBox::GetIntermediateSize

チェック ボックスの中間サイズを取得します。

virtual CSize GetIntermediateSize(CDC* pDC);

パラメーター

pDC
[in]このチェック ボックスに関連付けられている CDC へのポインター。

戻り値

CSizeチェック ボックスの中間サイズを含むオブジェクト。

解説

オーバーライドされない場合は、中間サイズを既定の チェック ボックス サイズ ( AFX_CHECK_BOX_DEFAULT_SIZE) にテキスト サイズと余白を加えた値として計算します。

CMFCRibbonCheckBox::GetRegularSize

チェック ボックスの通常のサイズを取得します。

virtual CSize GetRegularSize(CDC* pDC);

パラメーター

pDC
[in]このチェック ボックスに関連付けられている CDC オブジェクトへのポインター。

戻り値

CSizeチェック ボックスの標準サイズを含むオブジェクトを返します。

解説

オーバーライドされない場合は、チェック ボックスの中間サイズを返します。

CMFCRibbonCheckBox::IsDrawTooltipImage

チェック ボックスに関連付けられたツールヒント イメージがあるかどうかを示します。

virtual BOOL IsDrawTooltipImage() const;

戻り値

チェック ボックスに関連付けられたツールヒント イメージがある場合は TRUE、関連付けられていない場合は FAL Standard Edition を返します。

解説

CMFCRibbonCheckBox::OnDraw

指定したデバイス コンテキストを使用してチェック ボックスを描画するためにフレームワークによって呼び出されます。

virtual void OnDraw(CDC* pDC);

パラメーター

pDC
[in]チェック ボックスを描画する CDC へのポインター。

解説

CMFCRibbonCheckBox::OnDrawMenuImage

チェック ボックスのメニュー イメージを描画するためにフレームワークによって呼び出されます。

virtual BOOL OnDrawMenuImage(CDC*, CRect);

パラメーター

[入力] CDC*
チェック ボックスに関連付けられている CDC へのポインター。

Crect
[in] CRect メニュー イメージを描画する四角形を指定するオブジェクト。

戻り値

イメージが描画された場合は TRUE、そうでない場合は FAL Standard Edition を返します。

解説

オーバーライドされない場合は、FAL Standard Edition を返します。

CMFCRibbonCheckBox::OnDrawOnList

コマンド リスト ボックスに チェック ボックスを描画するためにフレームワークによって呼び出されます。

virtual void OnDrawOnList(
    CDC* pDC,
    CString strText,
    int nTextOffset,
    CRect rect,
    BOOL bIsSelected,
    BOOL bHighlighted);

パラメーター

pDC
[in]チェック ボックスを描画するデバイス コンテキストへのポインター。

strText
[in]表示テキスト。

nTextOffset
[in]リスト ボックスの左側から表示テキストまでの距離 (ピクセル単位)。

rect
[in]チェック ボックスの表示四角形。

bIsSelected
[in]チェック ボックスが選択されている場合は TRUE、選択されていない場合は FAL Standard Edition。

bHighlighted
[in]チェック ボックスが強調表示されている場合は TRUE、そうでない場合は FAL Standard Edition。

解説

CMFCRibbonCheckBox::SetACCData

チェック ボックスのアクセシビリティ データを設定します。

virtual BOOL SetACCData(
    CWnd* pParent,
    CAccessibilityData& data);

パラメーター

pParent
チェック ボックスの親ウィンドウ。

data
チェック ボックスのアクセシビリティ データ。

戻り値

常に TRUE が返されます。

解説

既定では、このメソッドはチェック ボックスのアクセシビリティ データを設定し、常に TRUE を返します。 アクセシビリティ データを設定し、成功または失敗を示す値を返すようにするには、このメソッドをオーバーライドします。

関連項目

階層図
クラス
CMFCRibbonPanel クラス