Класс CMFCToolBarComboBoxButton

Статья
10/12/2023

Кнопка панели инструментов, содержащая элемент управления со списком ( класс 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"));

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

CObject

CMFCToolBarButton

CMFCToolBarComboBoxButton

Требования

Заголовок: 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] Вторая строка для сравнения.

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

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

значение	Описание
<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] Коллекция изображений, связанных с кнопкой.

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);

Параметры

ар
[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
Пошаговое руководство. Размещение элементов управления на панели инструментов

Поделиться через

Класс CMFCToolBarComboBoxButton

Синтаксис

Участники

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

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

Замечания

Пример

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

Требования

CMFCToolBarComboBoxButton::AddItem

Параметры

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

Замечания

CMFCToolBarComboBoxButton::AddSortedItem

Параметры

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

Замечания

CMFCToolBarComboBoxButton::CanBeStretched

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

CMFCToolBarComboBoxButton::CMFCToolBarComboBoxButton

Параметры

Замечания

CMFCToolBarComboBoxButton::ClearData

Замечания

CMFCToolBarComboBoxButton::Compare

Параметры

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

Замечания

CMFCToolBarComboBoxButton::CopyFrom

Параметры

CMFCToolBarComboBoxButton::CreateCombo

Параметры

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

CMFCToolBarComboBoxButton::CreateEdit

Параметры

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

Замечания

CMFCToolBarComboBoxButton::D eleteItem

Параметры

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

Замечания

CMFCToolBarComboBoxButton::D uplicateData

Замечания

CMFCToolBarComboBoxButton::EnableWindow

Параметры

Замечания

CMFCToolBarComboBoxButton::ExportToMenuButton

Параметры

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

CMFCToolBarComboBoxButton::FindItem

Параметры

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

Замечания

CMFCToolBarComboBoxButton::GetByCmd

Параметры

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

Замечания

CMFCToolBarComboBoxButton::GetComboBox

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

Замечания

CMFCToolBarComboBoxButton::GetContextMenuID

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

CMFCToolBarComboBoxButton::GetCount

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

Замечания

CMFCToolBarComboBoxButton::GetCountAll

Параметры

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

Замечания

CMFCToolBarComboBoxButton::GetCurSel

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

Замечания

CMFCToolBarComboBoxButton::GetCurSelAll

Параметры

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

Замечания

CMFCToolBarComboBoxButton::GetEditCtrl

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

Замечания