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 向功能区面板添加复选框。
继承层次结构
要求
标头：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。 重写此方法以设置可访问性数据并返回一个指示成功或失败的值。