Кнопка (элементы управления Windows)

В этом разделе содержатся сведения о элементах программирования, используемых с элементами управления кнопками. Кнопка — это элемент управления, который пользователь может нажать, чтобы предоставить входные данные приложению.

Общие сведения

Раздел	Содержимое
Сообщения кнопки	В этом разделе рассматриваются сообщения, используемые с кнопками.
Состояния кнопки	В этом разделе описывается изменение состояния кнопки и реагирование приложения.
Типы кнопок	В этом разделе рассматриваются различные виды кнопок.
Использование кнопок	В этом разделе объясняется, как выполнять определенные задачи, связанные с кнопками.

Функции

Раздел	Содержимое
CheckDlgButton	Изменяет состояние проверка элемента управления кнопкой.
CheckRadioButton	Добавляет проверка метку в (проверка) указанную переключатель в группе и удаляет проверка метку из (очищает) все остальные переключатели в группе.
IsDlgButtonChecked	Функция IsDlgButtonChecked определяет, проверка ли элемент управления кнопкой или элемент управления кнопкой с тремя состояниями проверка, un проверка ed или неопределен.

Макросы

Раздел	Содержимое
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_SPLIТБ UTTON. Используйте этот макрос или явно отправьте сообщение 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	Задает раскрывающееся состояние кнопки со стилем ТБSTYLE_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.

Notifications

Раздел	Содержимое
BCN_DROPDOWN	Отправляется, когда пользователь щелкает стрелку раскрывающегося списка на кнопке. Родительское окно элемента управления получает этот код уведомления в виде сообщения WM_NOTIFY.
BCN_HOTITEMCHANGE	Уведомляет владельца элемента управления кнопки о том, что мышь вводит или покидает клиентская область элемента управления кнопки. Элемент управления кнопкой отправляет этот код уведомления в виде сообщения WM_NOTIFY.
BN_CLICKED	Отправляется, когда пользователь нажимает кнопку. Родительское окно кнопки получает код уведомления BN_CLICKED через сообщение WM_COMMAND .
BN_DBLCLK	Отправляется, когда пользователь дважды щелкает кнопку. Этот код уведомления отправляется автоматически для кнопок BS_USERBUTTON, BS_RADIOBUTTON и BS_OWNERDRAW. Другие типы кнопок отправляют BN_DBLCLK только в том случае, если они имеют стиль BS_NOTIFY. Родительское окно кнопки получает код уведомления BN_DBLCLK через сообщение WM_COMMAND.
BN_DISABLE	Отправляется при отключении кнопки. Примечание. Этот код уведомления предоставляется только для совместимости с 16-разрядными версиями Windows до версии 3.0. Приложения должны использовать стиль кнопки BS_OWNERDRAW и структуру DRAWITEMSTRUCT для этой задачи. Родительское окно кнопки получает код уведомления BN_DISABLE через сообщение WM_COMMAND.
BN_DOUBLECLICKED	Отправляется, когда пользователь дважды щелкает кнопку. Этот код уведомления отправляется автоматически для кнопок BS_USERBUTTON, BS_RADIOBUTTON и BS_OWNERDRAW. Другие типы кнопок отправляют BN_DOUBLECLICKED только в том случае, если они имеют стиль BS_NOTIFY. Родительское окно кнопки получает код уведомления BN_DOUBLECLICKED через сообщение WM_COMMAND .
BN_HILITE	Отправляется, когда пользователь выбирает кнопку. Примечание. Этот код уведомления предоставляется только для совместимости с 16-разрядными версиями Windows до версии 3.0. Приложения должны использовать стиль кнопки BS_OWNERDRAW и структуру DRAWITEMSTRUCT для этой задачи. Родительское окно кнопки получает код уведомления BN_HILITE через сообщение WM_COMMAND.
BN_KILLFOCUS	Отправляется, когда кнопка теряет фокус клавиатуры. Кнопка должна иметь стиль BS_NOTIFY для отправки этого кода уведомления. Родительское окно кнопки получает код уведомления BN_KILLFOCUS через сообщение WM_COMMAND .
BN_PAINT	Отправляется, когда кнопка должна быть окрашена. Примечание. Этот код уведомления предоставляется только для совместимости с 16-разрядными версиями Windows до версии 3.0. Приложения должны использовать стиль кнопки BS_OWNERDRAW и структуру DRAWITEMSTRUCT для этой задачи. Родительское окно кнопки получает код уведомления BN_PAINT через сообщение WM_COMMAND .
BN_PUSHED	Отправляется при нажатии состояния кнопки. Примечание. Этот код уведомления предоставляется только для совместимости с 16-разрядными версиями Windows до версии 3.0. Приложения должны использовать стиль кнопки BS_OWNERDRAW и структуру DRAWITEMSTRUCT для этой задачи. Родительское окно кнопки получает код уведомления BN_PUSHED через сообщение WM_COMMAND.
BN_SETFOCUS	Отправляется, когда кнопка получает фокус клавиатуры. Кнопка должна иметь стиль BS_NOTIFY для отправки этого кода уведомления. Родительское окно кнопки получает код уведомления BN_SETFOCUS через сообщение WM_COMMAND.
BN_UNHILITE	Отправляется, когда выделение должно быть удалено из кнопки. Примечание. Этот код уведомления предоставляется только для совместимости с 16-разрядными версиями Windows до версии 3.0. Приложения должны использовать стиль кнопки BS_OWNERDRAW и структуру DRAWITEMSTRUCT для этой задачи. Родительское окно кнопки получает код уведомления BN_UNHILITE через сообщение WM_COMMAND .
BN_UNPUSHED	Отправляется, когда для кнопки задано состояние принудительной отправки. Примечание. Этот код уведомления предоставляется только для совместимости с 16-разрядными версиями Windows до версии 3.0. Приложения должны использовать стиль кнопки BS_OWNERDRAW и структуру DRAWITEMSTRUCT для этой задачи. Родительское окно кнопки получает код уведомления BN_UNPUSHED через сообщение WM_COMMAND.
NM_CUSTOMDRAW (кнопка)	Уведомляет родительское окно элемента управления кнопкой о пользовательских операциях рисования на кнопке. Элемент управления кнопкой отправляет этот код уведомления в виде сообщения WM_NOTIFY.
WM_CTLCOLORBTN	Сообщение WM_CTLCOLORBTN отправляется в родительское окно кнопки перед рисованием кнопки. Родительское окно может изменить текст и цвет фона кнопки. Однако только кнопки, нарисованные владельцем, реагируют на родительское окно, обрабатывая это сообщение.

Структуры

Раздел	Содержимое
BUTTON_IMAGELIST	Содержит сведения о списке изображений, который используется с элементом управления кнопкой.
BUTTON_SPLITINFO	Содержит сведения, определяющие разделяющую кнопку (стили BS_SPLIТБ UTTON и BS_DEFSPLIТБ UTTON). Используется с сообщениями BCM_GETSPLITINFO и BCM_SETSPLITINFO.
N МБ CDROPDOWN	Содержит сведения о уведомлении BCN_DROPDOWN .
N МБ CHOTITEM	Содержит сведения о перемещении мыши над элементом управления кнопкой.

Константы

Раздел	Содержимое
Стили кнопок	Задает сочетание стилей кнопок. Если вы создаете кнопку с помощью класса BUTTON с функцией CreateWindow или CreateWindowEx, можно указать любой из стилей кнопок, перечисленных ниже.