CCheckListBox选件类

提供Windows检查表框中的功能。

class CCheckListBox : public CListBox

成员

d58s8sak.collapse_all(zh-cn,VS.110).gif公共构造函数

名称

说明

CCheckListBox::CCheckListBox

构造 CCheckListBox 对象。

d58s8sak.collapse_all(zh-cn,VS.110).gif公共方法

名称

说明

CCheckListBox::Create

创建Windows检查表框并附加到 CCheckListBox 对象。

CCheckListBox::DrawItem

调用由结构,当所有者描述的可视方面是列表框更改。

CCheckListBox::Enable

启用或禁用检查表框项。

CCheckListBox::GetCheck

获取项目的复选框的状态。

CCheckListBox::GetCheckStyle

获取控件的复选框的样式。

CCheckListBox::IsEnabled

确定项目是否启用。

CCheckListBox::MeasureItem

调用由结构,当具有所有者描述样式的列表框创建。

CCheckListBox::OnGetCheckPosition

调用由框架获取项目的复选框的位置。

CCheckListBox::SetCheck

设置项目的复选框的状态。

CCheckListBox::SetCheckStyle

设置控件的复选框的样式。

备注

“检查表框中”显示一个项列表,例如文件名。在列表中的每个项都有一个复选框旁边的用户可以选中或清除。

CCheckListBox 仅用于所有者描述的控件,因为列表比文本字符串包含更多。在其最简单,检查表框包含文本字符串和复选框,但是,您根本不需要具有文本。例如,可以在每个项旁边的小的位图列出了与复选框。

若要创建自己的检查表框中,必须从 CCheckListBox派生您的选件类。派生您的选件类,编写派生类的构造函数,然后调用 Create

如果希望处理Windows列表框发送的通知消息到其父(通常从 CDialog派生的选件类)中,添加一个消息映射项和消息处理程序成员函数为每个消息的父选件类。

每个消息映射项采用以下形式:

ON_通知(id,memberFxn)

其中 id 指定将控件的子窗口ID通知和 memberFxn 是您处理编写通知父成员函数的名称。

父的函数原型如下所示:

afx_msgvoidmemberFxn**( );**

只有专门与 CCheckListBox 的消息地图项(但是,对于 CListBox还请参见消息映射项):

  • ON_CLBN_CHKCHANGE 用户更改了项目的复选框的状态。

如果您的检查表框是默认检查表框(字符串列表与默认大小复选框的在每个左侧),可以使用默认 CCheckListBox::DrawItem 绘制检查表框。否则,必须重写 CListBox::CompareItem 功能和 CCheckListBox::DrawItemCCheckListBox::MeasureItem 功能。

您可以创建一个检查表框将从对话框模板或直接在代码。

继承层次结构

CObject

CCmdTarget

CWnd

CListBox

CCheckListBox

要求

**标头:**afxwin.h

请参见

参考

CListBox选件类

层次结构图

CListBox选件类

概念

MFC示例TSTCON