Класс CMFCRibbonEdit
Реализует элемент управления редактирования, расположенный на панели ленты.
Синтаксис
class CMFCRibbonEdit : public CMFCRibbonButton
Участники
Открытые конструкторы
| Имя | Описание |
|---|---|
| CMFCRibbonEdit::CMFCRibbonEdit | Формирует объект CMFCRibbonEdit. |
Открытые методы
| Имя | Описание |
|---|---|
| CMFCRibbonEdit::CanBeStretched | Указывает, может ли высота элемента управления увеличиваться вертикально до высоты CMFCRibbonEdit строки ленты. |
| CMFCRibbonEdit::CMFCRibbonEdit | Формирует объект CMFCRibbonEdit. |
| CMFCRibbonEdit::CopyFrom | Копирует состояние указанного CMFCRibbonEdit объекта в текущий CMFCRibbonEdit объект. |
| CMFCRibbonEdit::CreateEdit | Создает новое текстовое поле для CMFCRibbonEdit объекта. |
| CMFCRibbonEdit::D efcCtrl | Уничтожает CMFCRibbonEdit объект. |
| CMFCRibbonEdit::D ropDownList | Раскрывающийся список. |
| CMFCRibbonEdit::EnableSpinButtons | Включает и задает диапазон кнопки спина для текстового поля. |
| CMFCRibbonEdit::GetCompactSize | Извлекает компактный CFMCRibbonEdit размер объекта. |
| CMFCRibbonEdit::GetEditText | Извлекает текст в текстовом поле. |
| CMFCRibbonEdit::GetIntermediateSize | Извлекает промежуточный CMFCRibbonEdit размер объекта. |
| CMFCRibbonEdit::GetTextAlign | Извлекает выравнивание текста в текстовом поле. |
| CMFCRibbonEdit::GetWidth | Извлекает ширину элемента управления в пикселях CMFCRibbonEdit . |
| CMFCRibbonEdit::HasCompactMode | Указывает, может ли размер дисплея элемента CMFCRibbonEdit управления быть компактным. |
| CMFCRibbonEdit::HasFocus | Указывает, имеет ли CMFCRIbbonEdit элемент управления фокус. |
| CMFCRibbonEdit::HasLargeMode | Указывает, может ли размер дисплея элемента CMFCRibbonEdit управления быть большим. |
| CMFCRibbonEdit::HasSpinButtons | Указывает, имеет ли текстовое поле кнопку спина. |
| CMFCRibbonEdit::IsHighlighted | Указывает, выделен ли CMFCRibbonEdit элемент управления. |
| CMFCRibbonEdit::OnAfterChangeRect | Вызывается платформой, когда измерения прямоугольника отображения для CMFCRibbonEdit элемента управления изменяются. |
| CMFCRibbonEdit::OnDraw | Вызывается платформой для рисования CMFCRibbonEdit элемента управления. |
| CMFCRibbonEdit::OnDrawLabelAndImage | Вызывается платформой для рисования метки и изображения элемента CMFCRibbonEdit управления. |
| CMFCRibbonEdit::OnDrawOnList | Вызывается платформой для рисования CMFCRibbonEdit элемента управления в поле списка команд. |
| CMFCRibbonEdit::OnEnable | Вызывается платформой для включения или отключения CMFCRibbonEdit элемента управления. |
| CMFCRibbonEdit::OnHighlight | Вызывается платформой, когда указатель вводит или покидает границы CMFCRibbonEdit элемента управления. |
| CMFCRibbonEdit::OnKey | Вызывается платформой, когда пользователь нажимает подсказку CMFCRibbonEdit и элемент управления имеет фокус. |
| CMFCRibbonEdit::OnLButtonDown | Вызывается платформой для обновления CMFCRibbonEdit элемента управления, когда пользователь нажимает левую кнопку мыши на элементе управления. |
| CMFCRibbonEdit::OnLButtonUp | Вызывается платформой, когда пользователь освобождает левую кнопку мыши. |
| CMFCRibbonEdit::OnRTLChanged | Вызывается платформой для обновления CMFCRibbonEdit элемента управления при изменении направления макета. |
| CMFCRibbonEdit::OnShow | Вызывается платформой для отображения или скрытия CMFCRibbonEdit элемента управления. |
| CMFCRibbonEdit::Redraw | Обновляет отображение CMFCRibbonEdit элемента управления. |
| CMFCRibbonEdit::SetACCData | Задает данные специальных возможностей CMFCRibbonEdit для объекта. |
| CMFCRibbonEdit::SetEditText | Задает текст в текстовом поле. |
| CMFCRibbonEdit::SetTextAlign | Задает выравнивание текста текстового поля. |
| CMFCRibbonEdit::SetWidth | Задает ширину текстового поля для CMFCRibbonEdit элемента управления. |
Замечания
Пример
В следующем примере показано, как создать CMFCRibbonEdit объект, отобразить кнопки спины рядом с элементом управления редактированием и задать текст элемента управления редактирования. Этот фрагмент кода является частью примера демонстрации MS Office 2007.
CMFCRibbonEdit *pEditIndentLeft = new CMFCRibbonEdit(ID_PAGELAYOUT_INDENT_LEFT, 72, _T("Left:\nil"), 13);
// specify the min and max value of the spin button control
pEditIndentLeft->EnableSpinButtons(0, 1000);
// set the text of the edit control
pEditIndentLeft->SetEditText(_T("0"));
Требования
Заголовок: afxRibbonEdit.h
CMFCRibbonEdit::CanBeStretched
Указывает, может ли высота элемента управления CMFCRibbonEdit увеличиваться вертикально до высоты строки ленты.
virtual BOOL CanBeStretched();
Возвращаемое значение
Всегда возвращает значение FALSE.
Замечания
CMFCRibbonEdit::CMFCRibbonEdit
Создает объект CMFCRibbonEdit.
CMFCRibbonEdit(
UINT nID,
int nWidth,
LPCTSTR lpszLabel = NULL,
int nImage = -1);
CMFCRibbonEdit();
Параметры
nID
[in] Идентификатор команды для CMFCRibbonEdit элемента управления.
nWidth
[in] Ширина в пикселях текстового CMFCRibbonEdit поля элемента управления.
lpszLabel
[in] Метка элемента CMFCRibbonEdit управления.
nImage
[in] Индекс небольшого изображения, используемого CMFCRibbonEdit для элемента управления. Коллекция небольших изображений поддерживается родительской категорией ленты.
Замечания
Элемент CMFCRibbonEdit управления не использует большое изображение.
CMFCRibbonEdit::CopyFrom
Копирует состояние указанного объекта CMFCRibbonEdit в текущий объект CMFCRibbonEdit .
virtual void CopyFrom(const CMFCRibbonBaseElement& src);
Параметры
src
[in] Исходный CMFCRibbonEdit объект.
Замечания
Параметр src должен иметь тип CMFCRibbonEdit.
CMFCRibbonEdit::CreateEdit
Создает новое текстовое поле для объекта CMFCRibbonEdit .
virtual CMFCRibbonRichEditCtrl* CreateEdit(
CWnd* pWndParent,
DWORD dwEditStyle);
Параметры
pWndParent
[in] Указатель на родительское окно CMFCRibbonEdit объекта.
dwEditStyle
[in] Задает стиль текстового поля. Стили окон, перечисленные в разделе "Примечания", можно объединить с стилями элементов управления редактирования, описанными в пакете SDK для Windows.
Возвращаемое значение
Указатель на новое текстовое поле, если метод выполнен успешно; в противном случае значение NULL.
Замечания
Переопределите этот метод в производном классе, чтобы создать настраиваемое текстовое поле.
К текстовому поле можно применить следующие стили окон:
WS_CHILD
WS_VISIBLE
WS_DISABLED
WS_GROUP
WS_TABSTOP
CMFCRibbonEdit::D efcCtrl
Уничтожает объект CMFCRibbonEdit .
virtual void DestroyCtrl();
Замечания
CMFCRibbonEdit::D ropDownList
Раскрывающийся список.
virtual void DropDownList();
Замечания
По умолчанию этот метод ничего не делает. Переопределите этот метод для раскрывающегося списка.
CMFCRibbonEdit::EnableSpinButtons
Включает и задает диапазон кнопки спина для текстового поля.
void EnableSpinButtons(
int nMin,
int nMax);
Параметры
nMin
[in] Минимальное значение кнопки спина.
nMax
[in] Максимальное значение кнопки спина.
Замечания
Кнопки спина отображают стрелку вверх и вниз и позволяют пользователям перемещаться по фиксированному набору значений.
CMFCRibbonEdit::GetCompactSize
Извлекает компактный размер объекта CMFCRibbonEdit .
virtual CSize GetCompactSize(CDC* pDC);
Параметры
pDC
[in] Указатель на контекст устройства для CMFCRibbonEdit объекта.
Возвращаемое значение
Компактный CMFCRibbonEdit размер объекта.
Замечания
CMFCRibbonEdit::GetEditText
Извлекает текст в текстовом поле.
CString GetEditText() const;
Возвращаемое значение
Текст в текстовом поле.
Замечания
CMFCRibbonEdit::GetIntermediateSize
Извлекает промежуточный размер объекта CMFCRibbonEdit .
virtual CSize GetIntermediateSize(CDC* pDC);
Параметры
pDC
[in] Указатель на контекст устройства для CMFCRibbonEdit объекта.
Возвращаемое значение
Промежуточный CMFCRibbonEdit размер объекта.
Замечания
CMFCRibbonEdit::GetTextAlign
Извлекает выравнивание текста в текстовом поле.
int GetTextAlign() const;
Возвращаемое значение
Перечисленное значение выравнивания текста. Сведения о возможных значениях см. в разделе "Примечания".
Замечания
Возвращаемое значение является одним из следующих стилей элементов управления правки:
ES_LEFT для выравнивания по левому краю
ES_CENTER для выравнивания центра
ES_RIGHT для выравнивания по правому краю
Дополнительные сведения об этих стилях см. в разделе "Изменить стили элементов управления".
CMFCRibbonEdit::GetWidth
Извлекает ширину в пикселях элемента управления CMFCRibbonEdit .
int GetWidth(BOOL bInFloatyMode = FALSE) const;
Параметры
bInFloatyMode
[in] ЗНАЧЕНИЕ TRUE, если CMFCRibbonEdit элемент управления находится в плавающем режиме; в противном случае — ЗНАЧЕНИЕ FALSE.
Возвращаемое значение
Ширина элемента управления в пикселях CMFCRibbonEdit .
Замечания
CMFCRibbonEdit::HasCompactMode
Указывает, может ли отображаться размер элемента управления CMFCRibbonEdit .
virtual BOOL HasCompactMode() const;
Возвращаемое значение
Всегда возвращает значение TRUE.
Замечания
По умолчанию этот метод всегда возвращает ЗНАЧЕНИЕ TRUE. Переопределите этот метод, чтобы указать, может ли размер дисплея быть компактным.
CMFCRibbonEdit::HasFocus
Указывает, имеет ли элемент управления CMFCRibbonEdit фокус.
virtual BOOL HasFocus() const;
Возвращаемое значение
ЗНАЧЕНИЕ TRUE, если элемент CMFCRibbonEdit управления имеет фокус; в противном случае — ЗНАЧЕНИЕ FALSE.
Замечания
CMFCRibbonEdit::HasLargeMode
Указывает, может ли размер дисплея элемента управления CMFCRibbonEdit быть большим.
virtual BOOL HasLargeMode() const;
Возвращаемое значение
Всегда возвращает значение FALSE.
Замечания
По умолчанию этот метод всегда возвращает ЗНАЧЕНИЕ FALSE. Переопределите этот метод, чтобы указать, может ли размер дисплея быть большим.
CMFCRibbonEdit::HasSpinButtons
Указывает, имеет ли текстовое поле кнопку спина.
virtual BOOL HasSpinButtons() const;
Возвращаемое значение
TRUE, если текстовое поле имеет кнопку спины; в противном случае ЗНАЧЕНИЕ FALSE.
Замечания
CMFCRibbonEdit::IsHighlighted
Указывает, выделен ли элемент управления CMFCRibbonEdit .
virtual BOOL IsHighlighted() const;
Возвращаемое значение
ЗНАЧЕНИЕ TRUE, если CMFCRibbonEdit элемент управления выделен; в противном случае — ЗНАЧЕНИЕ FALSE.
Замечания
CMFCRibbonEdit::OnAfterChangeRect
Вызывается платформой, когда измерения прямоугольника отображения для элемента управления CMFCRibbonEdit изменяются.
virtual void OnAfterChangeRect(CDC* pDC);
Параметры
pDC
[in] Указатель на контекст устройства для CMFCRibbonEdit элемента управления.
Замечания
CMFCRibbonEdit::OnDraw
Вызывается платформой для рисования элемента управления CMFCRibbonEdit .
virtual void OnDraw(CDC* pDC);
Параметры
pDC
[in] Указатель на контекст устройства для CMFCRibbonEdit элемента управления.
Замечания
CMFCRibbonEdit::OnDrawLabelAndImage
Вызывается платформой для рисования метки и изображения для элемента управления CMFCRibbonEdit .
virtual void OnDrawLabelAndImage(CDC* pDC);
Параметры
pDC
[in] Указатель на контекст устройства для CMFCRibbonEdit элемента управления.
Замечания
CMFCRibbonEdit::OnDrawOnList
Вызывается платформой для рисования элемента управления CMFCRibbonEdit в поле списка команд.
virtual void OnDrawOnList(
CDC* pDC,
CString strText,
int nTextOffset,
CRect rect,
BOOL bIsSelected,
BOOL bHighlighted);
Параметры
pDC
[in] Указатель на контекст устройства для CMFCRibbonEdit элемента управления.
strText
[in] Отображаемый текст.
nTextOffset
[in] Расстояние в пикселях от левой части поля списка до отображаемого текста.
rect
[in] Прямоугольник отображения для CMFCRibbonEdit элемента управления.
bIsSelected
[in] Этот параметр не используется.
bHighlighted
[in] Этот параметр не используется.
Замечания
В списке команд отображаются элементы управления лентой, позволяющие пользователям настраивать панель быстрого доступа.
CMFCRibbonEdit::OnEnable
Вызывается платформой для включения или отключения элемента управления CMFCRibbonEdit .
virtual void OnEnable(BOOL bEnable);
Параметры
bEnable
[in] ЗНАЧЕНИЕ TRUE для включения элемента управления; ЗНАЧЕНИЕ FALSE, чтобы отключить элемент управления.
Замечания
CMFCRibbonEdit::OnHighlight
Вызывается платформой, когда указатель вводит или покидает границы элемента управления CMFCRibbonEdit .
virtual void OnHighlight(BOOL bHighlight);
Параметры
bHighlight
[in] ЗНАЧЕНИЕ TRUE, если указатель находится в границах CMFCRibbonEdit элемента управления; в противном случае — ЗНАЧЕНИЕ FALSE.
Замечания
CMFCRibbonEdit::OnKey
Вызывается платформой, когда пользователь нажимает подсказку клавиши, а элемент управления CMFCRibbonEdit имеет фокус.
virtual BOOL OnKey(BOOL bIsMenuKey);
Параметры
bIsMenuKey
[in] ЗНАЧЕНИЕ TRUE, если подсказка ключа отображает всплывающее меню; в противном случае — ЗНАЧЕНИЕ FALSE.
Возвращаемое значение
ЗНАЧЕНИЕ TRUE, если событие было обработано; в противном случае — ЗНАЧЕНИЕ FALSE.
Замечания
CMFCRibbonEdit::OnLButtonDown
Вызывается платформой для обновления элемента управления CMFCRibbonEdit , когда пользователь нажимает левую кнопку мыши на элементе управления.
virtual void OnLButtonDown(CPoint point);
Параметры
point
[in] Этот параметр не используется.
Замечания
CMFCRibbonEdit::OnLButtonUp
Вызывается платформой, когда пользователь освобождает левую кнопку мыши.
virtual void OnLButtonUp(CPoint point);
Параметры
point
[in] Этот параметр не используется.
Замечания
CMFCRibbonEdit::OnRTLChanged
Вызывается платформой для обновления элемента управления CMFCRibbonEdit при изменении направления макета.
virtual void OnRTLChanged(BOOL bIsRTL);
Параметры
bIsRTL
[in] ЗНАЧЕНИЕ TRUE, если макет находится справа налево; Значение FALSE, если макет находится слева направо.
Замечания
CMFCRibbonEdit::OnShow
Вызывается платформой для отображения или скрытия элемента управления CMFCRibbonEdit .
virtual void OnShow(BOOL bShow);
Параметры
bShow
[in] Значение TRUE для отображения элемента управления; Значение FALSE для скрытия элемента управления.
Замечания
CMFCRibbonEdit::Redraw
Обновляет отображение элемента управления CMFCRibbonEdit .
virtual void Redraw();
Замечания
Этот метод перерисовывает прямоугольник отображения для CMFCRibbonEdit объекта путем косвенного вызова CWnd::RedrawWindow с набором флагов RDW_INVALIDATE, RDW_ERASE и RDW_UPDATENOW флагов.
CMFCRibbonEdit::SetACCData
Задает данные специальных возможностей для объекта CMFCRibbonEdit .
virtual BOOL SetACCData(
CWnd* pParent,
CAccessibilityData& data);
Параметры
pParent
Указатель на родительское окно объекта CMFCRibbonEdit .
data
Данные специальных возможностей CMFCRibbonEdit для объекта.
Возвращаемое значение
Всегда возвращает значение TRUE.
Замечания
CMFCRibbonEdit::SetEditText
Задает текст в текстовом поле.
void SetEditText(CString strText);
Параметры
strText
[in] Текст текстового поля.
CMFCRibbonEdit::SetTextAlign
Задает выравнивание текста текстового поля.
void SetTextAlign(int nAlign);
Параметры
nAlign
[in] Перечисленное значение выравнивания текста. Сведения о возможных значениях см. в разделе "Примечания".
Замечания
Параметр nAlign является одним из следующих стилей элементов управления правки:
ES_LEFT для выравнивания по левому краю
ES_CENTER для выравнивания центра
ES_RIGHT для выравнивания по правому краю
Дополнительные сведения об этих стилях см. в разделе "Изменить стили элементов управления".
CMFCRibbonEdit::SetWidth
Задает ширину текстового поля для элемента управления CMFCRibbonEdit .
void SetWidth(
int nWidth,
BOOL bInFloatyMode = FALSE);
Параметры
nWidth
[in] Ширина в пикселях текстового поля.
bInFloatyMode
ЗНАЧЕНИЕ TRUE, чтобы задать ширину для режима с плавающей запятой; Значение FALSE, чтобы задать ширину для регулярного режима.
Замечания
Элемент CMFCRibbonEdit управления имеет две ширины в зависимости от режима отображения: режим с плавающей запятой и обычный режим.
См. также
Диаграмма иерархии
Классы
Класс CMFCRibbonButton
Класс CMFCRibbonBar