Класс CMFCToolBarComboBoxButton
Кнопка панели инструментов, содержащая элемент управления со списком ( класс CComboBox).
Синтаксис
class CMFCToolBarComboBoxButton : public CMFCToolBarButton
Участники
Открытые конструкторы
| Имя | Описание |
|---|---|
| CMFCToolBarComboBoxButton::CMFCToolBarComboBoxButton | Создает документ CMFCToolBarComboBoxButton. |
Открытые методы
| Имя | Описание |
|---|---|
| CMFCToolBarComboBoxButton::AddItem | Добавляет элемент в конец списка со списком со списком. |
| CMFCToolBarComboBoxButton::AddSortedItem | Добавляет элемент в список списков со списком. Порядок элементов в списке определяется Compare. |
| CMFCToolBarComboBoxButton::Compare | Сравнивает два элемента. Вызывается для сортировки элементов, добавляющих AddSortedItems в список полей со списком. |
| CMFCToolBarComboBoxButton::CreateEdit | Создает новый элемент управления редактирования для кнопки со списком. |
| CMFCToolBarComboBoxButton::D eleteItem | Удаляет элемент из списка со списком со списком. |
| CMFCToolBarComboBoxButton::FindItem | Возвращает индекс элемента, содержащего указанную строку. |
| CMFCToolBarComboBoxButton::GetByCmd | Возвращает указатель на кнопку со списком с указанным идентификатором команды. |
| CMFCToolBarComboBoxButton::GetComboBox | Возвращает указатель на элемент управления со списком, внедренный в кнопку со списком. |
| CMFCToolBarComboBoxButton::GetCount | Возвращает количество элементов в списке со списком со списком. |
| CMFCToolBarComboBoxButton::GetCountAll | Находит кнопку со списком с указанным идентификатором команды. Возвращает количество элементов в списке со списком этой кнопки. |
| CMFCToolBarComboBoxButton::GetCurSel | Возвращает индекс выбранного элемента в списке со списком со списком. |
| CMFCToolBarComboBoxButton::GetCurSelAll | Находит кнопку со списком с указанным идентификатором команды и возвращает индекс выбранного элемента в списке со списком этой кнопки. |
| CMFCToolBarComboBoxButton::GetEditCtrl | Возвращает указатель на элемент управления редактирования, внедренный в кнопку со списком. |
| CMFCToolBarComboBoxButton::GetItem | Возвращает строку, связанную с указанным индексом в списке со списком со списком. |
| CMFCToolBarComboBoxButton::GetItemAll | Находит кнопку со списком, которая содержит указанный идентификатор команды, и возвращает строку, связанную с индексом в списке со списком полей со списком этой кнопки. |
| CMFCToolBarComboBoxButton::GetItemData | Возвращает 32-разрядное значение, связанное с указанным индексом в списке со списком со списком. |
| CMFCToolBarComboBoxButton::GetItemDataAll | Находит кнопку со списком с указанным идентификатором команды и возвращает 32-разрядное значение, связанное с индексом в списке со списком со списком этой кнопки. |
| CMFCToolBarComboBoxButton::GetItemDataPtrAll | Находит кнопку со списком с указанным идентификатором команды. Извлекает 32-разрядное значение, связанное с индексом в списке со списком этой кнопки, и возвращает 32-разрядное значение в виде указателя. |
| CMFCToolBarComboBoxButton::GetText | Возвращает текст из элемента управления редактирования поля со списком. |
| CMFCToolBarComboBoxButton::GetTextAll | Находит кнопку со списком с указанным идентификатором команды и возвращает текст из элемента управления редактирования этой кнопки. |
| CMFCToolBarComboBoxButton::IsCenterVert | Определяет, являются ли кнопки со списком в приложении по центру или выровнены с верхней частью панели инструментов. |
| CMFCToolBarComboBoxButton::IsFlatMode | Определяет, имеют ли кнопки со списком в приложении неструктурированный внешний вид. |
| CMFCToolBarComboBoxButton::RemoveAllItems | Удаляет все элементы из списка и редактирует элемент управления со списком. |
| CMFCToolBarComboBoxButton::SelectItem | Выбирает элемент в поле со списком в соответствии с индексом, 32-разрядным значением или строкой и уведомляет элемент управления со списком о выборе. |
| CMFCToolBarComboBoxButton::SelectItemAll | Находит кнопку со списком с указанным идентификатором команды. Вызывает SelectItem выбор элемента в поле со списком этой кнопки в соответствии со строкой, индексом или 32-разрядным значением. |
| CMFCToolBarComboBoxButton::SetCenterVert | Указывает, расположены ли кнопки со списком в приложении по вертикали или выровнены поверх панели инструментов. |
| CMFCToolBarComboBoxButton::SetDropDownHeight | Задает высоту раскрывающегося списка. |
| CMFCToolBarComboBoxButton::SetFlatMode | Указывает, имеют ли кнопки со списком в приложении неструктурированный внешний вид. |
Замечания
Чтобы добавить кнопку со списком на панель инструментов, выполните следующие действия:
Зарезервировать фиктивный идентификатор ресурса для кнопки в родительском ресурсе панели инструментов.
CMFCToolBarComboBoxButtonСоздание объекта.В обработчике сообщений, обрабатывающего сообщение AFX_WM_RESETTOOLBAR, замените фиктивную кнопку новой кнопкой со списком с помощью CMFCToolBar::ReplaceButton.
Дополнительные сведения см. в пошаговом руководстве. Размещение элементов управления на панелях инструментов. Пример кнопки панели инструментов со списком см. в примере проекта VisualStudioDemo.
Пример
В приведенном ниже примере демонстрируется использование различных методов класса CMFCToolBarComboBoxButton . В примере показано, как включить поля редактирования и со списком, задать вертикальную позицию кнопок со списком в приложении, задать высоту поля списка при его удалении, задать внешний вид кнопок со списком в приложении и задать текст в поле редактирования кнопки со списком. Этот фрагмент кода является частью примера демонстрации Visual Studio.
// CObList listButtons
// POSITION posCombo
CMFCToolBarComboBoxButton* pCombo = DYNAMIC_DOWNCAST(CMFCToolBarComboBoxButton, listButtons.GetNext(posCombo));
pCombo->EnableWindow(true);
pCombo->SetCenterVert();
pCombo->SetDropDownHeight(25);
pCombo->SetFlatMode();
pCombo->SetText(_T("this is a combo box"));
Иерархия наследования
Требования
Заголовок: afxtoolbarcomboboxbutton.h
CMFCToolBarComboBoxButton::AddItem
Добавляет уникальный элемент в поле списка.
virtual INT_PTR AddItem(
LPCTSTR lpszItem,
DWORD_PTR dwData=0);
Параметры
lpszItem
[in] Текст элемента, добавляемого в поле списка.
dwData
[in] Данные, связанные с элементом, добавляемыми в поле списка.
Возвращаемое значение
Индекс последнего элемента в поле списка.
Замечания
Не используйте этот метод при сортировке стиля списка.
Если текст элемента уже находится в списке, новые данные хранятся с существующим элементом. Поиск элемента учитывает регистр.
CMFCToolBarComboBoxButton::AddSortedItem
Добавляет элемент в поле списка в порядке, определенном методом Compare .
virtual INT_PTR AddSortedItem(
LPCTSTR lpszItem,
DWORD_PTR dwData=0);
Параметры
lpszItem
[in] Текст элемента, добавляемого в поле списка.
dwData
[in] Данные, связанные с элементом, добавляемыми в поле списка.
Возвращаемое значение
Индекс элемента, добавленного в поле списка.
Замечания
Используйте эту функцию для добавления элементов в поле списка в определенном порядке.
CMFCToolBarComboBoxButton::CanBeStretched
Указывает, может ли измениться размер кнопки со списком.
virtual BOOL CanBeStretched() const;
Возвращаемое значение
Возвращает ЗНАЧЕНИЕ TRUE.
CMFCToolBarComboBoxButton::CMFCToolBarComboBoxButton
Создает объект CMFCToolBarComboBoxButton.
CMFCToolBarComboBoxButton(
UINT uiID,
int iImage,
DWORD dwStyle=CBS_DROPDOWNLIST,
int iWidth=0);
Параметры
uiID
[in] Идентификатор команды новой кнопки.
iImage
[in] Индекс изображения, связанного с новой кнопкой.
dwStyle
[in] Стиль новой кнопки.
iWidth
[in] Ширина в пикселях новой кнопки.
Замечания
Ширина по умолчанию составляет 150 пикселей.
Список стилей кнопки панели инструментов см. в разделе "Стили элементов управления ToolBar"
CMFCToolBarComboBoxButton::ClearData
Удаляет определяемые пользователем данные.
virtual void ClearData();
Замечания
По умолчанию этот метод ничего не делает. Переопределите этот метод в производном классе, если требуется удалить все пользовательские данные.
CMFCToolBarComboBoxButton::Compare
Сравнивает две строки.
virtual int Compare(
LPCTSTR lpszItem1,
LPCTSTR lpszItem2);
Параметры
lpszItem1
[in] Первая строка для сравнения.
lpszItem2
[in] Вторая строка для сравнения.
Возвращаемое значение
Значение, указывающее лексикографическую связь с учетом регистра между строками. В следующем списке указаны возможные значения.
| значение | Description |
|---|---|
| <0 | Первая строка меньше второй. |
| 0 | Первая строка равна второй. |
| >0 | Первая строка больше второй. |
Замечания
Переопределите этот метод, чтобы изменить порядок сортировки элементов в поле списка.
Сравнение учитывает регистр.
Этот метод вызывается только из метода AddSortedItem .
CMFCToolBarComboBoxButton::CopyFrom
Копирует состояние указанного CMFCToolBarComboBoxButton объекта в текущий объект.
virtual void CopyFrom(const CMFCToolBarButton& src);
Параметры
src
[in] Исходный CMFCToolBarComboBoxButton объект.
CMFCToolBarComboBoxButton::CreateCombo
Создает поле со списком для кнопки со списком.
virtual CComboBox* CreateCombo(
CWnd* pWndParent,
const CRect& rect);
Параметры
pWndParent
[in] Указатель на родительское окно кнопки.
rect
[in] Ограничивающий прямоугольник поля со списком.
Возвращаемое значение
Указатель на новое поле со списком, если метод выполнен успешно; в противном случае значение NULL.
CMFCToolBarComboBoxButton::CreateEdit
Создает новое поле редактирования для кнопки со списком.
virtual CMFCToolBarComboBoxEdit* CreateEdit(
CWnd* pWndParent,
const CRect& rect,
DWORD dwEditStyle);
Параметры
pWndParent
[in] Указатель на родительское окно кнопки.
rect
[in] Ограничивающий прямоугольник нового поля редактирования.
dwEditStyle
[in] Стиль управления новым полем редактирования.
Возвращаемое значение
Указатель на новое поле редактирования, если метод выполнен успешно; в противном случае значение NULL.
Замечания
Платформа вызывает этот метод при создании нового поля редактирования для кнопки со списком. Переопределите этот метод, чтобы изменить способ создания CMFCToolBarComboBoxEdit .
CMFCToolBarComboBoxButton::D eleteItem
Удаляет указанный элемент из списка.
BOOL DeleteItem(int iIndex);
BOOL DeleteItem(DWORD_PTR dwData);
BOOL DeleteItem(LPCTSTR lpszText);
Параметры
iIndex
[in] Отсчитываемый от нуля индекс элемента.
dwData
[in] Данные, связанные с элементом, которые необходимо удалить.
lpszText
[in] Текст элемента, который нужно удалить. При наличии нескольких элементов с одинаковым текстом первый элемент удаляется.
Возвращаемое значение
ЗНАЧЕНИЕ TRUE, если элемент был расположен и успешно удален; в противном случае — ЗНАЧЕНИЕ FALSE.
Замечания
CMFCToolBarComboBoxButton::D uplicateData
Дублирует пользовательские данные.
virtual void DuplicateData();
Замечания
По умолчанию этот метод ничего не делает. Переопределите этот метод в производном классе, если требуется скопировать пользовательские данные.
CMFCToolBarComboBoxButton::EnableWindow
Включает или отключает поля редактирования и со списком.
virtual void EnableWindow(BOOL bEnable = TRUE);
Параметры
bEnable
[in] ЗНАЧЕНИЕ TRUE для включения полей редактирования и со списком; ЗНАЧЕНИЕ FALSE, чтобы отключить поля редактирования и со списком.
Замечания
При отключении элементы управления не могут быть активными и не могут принимать входные данные пользователя.
CMFCToolBarComboBoxButton::ExportToMenuButton
Копирует строку из таблицы строк приложения в указанное меню с помощью идентификатора команды кнопки со списком.
virtual BOOL ExportToMenuButton(CMFCToolBarMenuButton& menuButton) const;
Параметры
menuButton
[out] Ссылка на кнопку меню.
Возвращаемое значение
Всегда TRUE.
CMFCToolBarComboBoxButton::FindItem
Возвращает индекс первого элемента в поле списка, содержащего указанную строку.
int FindItem(LPCTSTR lpszText) const;
Параметры
lpszText
[in] Текст, для которого нужно выполнить поиск в поле списка.
Возвращаемое значение
Индекс элемента; или CB_ERR, если элемент не найден.
Замечания
CMFCToolBarComboBoxButton::GetByCmd
Возвращает указатель на кнопку со списком с указанным идентификатором команды.
static CMFCToolBarComboBoxButton* GetByCmd(
UINT uiCmd,
BOOL bIsFocus=FALSE);
Параметры
uiCmd
[in] Идентификатор команды кнопки со списком.
bIsFocus
[in] TRUE для поиска только ориентированных кнопок; ЗНАЧЕНИЕ FALSE для поиска всех кнопок.
Возвращаемое значение
Указатель на кнопку со списком; или NULL, если кнопка не найдена.
Замечания
CMFCToolBarComboBoxButton::GetComboBox
Возвращает указатель на поле со списком в кнопке со списком.
CComboBox* GetComboBox() const;
Возвращаемое значение
Указатель на объект класса CComboBox, если метод выполнен успешно; в противном случае — ЗНАЧЕНИЕ NULL.
Замечания
CMFCToolBarComboBoxButton::GetContextMenuID
Возвращает идентификатор ресурса контекстного меню для кнопки со списком.
UINT GetContextMenuID();
Возвращаемое значение
Идентификатор ресурса контекстного меню.
CMFCToolBarComboBoxButton::GetCount
Возвращает количество элементов в поле списка.
INT_PTR GetCount() const;
Возвращаемое значение
Количество элементов в списке.
Замечания
CMFCToolBarComboBoxButton::GetCountAll
Возвращает количество элементов в списке кнопки со списком с указанным идентификатором команды.
static int GetCountAll(UINT uiCmd);
Параметры
uiCmd
[in] Идентификатор команды кнопки со списком.
Возвращаемое значение
Количество элементов в списке; в противном случае CB_ERR, если кнопка со списком не найдена.
Замечания
CMFCToolBarComboBoxButton::GetCurSel
Возвращает индекс выбранного элемента в списке.
int GetCurSel() const;
Возвращаемое значение
Индекс выбранного элемента в списке; или CB_ERR, если элемент не выбран.
Замечания
Индекс списка является отсчитывается от нуля.
CMFCToolBarComboBoxButton::GetCurSelAll
Возвращает индекс выбранного элемента в поле списка кнопки со списком с указанным идентификатором команды.
static int GetCurSelAll(UINT uiCmd);
Параметры
uiCmd
[in] Идентификатор команды кнопки со списком.
Возвращаемое значение
Индекс выбранного элемента в списке; в противном случае CB_ERR, если элемент не выбран или кнопка со списком не найдена.
Замечания
Индекс списка является отсчитывается от нуля.
CMFCToolBarComboBoxButton::GetEditCtrl
Возвращает указатель на поле редактирования в кнопке со списком.
virtual CEdit* GetEditCtrl();
Возвращаемое значение
Указатель на поле редактирования, если метод выполнен успешно; в противном случае значение NULL.
Замечания
CMFCToolBarComboBoxButton::GetHwnd
Возвращает дескриптор окна для поля со списком.
virtual HWND GetHwnd();
Возвращаемое значение
Дескриптор окна или NULL, если поле со списком не связано с объектом окна.
CMFCToolBarComboBoxButton::GetItem
Возвращает строку, связанную с элементом по указанному индексу в поле списка.
LPCTSTR GetItem(int iIndex=-1) const;
Параметры
iIndex
[in] Отсчитываемый от нуля индекс элемента в поле списка.
Возвращаемое значение
Указатель на строку, связанную с элементом; в противном случае значение NULL, если параметр индекса недопустим, или если параметр индекса равен -1, и в поле со списком отсутствует выбранный элемент.
Замечания
Параметр индекса -1 возвращает строку выбранного элемента.
CMFCToolBarComboBoxButton::GetItemAll
Возвращает строку, связанную с элементом по указанному индексу, в поле списка кнопки со списком с указанным идентификатором команды.
static LPCTSTR GetItemAll(
UINT uiCmd,
int iIndex=-1);
Параметры
uiCmd
[in] Идентификатор команды кнопки со списком.
iIndex
[in] Отсчитываемый от нуля индекс элемента в поле списка.
Возвращаемое значение
Указатель на строку элемента, если метод выполнен успешно; в противном случае значение NULL, если индекс недопустим, кнопка со списком не найдена или если индекс равен -1, и в поле со списком отсутствует выбранный элемент.
Замечания
Значение индекса -1 возвращает строку выбранного элемента.
CMFCToolBarComboBoxButton::GetItemData
Возвращает данные, связанные с элементом по определенному индексу в поле списка.
DWORD_PTR GetItemData(int iIndex=-1) const;
Параметры
iIndex
[in] Отсчитываемый от нуля индекс элемента в поле списка.
Возвращаемое значение
Данные, связанные с элементом; или 0, если элемент не существует.
Замечания
Параметр индекса -1 возвращает данные, связанные с выбранным в данный момент элементом.
CMFCToolBarComboBoxButton::GetItemDataAll
Возвращает данные, связанные с элементом по определенному индексу в поле списка кнопки со списком с определенным идентификатором команды.
static DWORD_PTR GetItemDataAll(
UINT uiCmd,
int iIndex=-1);
Параметры
uiCmd
[in] Идентификатор команды кнопки со списком.
iIndex
[in] Отсчитываемый от нуля индекс элемента в поле списка.
Возвращаемое значение
Данные, связанные с элементом, если метод выполнен успешно; В противном случае значение 0, если указанный индекс недопустим или CB_ERR, если кнопка со списком не найдена.
Замечания
Параметр индекса -1 возвращает данные, связанные с выбранным в данный момент элементом.
CMFCToolBarComboBoxButton::GetItemDataPtrAll
Возвращает данные, связанные с элементом по определенному индексу в поле списка кнопки со списком с определенным идентификатором команды. Эти данные возвращаются в виде указателя.
static void* GetItemDataPtrAll(
UINT uiCmd,
int iIndex=-1);
Параметры
uiCmd
[in] Идентификатор команды кнопки со списком.
iIndex
[in] Отсчитываемый от нуля индекс элемента в поле списка.
Возвращаемое значение
Указатель, связанный с элементом, если метод выполнен успешно; в противном случае значение -1, если возникает ошибка или значение NULL, если кнопка со списком не найдена.
Замечания
CMFCToolBarComboBoxButton::GetPrompt
Возвращает строку запроса для кнопки со списком.
virtual CString GetPrompt() const;
Возвращаемое значение
Строка запроса.
Замечания
Этот метод в настоящее время не реализован.
CMFCToolBarComboBoxButton::GetText
Возвращает текст в поле редактирования.
LPCTSTR GetText() const;
Возвращаемое значение
Текст в поле редактирования.
Замечания
CMFCToolBarComboBoxButton::GetTextAll
Возвращает текст в поле редактирования кнопки со списком с указанным идентификатором команды.
static LPCTSTR GetTextAll(UINT uiCmd);
Параметры
uiCmd
[in] Идентификатор команды определенной кнопки со списком.
Возвращаемое значение
Текст в поле редактирования, если метод выполнен успешно; в противном случае значение NULL.
Замечания
CMFCToolBarComboBoxButton::HasFocus
Указывает, имеет ли в настоящее время поле со списком фокус.
virtual BOOL HasFocus() const;
Возвращаемое значение
ЗНАЧЕНИЕ TRUE, если поле со списком в настоящее время имеет фокус; в противном случае — ЗНАЧЕНИЕ FALSE.
Замечания
Этот метод также возвращает значение TRUE, если в настоящее время фокус имеет любое дочернее окно поля со списком.
CMFCToolBarComboBoxButton::IsCenterVert
Возвращает вертикальную позицию кнопок поля со списком в приложении.
static BOOL IsCenterVert();
Возвращаемое значение
ЗНАЧЕНИЕ TRUE, если кнопки по центру; Значение FALSE, если кнопки выровнены вверху.
Замечания
CMFCToolBarComboBoxButton::IsFlatMode
Возвращает внешний вид кнопок поля со списком в приложении.
static BOOL IsFlatMode();
Возвращаемое значение
ЗНАЧЕНИЕ TRUE, если кнопки имеют плоский стиль; в противном случае — ЗНАЧЕНИЕ FALSE.
Замечания
По умолчанию для кнопок поля со списком используется неструктурированный стиль.
CMFCToolBarComboBoxButton::IsOwnerOf
Указывает, связан ли указанный дескриптор с кнопкой со списком или одним из его дочерних элементов.
virtual BOOL IsOwnerOf(HWND hwnd);
Параметры
hwnd
[in] Дескриптор окна.
Возвращаемое значение
ЗНАЧЕНИЕ TRUE, если дескриптор переключен с помощью кнопки со списком или одного из его дочерних элементов; в противном случае — ЗНАЧЕНИЕ FALSE.
CMFCToolBarComboBoxButton::IsRibbonButton
Указывает, находится ли кнопка со списком на панели ленты.
BOOL IsRibbonButton() const;
Возвращаемое значение
Всегда FALSE.
Замечания
По умолчанию этот метод всегда возвращает значение FALSE, что означает, что кнопка со списком никогда не отображается на панели ленты.
CMFCToolBarComboBoxButton::IsWindowVisible
Возвращает состояние видимости кнопки со списком.
virtual BOOL IsWindowVisible();
Возвращаемое значение
Состояние видимости кнопки со списком.
CMFCToolBarComboBoxButton::NotifyCommand
Указывает, обрабатывает ли кнопка со списком сообщение.
virtual BOOL NotifyCommand(int iNotifyCode);
Параметры
iNotifyCode
[in] Сообщение уведомления, связанное с командой.
Возвращаемое значение
Обрабатывает ли кнопка со списком сообщение.
CMFCToolBarComboBoxButton::OnAddToCustomizePage
Вызывается платформой при добавлении кнопки в диалоговое окно "Настройка ".
virtual void OnAddToCustomizePage();
CMFCToolBarComboBoxButton::OnCalculateSize
Вызывается платформой для вычисления размера кнопки.
virtual SIZE OnCalculateSize(
CDC* pDC,
const CSize& sizeDefault,
BOOL bHorz);
Параметры
pDC
[in] Контекст устройства, отображающий кнопку со списком.
sizeDefault
[in] Размер поля со списком по умолчанию.
bHorz
[in] Состояние док-станции родительской панели инструментов. ЗНАЧЕНИЕ TRUE, если панель инструментов закреплена по горизонтали и false при закреплении панели инструментов по вертикали.
Возвращаемое значение
Структура SIZE , содержащая размеры кнопки со списком в пикселях.
CMFCToolBarComboBoxButton::OnChangeParentWnd
Вызывается платформой при вставке кнопки со списком в новую панель инструментов.
virtual void OnChangeParentWnd(CWnd* pWndParent);
Параметры
pWndParent
[in] Указатель на новую родительскую панель инструментов.
CMFCToolBarComboBoxButton::OnClick
Вызывается платформой, когда пользователь нажимает кнопку со списком.
virtual BOOL OnClick(
CWnd* pWnd,
BOOL bDelay = TRUE);
Параметры
pWnd
[in] Указатель на родительское окно кнопки со списком.
bDelay
[in] Зарезервировано для использования в производном классе.
Возвращаемое значение
ЗНАЧЕНИЕ TRUE, если метод обрабатывает событие; в противном случае — ЗНАЧЕНИЕ FALSE.
CMFCToolBarComboBoxButton::OnCtlColor
Вызывается платформой, когда пользователь изменяет цвет родительской панели инструментов, чтобы задать цвет кнопки со списком.
virtual HBRUSH OnCtlColor(
CDC* pDC,
UINT nCtlColor);
Параметры
pDC
[in] Контекст устройства, отображающий кнопку со списком.
nCtlColor
[in] Неиспользуемые.
Возвращаемое значение
Обработайте кисть, которую платформа использует для рисования фона кнопки со списком.
Замечания
Этот метод также задает цвет текста кнопки со списком.
CMFCToolBarComboBoxButton::OnDraw
Вызывается платформой для рисования кнопки поля со списком с помощью указанных стилей и параметров.
virtual void OnDraw(
CDC* pDC,
const CRect& rect,
CMFCToolBarImages* pImages,
BOOL bHorz = TRUE,
BOOL bCustomizeMode = FALSE,
BOOL bHighlight = FALSE,
BOOL bDrawBorder = TRUE,
BOOL bGrayDisabledButtons = TRUE);
Параметры
Pdc
[in] Контекст устройства, отображающий кнопку.
rect
[in] Ограничивающий прямоугольник кнопки.
pImages
[in] Коллекция изображений, связанных с кнопкой.
bHorz
[in] Состояние док-станции родительской панели инструментов. ЗНАЧЕНИЕ TRUE, если панель инструментов закреплена по горизонтали и false при закреплении панели инструментов по вертикали.
bCustomizeMode
[in] Указывает, находится ли приложение в режиме настройки.
bHighlight
[in] Нарисуйте выделенную кнопку со списком.
bDrawBorder
[in] Нарисуйте кнопку со списком с границой.
bGrayDisabledButtons
[in] ЗНАЧЕНИЕ TRUE для рисования оттеняемых кнопок; ЗНАЧЕНИЕ FALSE для использования коллекции отключенных образов.
CMFCToolBarComboBoxButton::OnDrawOnCustomizeList
Вызывается платформой для рисования кнопки со списком в области "Команды " диалогового окна "Настройка ".
virtual int OnDrawOnCustomizeList(
CDC* pDC,
const CRect& rect,
BOOL bSelected);
Параметры
pDC
[in] Контекст устройства, отображающий кнопку со списком.
rect
[in] Ограничивающий прямоугольник кнопки со списком.
bSelected
[in] ЗНАЧЕНИЕ TRUE, если выбрана кнопка со списком; в противном случае — ЗНАЧЕНИЕ FALSE.
Возвращаемое значение
Ширина в пикселях кнопки со списком.
CMFCToolBarComboBoxButton::OnGlobalFontsChanged
Вызывается платформой для задания шрифта кнопки со списком при изменении шрифта приложения.
virtual void OnGlobalFontsChanged();
CMFCToolBarComboBoxButton::OnMove
Вызывается платформой для изменения расположения кнопки со списком при перемещении родительской панели инструментов.
virtual void OnMove();
CMFCToolBarComboBoxButton::OnShow
Вызывается платформой, когда кнопка со списком скрыта или отображается.
virtual void OnShow(BOOL bShow);
Параметры
bShow
[in] Скрытие или отображение кнопки со списком.
CMFCToolBarComboBoxButton::OnSize
Вызывается платформой для изменения размера кнопки со списком при изменении размера родительской панели инструментов.
virtual void OnSize(int iSize);
Параметры
iSize
[in] Новая ширина кнопки со списком.
CMFCToolBarComboBoxButton::OnUpdateToolTip
Вызывается платформой, когда пользователь изменяет подсказку средства для кнопки со списком.
virtual BOOL OnUpdateToolTip(
CWnd* pWndParent,
int iButtonIndex,
CToolTipCtrl& wndToolTip,
CString& str);
Параметры
pWndParent
[in] Указатель на родительское окно для кнопки со списком.
iButtonIndex
[in] Идентификатор кнопки со списком.
wndToolTip
[in] Подсказка средства, связанная с кнопкой со списком.
str
[in] Текст подсказки средства.
Возвращаемое значение
ЗНАЧЕНИЕ TRUE, если метод обрабатывает событие; в противном случае — ЗНАЧЕНИЕ FALSE.
CMFCToolBarComboBoxButton::RemoveAllItems
Удаляет все элементы из списка и поля редактирования.
void RemoveAllItems();
Замечания
Удаляет все элементы из списка и редактирует элемент управления со списком.
CMFCToolBarComboBoxButton::SelectItem
Выбирает элемент в списке.
BOOL SelectItem(
int iIndex,
BOOL bNotify=TRUE);
BOOL SelectItem(DWORD_PTR dwData);
BOOL SelectItem(LPCTSTR lpszText);
Параметры
iIndex
[in] Отсчитываемый от нуля индекс элемента в поле списка.
bNotify
[in] ЗНАЧЕНИЕ TRUE, чтобы уведомить кнопку со списком о выборе; в противном случае ЗНАЧЕНИЕ FALSE.
dwData
[in] Данные, связанные с элементом в списке.
lpszText
[in] Текст элемента в поле списка.
Возвращаемое значение
ЗНАЧЕНИЕ TRUE, если метод выполнен успешно; в противном случае ЗНАЧЕНИЕ FALSE.
Замечания
CMFCToolBarComboBoxButton::SelectItemAll
Выбирает элемент в списке кнопки со списком с указанным идентификатором команды.
static BOOL SelectItemAll(
UINT uiCmd,
int iIndex);
static BOOL SelectItemAll(
UINT uiCmd,
DWORD_PTR dwData);
static BOOL SelectItemAll(
UINT uiCmd,
LPCTSTR lpszText);
Параметры
uiCmd
[in] Идентификатор команды кнопки со списком, содержащей поле списка.
iIndex
[in] Отсчитываемый от нуля индекс элемента в поле списка. Значение -1 удаляет любой текущий выбор в списке и очищает поле редактирования.
dwData
[in] Данные элемента в списке.
lpszText
[in] Текст элемента в поле списка.
Возвращаемое значение
ЗНАЧЕНИЕ TRUE, если метод выполнен успешно; в противном случае ЗНАЧЕНИЕ FALSE.
Замечания
CMFCToolBarComboBoxButton::Serialize
Считывает этот объект из архива или записывает его в архив.
virtual void Serialize(CArchive& ar);
Параметры
Ar
[in, out] Объект для CArchive сериализации.
Замечания
Параметры в объекте CArchive определяют, считывает ли этот метод или записывает его в архив.
CMFCToolBarComboBoxButton::SetACCData
Заполняет указанный CAccessibilityData объект с помощью данных специальных возможностей с помощью кнопки со списком.
virtual BOOL SetACCData(
CWnd* pParent,
CAccessibilityData& data);
Параметры
pParent
[in] Родительское окно кнопки со списком.
data
[out] CAccessibilityData Объект, который получает данные специальных возможностей из кнопки со списком.
Возвращаемое значение
ЗНАЧЕНИЕ TRUE, если метод выполнен успешно; в противном случае ЗНАЧЕНИЕ FALSE.
CMFCToolBarComboBoxButton::SetCenterVert
Задает вертикальную позицию кнопок поля со списком в приложении.
static void SetCenterVert(BOOL bCenterVert=TRUE);
Параметры
bCenterVert
[in] ЗНАЧЕНИЕ TRUE, чтобы по центру кнопки со списком на панели инструментов; Значение FALSE для выравнивания кнопки со списком в верхней части панели инструментов.
Замечания
По умолчанию кнопки со списком выровнены поверх.
CMFCToolBarComboBoxButton::SetContextMenuID
Задает идентификатор ресурса контекстного меню для кнопки со списком.
void SetContextMenuID(UINT uiResID);
Параметры
uiResID
[in] Идентификатор ресурса контекстного меню.
CMFCToolBarComboBoxButton::SetDropDownHeight
Задает высоту поля списка при его удалении.
void SetDropDownHeight(int nHeight);
Параметры
nHeight
[in] Высота в пикселях списка.
Замечания
Высота по умолчанию составляет 150 пикселей.
CMFCToolBarComboBoxButton::SetFlatMode
Задает внешний вид кнопок поля со списком в приложении.
static void SetFlatMode(BOOL bFlat=TRUE);
Параметры
bFlat
[in] TRUE для внешнего вида плоского стиля; в противном случае ЗНАЧЕНИЕ FALSE.
Замечания
По умолчанию для кнопок поля со списком используется неструктурированный стиль.
CMFCToolBarComboBoxButton::SetStyle
Задает указанный стиль для кнопки со списком и перерисовывает элемент управления, если он не отключен.
virtual void SetStyle(UINT nStyle);
Параметры
nStyle
[in] Побитовое сочетание стилей панели инструментов (OR).
Замечания
Список стилей кнопки панели инструментов см. в разделе "Стили элементов управления ToolBar"
CMFCToolBarComboBoxButton::SetText
Задает текст в поле редактирования кнопки со списком.
void SetText(LPCTSTR lpszText);
Параметры
lpszText
[in] Указатель на строку, содержащую текст для поля редактирования.
См. также
Диаграмма иерархии
Классы
Класс CMFCToolBarButton
Класс CComboBox
CMFCToolBar::ReplaceButton
Пошаговое руководство. Размещение элементов управления на панели инструментов
Обратная связь
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделе https://aka.ms/ContentUserFeedback.
Отправить и просмотреть отзыв по