本部分包含有关用于按钮控件的编程元素的信息。
按钮 是用户可以单击的控件，以便向应用程序提供输入。
综述
主题
内容
按钮消息
本主题讨论与按钮一起使用的消息。
按钮状态
本部分讨论如何选择按钮更改其状态以及应用程序应如何响应。
按钮类型
本主题讨论不同类型的按钮。
使用按钮
本部分介绍如何执行与按钮关联的某些任务。
功能
主题
内容
CheckDlgButton
更改按钮控件的检查状态。
CheckRadioButton
向组中的指定单选按钮添加复选标记，并从组中所有其他单选按钮中删除复选标记。
IsdlgButtonChecked
IsDlgButtonChecked 函数确定是检查按钮控件还是检查三态按钮控件、未选中还是不确定。
宏
主题
内容
Button_Enable
启用或禁用按钮。
Button_GetCheck
获取单选按钮或复选框的选中状态。 可以使用此宏或显式发送 BM_GETCHECK 消息。
Button_GetIdealSize
获取最适合文本和图像的按钮的大小（如果存在图像列表）。 可以使用此宏或显式发送 BCM_GETIDEALSIZE 消息。
Button_GetImageList
获取描述为按钮控件设置的图像列表的 BUTTON_IMAGELIST 结构。 可以使用此宏或显式发送 BCM_GETIMAGELIST 消息。
Button_GetNote
获取与命令链接按钮关联的注释的文本。 可以使用此宏或显式发送 BCM_GETNOTE 消息。
Button_GetNoteLength
获取可在命令链接的说明中显示的注释文本的长度。 使用此宏或显式发送 BCM_GETNOTELENGTH 消息。
Button_GetSplitInfo
获取指定拆分按钮控件的信息。 使用此宏或显式发送 BCM_GETSPLITINFO 消息。
Button_GetState
获取单选按钮或复选框的选中状态。 可以使用此宏或显式发送 BM_GETSTATE 消息。
Button_GetText
获取按钮的文本。
Button_GetTextLength
获取按钮文本中的字符数。
Button_GetTextMargin
获取用于在按钮控件中绘制文本的边距。 可以使用此宏或显式发送 BCM_GETTEXTMARGIN 消息。
Button_SetCheck
设置单选按钮或复选框的选中状态。 可以使用此宏或显式发送 BM_SETCHECK 消息。
Button_SetDropDownState
设置具有 BS_SPLITBUTTON样式的指定按钮的下拉状态。 使用此宏或显式发送 BCM_SETDROPDOWNSTATE 消息。
Button_SetElevationRequiredState
设置指定按钮或命令链接的提升所需状态以显示提升的图标。 使用此宏或显式发送 BCM_SETSHIELD 消息。
Button_SetImageList
将图像列表分配给按钮控件。 可以使用此宏或显式发送 BCM_SETIMAGELIST 消息。
Button_SetNote
设置与指定命令链接按钮关联的注释的文本。 可以使用此宏或显式发送 BCM_SETNOTE 消息。
Button_SetSplitInfo
设置指定拆分按钮控件的信息。 使用此宏或显式发送 BCM_SETSPLITINFO 消息。
Button_SetState
设置按钮的突出显示状态。 突出显示状态指示按钮是否突出显示，就像用户已推送按钮一样。 可以使用此宏或显式发送 BM_SETSTATE 消息。
Button_SetStyle
设置按钮的样式。 可以使用此宏或显式发送 BM_SETSTYLE 消息。
Button_SetText
设置按钮的文本。
Button_SetTextMargin
设置按钮控件中绘制文本的边距。 可以使用此宏或显式发送 BCM_SETTEXTMARGIN 消息。
消息
主题
内容
BCM_GETIDEALSIZE
获取最适合其文本和图像的按钮的大小（如果存在图像列表）。 可以显式发送此消息或使用 Button_GetIdealSize 宏。
BCM_GETIMAGELIST
获取描述分配给按钮控件的图像列表的 BUTTON_IMAGELIST 结构。 可以显式发送此消息或使用 Button_GetImageList 宏。
BCM_GETNOTE
获取与命令链接按钮关联的注释的文本。 可以显式发送此消息或使用 Button_GetNote 宏。
BCM_GETNOTELENGTH
获取可在命令链接按钮的说明中显示的注释文本的长度。 显式发送此消息或使用 Button_GetNoteLength 宏发送。
BCM_GETSPLITINFO
获取拆分按钮控件的信息。 显式发送此消息或使用 Button_GetSplitInfo 宏发送。
BCM_GETTEXTMARGIN
获取用于在按钮控件中绘制文本的边距。 可以显式发送此消息或使用 Button_GetTextMargin 宏。
BCM_SETDROPDOWNSTATE
设置具有样式 TBSTYLE_DROPDOWN按钮的下拉状态。 显式发送此消息或使用 Button_SetDropDownState 宏发送。
BCM_SETIMAGELIST
将图像列表分配给按钮控件。 可以显式发送此消息或使用 Button_SetImageList 宏。
BCM_SETNOTE
设置与命令链接按钮关联的注释的文本。 可以显式发送此消息或使用 Button_SetNote 宏。
BCM_SETSHIELD
设置指定按钮或命令链接的提升所需状态以显示提升的图标。 显式发送此消息或使用 Button_SetElevationRequiredState 宏发送。
BCM_SETSPLITINFO
设置拆分按钮控件的信息。 显式发送此消息或使用 Button_SetSplitInfo 宏发送。
BCM_SETTEXTMARGIN
BCM_SETTEXTMARGIN 消息设置按钮控件中绘制文本的边距。
BM_CLICK
模拟用户单击按钮。 此消息导致该按钮接收 WM_LBUTTONDOWN 和 WM_LBUTTONUP 消息，以及按钮的父窗口接收 BN_CLICKED 通知代码。
BM_GETCHECK
获取单选按钮或复选框的选中状态。 可以显式发送此消息或使用 Button_GetCheck 宏。
BM_GETIMAGE
检索与按钮关联的图像（图标或位图）的句柄。
BM_GETSTATE
检索按钮或复选框的状态。 可以显式发送此消息或使用 Button_GetState 宏。
BM_SETCHECK
设置单选按钮或复选框的选中状态。 可以显式发送此消息，也可以使用 Button_SetCheck 宏发送。
BM_SETDONTCLICK
在单选按钮上设置一个标志，该标志控制按钮接收焦点时 BN_CLICKED 消息的生成。
BM_SETIMAGE
将新图像（图标或位图）与按钮相关联。
BM_SETSTATE
设置按钮的突出显示状态。 突出显示状态指示按钮是否突出显示，就像用户已推送按钮一样。 可以显式发送此消息或使用 Button_SetState 宏。
BM_SETSTYLE
设置按钮的样式。 可以显式发送此消息或使用 Button_SetStyle 宏。
通知
主题
内容
BCN_DROPDOWN
当用户单击按钮上的下拉箭头时发送。 控件的父窗口以 WM_NOTIFY 消息的形式接收此通知代码。
BCN_HOTITEMCHANGE
通知按钮控件所有者鼠标正在进入或离开按钮控件的工作区。 按钮控件以 WM_NOTIFY 消息的形式发送此通知代码。
BN_CLICKED
当用户单击按钮时发送。 按钮的父窗口通过 WM_COMMAND 消息接收 BN_CLICKED 通知代码。
BN_DBLCLK
当用户双击按钮时发送。 此通知代码会自动为 BS_USERBUTTON、BS_RADIOBUTTON和 BS_OWNERDRAW 按钮发送。 仅当按钮类型具有 BS_NOTIFY 样式时，其他按钮类型才会发送 BN_DBLCLK。 按钮的父窗口通过 WM_COMMAND 消息接收 BN_DBLCLK 通知代码。
BN_DISABLE
禁用按钮时发送。
注意： 此通知代码仅用于与低于版本 3.0 的 16 位版本的 Windows 兼容。 应用程序应为此任务使用 BS_OWNERDRAW 按钮样式和 DRAWITEMSTRUCT 结构。 按钮的父窗口通过 WM_COMMAND 消息接收 BN_DISABLE 通知代码。
BN_DOUBLECLICKED
当用户双击按钮时发送。 此通知代码会自动为 BS_USERBUTTON、BS_RADIOBUTTON和 BS_OWNERDRAW 按钮发送。 仅当其他按钮类型具有 BS_NOTIFY 样式时，才会发送 BN_DOUBLECLICKED。 按钮的父窗口通过 WM_COMMAND 消息接收 BN_DOUBLECLICKED 通知代码。
BN_HILITE
当用户选择按钮时发送。
注意： 此通知代码仅用于与低于版本 3.0 的 16 位版本的 Windows 兼容。 应用程序应为此任务使用 BS_OWNERDRAW 按钮样式和 DRAWITEMSTRUCT 结构。 按钮的父窗口通过 WM_COMMAND 消息接收 BN_HILITE 通知代码。
BN_KILLFOCUS
当按钮失去键盘焦点时发送。 该按钮必须具有 BS_NOTIFY 样式才能发送此通知代码。 按钮的父窗口通过 WM_COMMAND 消息接收 BN_KILLFOCUS 通知代码。
BN_PAINT
应在绘制按钮时发送。
注意： 此通知代码仅用于与低于版本 3.0 的 16 位版本的 Windows 兼容。 应用程序应为此任务使用 BS_OWNERDRAW 按钮样式和 DRAWITEMSTRUCT 结构。 按钮的父窗口通过 WM_COMMAND 消息接收 BN_PAINT 通知代码。
BN_PUSHED
当按钮的推送状态设置为已推送时发送。
注意： 此通知代码仅用于与低于版本 3.0 的 16 位版本的 Windows 兼容。 应用程序应为此任务使用 BS_OWNERDRAW 按钮样式和 DRAWITEMSTRUCT 结构。 按钮的父窗口通过 WM_COMMAND 消息接收 BN_PUSHED 通知代码。
BN_SETFOCUS
当按钮接收键盘焦点时发送。 该按钮必须具有 BS_NOTIFY 样式才能发送此通知代码。 按钮的父窗口通过 WM_COMMAND 消息接收 BN_SETFOCUS 通知代码。
BN_UNHILITE
当应从按钮中删除突出显示时发送。
注意： 此通知代码仅用于与低于版本 3.0 的 16 位版本的 Windows 兼容。 应用程序应为此任务使用 BS_OWNERDRAW 按钮样式和 DRAWITEMSTRUCT 结构。 按钮的父窗口通过 WM_COMMAND 消息接收 BN_UNHILITE 通知代码。
BN_UNPUSHED
当按钮的推送状态设置为取消推送时发送。
注意： 此通知代码仅用于与低于版本 3.0 的 16 位版本的 Windows 兼容。 应用程序应为此任务使用 BS_OWNERDRAW 按钮样式和 DRAWITEMSTRUCT 结构。 按钮的父窗口通过 WM_COMMAND 消息接收 BN_UNPUSHED 通知代码。
NM_CUSTOMDRAW（按钮）
通知按钮控件的父窗口，说明按钮上的自定义绘图作。 按钮控件以 WM_NOTIFY 消息的形式发送此通知代码。
WM_CTLCOLORBTN
在绘制按钮之前，WM_CTLCOLORBTN 消息将发送到按钮的父窗口。 父窗口可以更改按钮的文本和背景颜色。 但是，只有所有者绘制的按钮响应处理此消息的父窗口。
结构
主题
内容
BUTTON_IMAGELIST
包含有关与按钮控件一起使用的图像列表的信息。
BUTTON_SPLITINFO
包含定义拆分按钮的信息（BS_SPLITBUTTON 和 BS_DEFSPLITBUTTON 样式）。 与 BCM_GETSPLITINFO 和 BCM_SETSPLITINFO 消息一起使用。
NMBCDROPDOWN
包含有关 BCN_DROPDOWN 通知的信息。
NMBCHOTITEM
包含有关鼠标在按钮控件上移动的信息。
常数
主题
内容
按钮样式
指定按钮样式的组合。 如果使用 BUTTON 类和 CreateWindow 或 CreateWindowEx 函数创建按钮，则可以指定下面列出的任何按钮样式。
