Класс CMFCRibbonCheckBox
Класс 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.
Иерархия наследования
Требования
Заголовок: 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] Расстояние в пикселях от левой части поля списка до отображаемого текста.
rect
[in] Прямоугольник отображения для флажка.
bIsSelected
[in] ЗНАЧЕНИЕ TRUE, если флажок установлен или false, если нет.
bHighlighted
[in] ЗНАЧЕНИЕ TRUE, если флажок выделен или false, если нет.
Замечания
CMFCRibbonCheckBox::SetACCData
Задает данные специальных возможностей для флажка.
virtual BOOL SetACCData(
CWnd* pParent,
CAccessibilityData& data);
Параметры
pParent
Родительское окно флажка.
data
Данные специальных возможностей для флажка.
Возвращаемое значение
Всегда возвращает значение TRUE.
Замечания
По умолчанию этот метод задает данные специальных возможностей для флажка и всегда возвращает ЗНАЧЕНИЕ TRUE. Переопределите этот метод, чтобы задать данные специальных возможностей и возвращать значение, указывающее на успешное или неуспешное выполнение.