Класс CButton

Статья
02/20/2013

Предоставляет функциональность элемент управления "Кнопка" Windows.

class CButton : public CWnd

Члены

Открытые конструкторы

Имя	Описание
CButton::CButton	Создает объект CButton.

Открытые методы

Имя	Описание
CButton::Create	Создает элемент управления "Кнопка" Windows и вложение его к объекту CButton.
CButton::DrawItem	Переопределение для рисования определяемый пользователем объект CButton.
CButton::GetBitmap	Извлекает маркер растрового изображения ранее установленного с SetBitmap.
CButton::GetButtonStyle	Извлекает сведения о стиле элемента управления "Кнопка".
CButton::GetCheck	Извлекает состояние проверки элемента управления "Кнопка".
CButton::GetCursor	Извлекает маркер образа курсора ранее установленного с SetCursor.
CButton::GetIcon	Получает дескриптор значка ранее установленного с SetIcon.
CButton::GetIdealSize	Возвращает оптимальный размер элемента управления "Кнопка".
CButton::GetImageList	Извлекает список образа элемент управления "Кнопка".
CButton::GetNote	Получает компонент заметки текущего управления command link.
CButton::GetNoteLength	Извлекает длина текста заметки для текущего элемента управления command link.
CButton::GetSplitGlyph	Извлекает глиф, связанный с текущим элементом управления разворачивающейся кнопки.
CButton::GetSplitImageList	Извлекает список завершения образа для текущего элемента управления разворачивающейся кнопки.
CButton::GetSplitInfo	Получает сведения, указывающее текущий элемент управления разворачивающейся кнопки.
CButton::GetSplitSize	Получает ограничивающий прямоугольник компонента раскрывающегося списка для текущего элемента управления разворачивающейся кнопки.
CButton::GetSplitStyle	Получает стили разворачивающаяся кнопка, указывающие текущее управление разворачивающейся кнопки.
CButton::GetState	Извлекает состояние проверки, состояние выделения и состояние фокуса элемент управления "Кнопка".
CButton::GetTextMargin	Извлекает поля текст элемента управления "Кнопка".
CButton::SetBitmap	Задает растровое изображение, отображаемый на кнопке.
CButton::SetButtonStyle	Изменяет стиль кнопки.
CButton::SetCheck	Задает состояние проверки элемента управления "Кнопка".
CButton::SetCursor	Определяет способ курсора, отображаемый на кнопке.
CButton::SetDropDownState	Устанавливает состояние текущего управления раскрывающемся списке разворачивающейся кнопки.
CButton::SetIcon	Задает значок, отображаемый на кнопке.
CButton::SetImageList	Задает список образа элемент управления "Кнопка".
CButton::SetNote	Задает заметку на текущем элементе управления command link.
CButton::SetSplitGlyph	Связывает указанный глиф с текущим элементом управления разворачивающейся кнопки.
CButton::SetSplitImageList	Связывает список образа с текущим элементом управления разворачивающейся кнопки.
CButton::SetSplitInfo	Определяет сведения, указывающее текущий элемент управления разворачивающейся кнопки.
CButton::SetSplitSize	Задает прямоугольник компонента раскрывающегося списка для текущего элемента управления разворачивающейся кнопки.
CButton::SetSplitStyle	Задает стиль текущего управления разворачивающейся кнопки.
CButton::SetState	Устанавливает выделение состояние элемента управления "Кнопка".
CButton::SetTextMargin	Устанавливает поля текст элемента управления "Кнопка".

Заметки

Элемент управления "Кнопка" маленькое, прямоугольное дочернее окно, которое можно щелкнуть и.Кнопки можно использовать по отдельности или в группы и могут быть обозначены или появиться без текста.Кнопка обычно изменяет внешний вид, когда пользователь щелкает его.

Стандартные кнопки флажок, переключатель и кнопкой.Объект CButton может стать любой из них, в соответствии с стиль кнопки указанный в своей инициализации функцией-членом Создание.

Кроме того, класс CBitmapButton, унаследованный от создания CButton поддерживает элемент управления "Кнопка" обозначенных с образами растрового изображения, а не текста.CBitmapButton может иметь отдельные растровые изображения для кнопки вверх, вниз, с фокусом ввода и запрещенных состояний.

Можно создать элемент управления "Кнопка" или из шаблона диалогового окна или непосредственно в коде.В обоих случаях сначала вызвать конструктор CButton для создания объекта CButton; затем вызовите функцию-член Создать для создания элемента управления "Кнопка" Windows и вложить его к объекту CButton.

Конструкция может быть одношаговым процессом в классе, производном от CButton.Создание конструктора производного класса и вызовите Создать из конструктора.

Если нужно обрабатывать сообщения уведомлений Windows, отправленные элемент управления "Кнопка" с родительским элементом (обычно класс, производный от CDialog), то добавление функции-члена записи и обработчика сообщений сообщение- сопоставления в родительский класс для каждого сообщения.

Каждая запись сообщение-сопоставления принимает следующую форму:

Уведомление (idON_, memberFxn**)**

где id задает идентификатор дочернего окна элемента управления, отправляющее уведомление и memberFxn имя родительского функции-члена был написан для обработки уведомления.

Родительский прототип функции следующим образом:

afx_msgvoidmemberFxn**( );**

Потенциальных записей сообщение- сопоставления следующим образом:

Запись сопоставления	Отправленный к родительскому элементу, когда…
ON_BN_CLICKED	Пользователь нажимает кнопку.
ON_BN_DOUBLECLICKED	Пользователь дважды щелкает кнопку.

При создании объекта CButton из ресурса диалогового окна, то объект CButton автоматически уничтожается, когда пользователь закрывает диалоговое окно.

При создании объекта CButton в окне, можно удалить его.При создании объекта CButton в куче с помощью функции новый, необходимо вызвать метод удалить в объекте, чтобы удалить его, когда пользователь закрывает элемент управления "Кнопка" Windows.При создании объекта CButton в стеке или он внедрен в родительском объекте диалогового окна, он удален автоматически.