按钮（Windows 控件）

  • 项目

本部分包含有关与按钮控件一起使用的编程元素的信息。 按钮是用户可以单击用于向应用程序提供输入的控件。

概述

主题 目录
按钮消息 本主题讨论与按钮一起使用的消息。
Button 状态 本部分讨论如何选择按钮更改其状态以及应用程序应如何响应。
按钮类型 本主题讨论不同类型的按钮。
使用按钮 本部分介绍如何执行与按钮相关的特定任务。

函数

主题 目录
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 函数创建按钮，则可以指定下面列出的任何按钮样式。