Класс CMFCRibbonCheckBox

Замечание

Библиотека классов Microsoft Foundation (MFC) продолжает поддерживаться. Однако мы больше не добавляем функции или обновляем документацию.

Класс CMFCRibbonCheckBox реализует флажок, который можно добавить на панель ленты, панель быстрого доступа или во всплывающее меню.

Синтаксис

class CMFCRibbonCheckBox : public CMFCRibbonButton

Участники

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

Имя	Описание
CMFCRibbonCheckBox::CMFCRibbonCheckBox	Конструктор.

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

Имя	Описание
CMFCRibbonCheckBox::GetCompactSize	(Переопределения CMFCRibbonButton::GetCompactSize.)
CMFCRibbonCheckBox::GetIntermediateSize	(Переопределения CMFCRibbonButton::GetIntermediateSize.)
CMFCRibbonCheckBox::GetRegularSize	(Переопределения CMFCRibbonButton::GetRegularSize.)
CMFCRibbonCheckBox::IsDrawTooltipImage	(Переопределяет CMFCRibbonButton::IsDrawTooltipImage.)
CMFCRibbonCheckBox::OnDraw	(Переопределения CMFCRibbonButton::OnDraw.)
CMFCRibbonCheckBox::OnDrawMenuImage	(Переопределения CMFCRibbonBaseElement::OnDrawMenuImage.)
CMFCRibbonCheckBox::OnDrawOnList	(Переопределяет CMFCRibbonButton::OnDrawOnList.)
CMFCRibbonCheckBox::SetACCData	(Переопределения CMFCRibbonButton::SetACCData.)

Замечания

Чтобы использовать класс CMFCRibbonCheckBox в вашем приложении, добавьте в код следующий конструктор:

CMFCRibbonCheckBox (UINT nID, LPCTSTR lpszText)

где nID — это идентификатор команды флажка, а lpszText — это текстовая метка флажка.

Флажок можно добавить на панель ленты с помощью CMFCRibbonPanel::Add.

Иерархия наследования

CObject

CMFCRibbonBaseElement

CMFCRibbonButton

CMFCRibbonCheckBox

Требования

Заголовок: afxribboncheckbox.h

CMFCRibbonCheckBox::CMFCRibbonCheckBox

Конструктор объекта флажка ленты

CMFCRibbonCheckBox(
    UINT nID,
    LPCTSTR lpszText);

Параметры

nID
[in] Указывает идентификатор команды.

lpszText
[in] Задает текстовую метку.

Возвращаемое значение

Создает объект флажка ленты.

Пример

В следующем примере показано, как создать объект CMFCRibbonCheckBox класса.

strTemp.LoadString(IDS_RIBBON_STATUSBAR);
CMFCRibbonButton *pBtnStatusBar = new CMFCRibbonCheckBox(ID_VIEW_STATUS_BAR, strTemp);

CMFCRibbonCheckBox::GetCompactSize

При переопределении получает компактный размер флажка.

virtual CSize GetCompactSize(CDC* pDC);

Параметры

PDC
[in] Указатель на CDC, связанный с флажком.

Возвращаемое значение

Возвращает объект, содержащий компактный CSize размер флажка.

Замечания

Если этот флажок не переопределен, возвращает промежуточный размер флажка.

CMFCRibbonCheckBox::GetIntermediateSize

Возвращает промежуточный размер флажка.

virtual CSize GetIntermediateSize(CDC* pDC);

Параметры

PDC
[in] Указатель на CDC, связанный с этим флажком.

Возвращаемое значение

CSize Объект, содержащий промежуточный размер флажка.

Замечания

Если параметр не переопределен, вычисляет промежуточный размер как размер флажка по умолчанию (AFX_CHECK_BOX_DEFAULT_SIZE) плюс размер текста, а также поля.

CMFCRibbonCheckBox::GetRegularSize

Возвращает обычный размер флажка.

virtual CSize GetRegularSize(CDC* pDC);

Параметры

PDC
[in] Указатель на объект CDC, связанный с этим флажком.

Возвращаемое значение

CSize Возвращает объект, содержащий обычный размер флажка.

Замечания

Если этот флажок не переопределен, возвращает промежуточный размер флажка.

CMFCRibbonCheckBox::IsDrawTooltipImage

Указывает, существует ли изображение подсказки, связанное с флажкой.

virtual BOOL IsDrawTooltipImage() const;

Возвращаемое значение

Возвращает значение TRUE, если имеется подсказка, связанная с флажкой, или false, если нет.

Замечания

CMFCRibbonCheckBox::OnDraw

Вызывается платформой для рисования флажка с помощью указанного контекста устройства.

virtual void OnDraw(CDC* pDC);

Параметры

PDC
[in] Указатель на CDC, в котором установлен флажок.

Замечания

CMFCRibbonCheckBox::OnDrawMenuImage

Вызывается платформой для рисования изображения меню для флажка.

virtual BOOL OnDrawMenuImage(CDC*, CRect);

Параметры

[входной] CDC*
Указатель на CDC, связанный с флажком.

CRect
[in] Объект CRect , указывающий прямоугольник, в котором нарисовывается изображение меню.

Возвращаемое значение

Возвращает значение TRUE, если изображение было нарисовано или false, если нет.

Замечания

Если параметр не переопределен, возвращает значение FALSE.

CMFCRibbonCheckBox::OnDrawOnList

Вызывается платформой для рисования флажка в списке команд.

virtual void OnDrawOnList(
    CDC* pDC,
    CString strText,
    int nTextOffset,
    CRect rect,
    BOOL bIsSelected,
    BOOL bHighlighted);

Параметры

PDC
[in] Указатель на контекст устройства, в котором установлен флажок.

strText
[in] Отображаемый текст.

nTextOffset
[in] Расстояние в пикселях от левой части поля списка до отображаемого текста.

прямоугольник
[in] Прямоугольник отображения для флажка.

bIsSelected
[in] ЗНАЧЕНИЕ TRUE, если флажок установлен или false, если нет.

bHighlighted
[in] ЗНАЧЕНИЕ TRUE, если флажок выделен или false, если нет.

Замечания

CMFCRibbonCheckBox::SetACCData

Задает данные специальных возможностей для флажка.

virtual BOOL SetACCData(
    CWnd* pParent,
    CAccessibilityData& data);

Параметры

pParent
Родительское окно флажка.

данные
Данные специальных возможностей для флажка.

Возвращаемое значение

Всегда возвращает значение TRUE.

Замечания

По умолчанию этот метод задает данные специальных возможностей для флажка и всегда возвращает ЗНАЧЕНИЕ TRUE. Переопределите этот метод, чтобы задать данные специальных возможностей и возвращать значение, указывающее на успешное или неуспешное выполнение.

См. также

Диаграмма иерархии
Классы
Класс CMFCRibbonPanel