CMFCRibbonCheckBox 类

项目
10/16/2023

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

要求

标头：afxribboncheckbox.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；否则返回 FALSE。

备注

CMFCRibbonCheckBox::OnDraw

由框架调用以使用指定的设备上下文绘制复选框。

virtual void OnDraw(CDC* pDC);

参数

pDC
[in] 指向要在其中绘制复选框的 CDC 的指针。

备注

CMFCRibbonCheckBox::OnDrawMenuImage

由框架调用以绘制复选框的菜单图像。

virtual BOOL OnDrawMenuImage(CDC*, CRect);

参数

[in] CDC*
指向与复选框关联的 CDC 的指针。

CRect
[in] 一个 CRect 对象，指定要在其中绘制菜单图像的矩形。

返回值

如果已绘制图像，则返回 TRUE；否则返回 FALSE。

注解

如果未重写，则返回 FALSE。

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；否则为 FALSE。

bHighlighted
[in] 如果突出显示了复选框，则为 TRUE；否则为 FALSE。

备注

CMFCRibbonCheckBox::SetACCData

设置复选框的可访问性数据。

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

参数

pParent
复选框的父窗口。

data
复选框的可访问性数据。

返回值

始终返回 TRUE。

注解

默认情况下，此方法将设置复选框的可访问性数据，并始终返回 TRUE。重写此方法以设置可访问性数据并返回一个指示成功或失败的值。

另请参阅

层次结构图
 类
 CMFCRibbonPanel 类

通过