Класс CMFCToolBarButton
Предоставляет функции кнопки для панелей инструментов.
Синтаксис
class CMFCToolBarButton : public CObject
Участники
Открытые конструкторы
| Имя | Описание |
|---|---|
| CMFCToolBarButton::CMFCToolBarButton | Создает и инициализирует объект CMFCToolBarButton. |
CMFCToolBarButton::~CMFCToolBarButton |
Деструктор. |
Открытые методы
| Имя | Описание |
|---|---|
| CMFCToolBarButton::CanBeDropped | Указывает, может ли пользователь разместить кнопку на панели инструментов или меню во время настройки. |
| CMFCToolBarButton::CanBeStored | Указывает, можно ли хранить кнопку. |
| CMFCToolBarButton::CanBeStretched | Указывает, может ли пользователь растянуть кнопку во время настройки. |
| CMFCToolBarButton::CompareWith | Сравнивает этот экземпляр с предоставленным CMFCToolBarButton объектом. |
| CMFCToolBarButton::CopyFrom | Копирует свойства другой кнопки панели инструментов на текущую кнопку. |
| CMFCToolBarButton::CreateFromOleData | CMFCToolBarButton Создает объект из предоставленного COleDataObject объекта. |
CMFCToolBarButton::CreateObject |
Используется платформой для создания динамического экземпляра этого типа класса. |
| CMFCToolBarButton::EnableWindow | Разрешает или запрещает ввод с помощью мыши и клавиатуры. |
| CMFCToolBarButton::ExportToMenuButton | Копирует текст из кнопки панели инструментов в меню. |
| CMFCToolBarButton::GetClipboardFormat | Извлекает глобальный формат буфера обмена для приложения. |
| CMFCToolBarButton::GetHwnd | Извлекает дескриптор окна, связанный с кнопкой панели инструментов. |
| CMFCToolBarButton::GetImage | Извлекает индекс изображения кнопки. |
| CMFCToolBarButton::GetInvalidateRect | Извлекает область клиентской области кнопки, которую необходимо перезапустить. |
| CMFCToolBarButton::GetParentWnd | Извлекает родительское окно кнопки. |
| CMFCToolBarButton::GetProtectedCommands | Извлекает список команд, которые пользователь не может настроить. |
| CMFCToolBarButton::GetTextSize | Извлекает размер текста кнопки. |
| CMFCToolBarButton::HasFocus | Определяет, имеет ли кнопка текущий фокус ввода. |
| CMFCToolBarButton::HaveHotBorder | Определяет, отображается ли граница кнопки, когда пользователь выбирает кнопку. |
| CMFCToolBarButton::IsDrawImage | Определяет, отображается ли изображение на кнопке. |
| CMFCToolBarButton::IsDrawText | Определяет, отображается ли текстовая метка на кнопке. |
| CMFCToolBarButton::IsDroppedDown | Определяет, отображается ли кнопка подменю. |
| CMFCToolBarButton::IsEditable | Определяет, можно ли настроить кнопку. |
| CMFCToolBarButton::IsExtrasize | Определяет, может ли кнопка отображаться с расширенной границей. |
| CMFCToolBarButton::IsFirstInGroup | Определяет, находится ли кнопка в первой позиции в группе кнопок. |
| CMFCToolBarButton::IsHidden | Определяет, скрыта ли кнопка. |
| CMFCToolBarButton::IsHorizontal | Определяет, находится ли кнопка на горизонтальной панели инструментов. |
| CMFCToolBarButton::IsLastInGroup | Указывает, находится ли кнопка в последней позиции в группе кнопок. |
| CMFCToolBarButton::IsLocked | Определяет, находится ли кнопка на заблокированной (не настраиваемой) панели инструментов. |
| CMFCToolBarButton::IsOwnerOf | Определяет, является ли кнопка владельцем предоставленного дескриптора окна. |
| CMFCToolBarButton::IsVisible | Определяет, отображается ли кнопка панели инструментов. |
| CMFCToolBarButton::IsWindowVisible | Определяет, отображается ли базовый дескриптор окна кнопки. |
| CMFCToolBarButton::NotifyCommand | Указывает, обрабатывает ли кнопка сообщение WM_COMMAND . |
| CMFCToolBarButton::OnAddToCustomizePage | Вызывается платформой при добавлении кнопки в диалоговое окно "Настройка ". |
| CMFCToolBarButton::OnBeforeDrag | Указывает, можно ли перетаскивать кнопку. |
| CMFCToolBarButton::OnBeforeDrop | Указывает, может ли пользователь удалить кнопку на целевую панель инструментов. |
| CMFCToolBarButton::OnCalculateSize | Вызывается платформой для вычисления размера кнопки для указанного контекста устройства и состояния закрепления. |
| CMFCToolBarButton::OnCancelMode | Вызывается платформой для обработки сообщения WM_CANCELMODE . |
| CMFCToolBarButton::OnChangeParentWnd | Вызывается платформой при вставке кнопки в новую панель инструментов. |
| CMFCToolBarButton::OnClick | Вызывается платформой, когда пользователь нажимает кнопку мыши. |
| CMFCToolBarButton::OnClickUp | Вызывается платформой, когда пользователь освобождает кнопку мыши. |
| CMFCToolBarButton::OnContextHelp | Вызывается платформой, когда родительская панель инструментов обрабатывает сообщение WM_HELPHITTEST. |
| CMFCToolBarButton::OnCtlColor | Вызывается платформой, когда родительская панель инструментов обрабатывает сообщение WM_CTLCOLOR. |
| CMFCToolBarButton::OnCustomizeMenu | Позволяет кнопке изменить предоставленное меню, когда приложение отображает контекстное меню на родительской панели инструментов. |
| CMFCToolBarButton::OnDblClk | Вызывается платформой, когда родительская панель инструментов обрабатывает сообщение WM_LBUTTONDBLCLK . |
| CMFCToolBarButton::OnDraw | Вызывается платформой для рисования кнопки с помощью указанных стилей и параметров. |
| CMFCToolBarButton::OnDrawOnCustomizeList | Вызывается платформой для рисования кнопки в области "Команды " диалогового окна "Настройка ". |
| CMFCToolBarButton::OnGetCustomToolTipText | Вызывается платформой для получения пользовательского текста подсказки для кнопки. |
| CMFCToolBarButton::OnGlobalFontsChanged | Вызывается платформой при изменении глобального шрифта. |
| CMFCToolBarButton::OnMove | Вызывается платформой при перемещении родительской панели инструментов. |
| CMFCToolBarButton::OnShow | Вызывается платформой, когда кнопка становится видимой или невидимой. |
| CMFCToolBarButton::OnSize | Вызывается платформой, когда родительская панель инструментов изменяет размер или положение, и для этого изменения требуется кнопка изменить размер. |
| CMFCToolBarButton::OnToolHitTest | Вызывается платформой, когда родительская панель инструментов должна определить, находится ли точка в ограничивающем прямоугольнике кнопки. |
| CMFCToolBarButton::OnUpdateToolTip | Вызывается платформой, когда родительская панель инструментов обновляет текст подсказки. |
| CMFCToolBarButton::P repareDrag | Вызывается платформой, когда кнопка будет выполнять операцию перетаскивания. |
| CMFCToolBarButton::Rect | Извлекает ограничивающий прямоугольник кнопки. |
| CMFCToolBarButton::ResetImageToDefault | Задает значение по умолчанию изображения, связанного с кнопкой. |
| CMFCToolBarButton::SaveBarState | Сохраняет состояние кнопки панели инструментов. |
| CMFCToolBarButton::Serialize | Считывает этот объект из архива или записывает его в архив. (Переопределяет CObject::Serialize.) |
| CMFCToolBarButton::SetACCData | Заполняет предоставленный CAccessibilityData объект данными специальных возможностей с помощью кнопки панели инструментов. |
| CMFCToolBarButton::SetClipboardFormatName | Переименовывает формат глобального буфера обмена. |
| CMFCToolBarButton::SetImage | Задает индекс изображения кнопки. |
| CMFCToolBarButton::SetProtectedCommands | Задает список команд, которые пользователь не может настроить. |
| CMFCToolBarButton::SetRadio | Вызывается платформой при изменении проверяемого состояния кнопки. |
| CMFCToolBarButton::SetRect | Задает ограничивающий прямоугольник кнопки. |
| CMFCToolBarButton::SetStyle | Устанавливает стиль кнопки. |
| CMFCToolBarButton::SetVisible | Указывает, отображается ли кнопка. |
| CMFCToolBarButton::Show | Показывает или скрывает кнопку. |
Элементы данных
| Имя | Описание |
|---|---|
| CMFCToolBarButton::m_bImage | Указывает, отображается ли изображение на кнопке. |
| CMFCToolBarButton::m_bText | Указывает, отображается ли текстовая метка на кнопке. |
| CMFCToolBarButton::m_bTextBelow | Указывает, отображается ли текстовая метка под изображением на кнопке. |
| CMFCToolBarButton::m_bUserButton | Указывает, имеет ли кнопка определяемый пользователем образ. |
| CMFCToolBarButton::m_bWholeText | Указывает, отображает ли кнопка полную текстовую метку, даже если она не помещается в ограничивающий прямоугольник. |
| CMFCToolBarButton::m_bWrap | Указывает, будет ли кнопка рядом с разделителем помещена в следующую строку. |
| CMFCToolBarButton::m_bWrapText | Указывает, включены ли многострочный текстовые метки. |
| CMFCToolBarButton::m_nID | Идентификатор команды кнопки. |
| CMFCToolBarButton::m_nStyle | Стиль кнопки. |
| CMFCToolBarButton::m_strText | Текстовая метка кнопки. |
Замечания
CMFCToolbarButton Объект — это элемент управления, который находится на панели инструментов. Его поведение напоминает обычную кнопку. Вы можете назначить изображение и текстовую метку этому объекту. Кнопка панели инструментов также может иметь идентификатор команды. Когда пользователь нажимает кнопку панели инструментов, платформа выполняет команду, указанную этим идентификатором.
Как правило, кнопки панели инструментов можно настроить: пользователь может перетаскивать кнопки из одной панели инструментов в другую, а также копировать, вставлять, удалять и изменять текстовые метки и изображения. Чтобы запретить пользователю настраивать панель инструментов, можно заблокировать панель инструментов одним из двух способов. При вызове CMFCToolBar::LoadToolBar или bLocked добавьте идентификатор команды отдельной кнопки в глобальный список защищенных команд с помощью метода CMFCToolBarButton::SetProtectedCommands.
CMFCToolBarButton объекты отображают изображения из глобальных коллекций образов панели инструментов в приложении. Эти коллекции поддерживаются родительской панелью инструментов, класс CMFCToolBar. Дополнительные сведения см. в классе CMFCToolBarImages.
Когда пользователь нажимает кнопку панели инструментов, ее родительская панель инструментов обрабатывает сообщение мыши и передает соответствующие действия кнопке. Если кнопка имеет допустимый идентификатор команды, родительская панель инструментов отправляет сообщение WM_COMMAND родительскому кадру.
Класс CMFCToolBarButton является базовым классом для других классов кнопок панели инструментов, таких как класс CMFCToolBarMenuButton, класс CMFCToolBarEditBoxButton и класс CMFCToolBarComboBoxButton.
Пример
В следующем примере показано, как настроить CMFCToolBarButton объект с помощью различных методов в CMFCToolBarButton классе. В примере показано, как включить ввод мыши и клавиатуры, задать индекс изображения кнопки, задать ограничивающий прямоугольник кнопки и сделать кнопку видимой. Этот фрагмент кода является частью примера элемента управления tab.
CMFCToolBarButton *pOffice2007 = NULL;
int nIndex = -1;
for (UINT uiCmd = ID_VIEW_APPLOOK_2007_1; uiCmd <= ID_VIEW_APPLOOK_2007_4; uiCmd++)
{
// CMFCToolBar m_wndToolBarTheme
nIndex = m_wndToolBarTheme.CommandToIndex(uiCmd);
CMFCToolBarButton *pButton = m_wndToolBarTheme.GetButton(nIndex);
if (pButton != NULL)
{
pOffice2007 = pButton;
break;
}
}
pOffice2007->EnableWindow();
pOffice2007->SetImage(1);
pOffice2007->SetRect(CRect(1, 1, 1, 1));
pOffice2007->SetVisible();
pOffice2007->Show(true);
Иерархия наследования
Требования
Заголовок: afxtoolbarbutton.h
CMFCToolBarButton::CanBeDropped
Указывает, может ли пользователь разместить кнопку на панели инструментов или меню во время настройки.
virtual BOOL CanBeDropped(CMFCToolBar* pToolbar);
Параметры
pToolbar
[in] Неиспользованный.
Возвращаемое значение
Этот метод возвращает ЗНАЧЕНИЕ TRUE.
Замечания
По умолчанию кнопка панели инструментов может быть удалена на каждой настраиваемой (то есть неблокируемой) панели инструментов.
Реализация этого метода по умолчанию возвращает ЗНАЧЕНИЕ TRUE. Переопределите этот метод и верните значение FALSE, если вы хотите запретить пользователю изменять положение кнопки.
CMFCToolBarButton::CanBeStored
Определяет, можно ли хранить кнопку.
virtual BOOL CanBeStored() const;
Возвращаемое значение
Этот метод возвращает ЗНАЧЕНИЕ TRUE.
Замечания
Платформа использует этот метод, чтобы определить, может ли кнопка участвовать в операции перетаскивания.
Реализация по умолчанию возвращает ЗНАЧЕНИЕ TRUE. Переопределите этот метод, если кнопка не может храниться в рамках операции перетаскивания. Дополнительные сведения об операциях перетаскивания см. в разделе "Перетаскивание OLE".
CMFCToolBarButton::CanBeStretched
Указывает, может ли пользователь растянуть кнопку во время настройки.
virtual BOOL CanBeStretched() const;
Возвращаемое значение
Этот метод возвращает ЗНАЧЕНИЕ FALSE.
Замечания
Этот метод используется платформой для определения возможности растяжения кнопки в режиме настройки.
Реализация этого метода по умолчанию возвращает ЗНАЧЕНИЕ FALSE. Переопределите этот метод, чтобы вернуть значение TRUE для элемента управления переменной ширины, например поля со списком или ползунка.
Дополнительные сведения о режиме настройки см. в разделе CMFCToolBar::SetCustomizeMode.
CMFCToolBarButton::CMFCToolBarButton
Создает и инициализирует объект CMFCToolBarButton.
CMFCToolBarButton(
UINT uiID,
int iImage,
LPCTSTR lpszText=NULL,
BOOL bUserButton=FALSE,
BOOL bLocked=FALSE);
Параметры
uiID
[in] Идентификатор команды кнопки.
iImage
[in] Индекс изображения кнопки в коллекции изображений.
lpszText
[in] Текстовая метка кнопки. Может иметь значение NULL.
bUserButton
[in] Логическое значение, определяющее, определена ли кнопка пользователем. Если этот параметр имеет значение TRUE, кнопка определяется пользователем. В противном случае изображение кнопки загружается из ресурса.
блокированный
[in] Логическое значение, определяющее, можно ли настроить кнопку. Если этот параметр имеет значение TRUE, кнопка не может быть настроена. В противном случае можно настроить кнопку.
CMFCToolBarButton::CompareWith
Сравнивает этот экземпляр с предоставленным CMFCToolBarButton объектом.
virtual BOOL CompareWith(const CMFCToolBarButton& other) const;
Параметры
other
[in] Ссылка на объект для сравнения с этим экземпляром.
Возвращаемое значение
Ненулевое значение, если предоставленный объект равен значению этого экземпляра; в противном случае — значение 0.
Замечания
Реализация по умолчанию определяет, равен ли идентификатор команды предоставленного объекта идентификатору команды этого экземпляра. Переопределите этот метод, если необходимо выполнить дополнительную обработку, чтобы определить, равны ли два CMFCToolBarButton объекта.
CMFCToolBarButton::CopyFrom
Копирует свойства другой кнопки панели инструментов на текущую кнопку.
virtual void CopyFrom(const CMFCToolBarButton& src);
Параметры
src
[in] Ссылка на исходную кнопку, из которой следует скопировать.
Замечания
Вызовите этот метод, чтобы скопировать другую кнопку панели инструментов на эту кнопку панели инструментов.
CMFCToolBarButton::CreateFromOleData
CMFCToolBarButton Создает объект из предоставленного COleDataObject объекта.
static CMFCToolBarButton* __stdcall CreateFromOleData(COleDataObject* pDataObject);
Параметры
pDataObject
[in] Исходный объект данных OLE.
Возвращаемое значение
Созданный объект CMFCToolBarButton.
Замечания
Этот метод используется платформой для выполнения передачи данных в различных форматах. Например, CMFCOutlookBarPane::OnDragOver метод использует этот метод для выполнения операций перетаскивания.
CMFCToolBarButton::EnableWindow
Разрешает или запрещает ввод с помощью мыши и клавиатуры.
virtual void EnableWindow(BOOL bEnable = TRUE);
Параметры
bEnable
[in] Задайте для этого параметра значение TRUE, чтобы включить входные данные или значение FALSE, чтобы отключить входные данные.
Замечания
Этот метод вызывает функцию EnableWindow для включения или отключения входных данных. Дополнительные сведения см. в статье EnableWindow в пакете SDK для Windows.
CMFCToolBarButton::ExportToMenuButton
Копирует текст из кнопки панели инструментов в меню.
virtual BOOL ExportToMenuButton(CMFCToolBarMenuButton& menuButton) const;
Параметры
menuButton
[in] Ссылка на целевую кнопку меню.
Возвращаемое значение
Этот метод возвращает ЗНАЧЕНИЕ TRUE.
Замечания
Платформа вызывает этот метод для копирования текста из кнопки панели инструментов в кнопку меню. Реализация по умолчанию копирует текстовую метку кнопки. Если метка текста пуста, этот метод копирует текст подсказки кнопки.
Реализация этого метода по умолчанию возвращает ЗНАЧЕНИЕ TRUE. Переопределите этот метод, если вы хотите выполнить дополнительные действия, если платформа преобразует объект, производный от CMFCToolbarButton , в кнопку меню.
CMFCToolBarButton::GetClipboardFormat
Извлекает глобальный формат буфера обмена для приложения.
static CLIPFORMAT __stdcall GetClipboardFormat();
Возвращаемое значение
Глобальное значение CLIPFORMAT для приложения.
Замечания
Платформа вызывает этот метод для получения формата буфера обмена для операций передачи данных OLE. Например, метод CMFCToolBarButton::CreateFromOleData использует этот метод для копирования данных из исходного объекта данных OLE.
Этот метод задает глобальное значение CLIPFORMAT при первом вызове этого метода. Все последующие вызовы этого метода возвращают это значение.
Чтобы разрешить операции перетаскивания между приложениями, вызовите метод CMFCToolBarButton::SetClipboardFormatName .
Дополнительные сведения о буферах обмена в MFC см. в разделе "Буфер обмена".
CMFCToolBarButton::GetHwnd
Извлекает дескриптор окна, связанный с кнопкой панели инструментов.
virtual HWND GetHwnd();
Возвращаемое значение
Дескриптор окна, связанный с кнопкой панели инструментов или NULL, если кнопка панели инструментов не имеет связанного дескриптора окна.
Замечания
Реализация этого метода по умолчанию возвращает ЗНАЧЕНИЕ NULL. Переопределите этот метод, чтобы вернуть дескриптор окна определенного элемента управления.
CMFCToolBarButton::GetImage
Извлекает индекс изображения кнопки.
int GetImage() const;
Возвращаемое значение
Индекс изображения, связанного с этой кнопкой.
Замечания
Если кнопка содержит определяемое пользователем изображение (то есть, если bUserButton был TRUE в конструкторе), возвращаемый индекс указывает изображение в коллекции определяемых пользователем образов (см. раздел CMFCToolBar::GetUserImages). В противном случае индекс указывает изображение в коллекции образов, загруженных из файла ресурсов (см. cmFCToolBar ::GetImages). Дополнительные сведения о файлах ресурсов см. в статье "Работа с файлами ресурсов".
CMFCToolBarButton::GetInvalidateRect
Извлекает область клиентской области кнопки, которую необходимо перезапустить.
virtual const CRect GetInvalidateRect() const;
Возвращаемое значение
CRect Объект, указывающий регион, который необходимо перезапустить.
Замечания
Реализация этого метода по умолчанию возвращает всю клиентную область. Переопределите этот метод, если требуется переопределить другую область.
CMFCToolBarButton::GetParentWnd
Извлекает родительское окно кнопки.
CWnd* GetParentWnd() const;
Возвращаемое значение
Родительское окно кнопки.
CMFCToolBarButton::GetProtectedCommands
Извлекает список команд, которые пользователь не может настроить.
static const CList<UINT,UINT>& GetProtectedCommands();
Возвращаемое значение
Список защищенных команд.
Замечания
В режиме настройки платформа отключает команды кнопки панели инструментов, защищенные. Пользователь не может выполнять операции перетаскивания и изменения на отключенных кнопках панели инструментов.
Используйте метод CMFCToolBarButton::SetProtectedCommands, чтобы определить список защищенных команд.
CMFCToolBarButton::GetTextSize
Извлекает размер текста кнопки.
SIZE GetTextSize() const;
Возвращаемое значение
Объект SIZE, содержащий размер текста кнопки в пикселях.
CMFCToolBarButton::HasFocus
Определяет, имеет ли кнопка текущий фокус ввода.
virtual BOOL HasFocus() const;
Возвращаемое значение
Ненулевое значение, если кнопка имеет фокус ввода; в противном случае — 0.
Замечания
Реализация этого метода по умолчанию возвращает ненулевое значение, если кнопка имеет фокус ввода или является дочерним или потомком окна окна с фокусом ввода. Эту функцию можно переопределить для настройки этого поведения.
CMFCToolBarButton::HaveHotBorder
Определяет, отображается ли граница кнопки, когда пользователь выбирает кнопку.
virtual BOOL HaveHotBorder() const;
Возвращаемое значение
Этот метод возвращает ЗНАЧЕНИЕ TRUE.
Замечания
Платформа вызывает этот метод, чтобы определить, должна ли кнопка панели инструментов отображать ее границу, когда пользователь выбирает его.
Реализация по умолчанию возвращает ЗНАЧЕНИЕ TRUE. Этот метод можно переопределить для настройки этого поведения.
CMFCToolBarButton::IsDrawImage
Определяет, отображается ли изображение на кнопке.
BOOL IsDrawImage() const;
Возвращаемое значение
Ненулевое значение, если изображение отображается на кнопке; в противном случае — 0.
Замечания
Этот метод возвращает ЗНАЧЕНИЕ FALSE, если кнопка панели инструментов не имеет связанного изображения ( CMFCToolBarButton::GetImage возвращает значение -1) или если для CMFCToolBarButton::m_bImage задано значение FALSE.
CMFCToolBarButton::IsDrawText
Определяет, отображается ли текстовая метка на кнопке.
BOOL IsDrawText() const;
Возвращаемое значение
Ненулевое значение, если отображается текстовая метка; в противном случае — 0.
Замечания
Этот метод возвращает ЗНАЧЕНИЕ FALSE, если кнопка панели инструментов не имеет связанной текстовой метки ( CMFCToolBarButton::m_strText пуста) или параметр CMFCToolBarButton::m_bText имеет значение FALSE.
CMFCToolBarButton::IsDroppedDown
Определяет, отображается ли кнопка подменю.
virtual BOOL IsDroppedDown() const;
Возвращаемое значение
Этот метод возвращает ЗНАЧЕНИЕ FALSE.
Замечания
Реализация этого метода по умолчанию возвращает ЗНАЧЕНИЕ FALSE. Переопределите этот метод, чтобы вернуть значение TRUE, если элемент управления отображает подменю.
CMFCToolBarButton::IsEditable
Определяет, можно ли настроить кнопку.
virtual BOOL IsEditable() const;
Возвращаемое значение
Ненулевое значение, если кнопка может быть настроена пользователем; в противном случае — 0.
Замечания
Платформа вызывает этот метод, чтобы определить, может ли пользователь настроить кнопку панели инструментов с помощью операций перетаскивания или редактирования.
Реализация по умолчанию возвращает значение FALSE, если идентификатор команды кнопки является стандартной командой (ее можно определить, вызвав IsStandardCommand функцию) или если идентификатор команды находится в списке защищенных команд. Дополнительные сведения о защищенных командах см. в разделе CMFCToolBarButton::GetProtectedCommands и CMFCToolBarButton::SetProtectedCommands.
Переопределите этот метод, чтобы настроить его поведение.
CMFCToolBarButton::IsExtrasize
Определяет, может ли кнопка отображаться с расширенной границей.
virtual BOOL IsExtraSize() const;
Возвращаемое значение
Ненулевое значение, если кнопка панели инструментов может отображаться с расширенной границей; в противном случае — 0.
Замечания
В нескольких кожах используется дополнительный размер для границ кнопок панели инструментов (например, круглые кнопки).
Если пользователь перемещает эту кнопку с одной панели инструментов на другую, платформа вызывает метод CMFCToolBarButton::OnChangeParentWnd . Метод CMFCToolBarButton::OnChangeParentWnd задает флаг дополнительного размера для новой родительской панели инструментов (дополнительные сведения см. в разделе CMFCToolBar::IsButtonExtraSizeAvailable).
CMFCToolBarButton::IsFirstInGroup
Определяет, находится ли кнопка в первой позиции в группе кнопок.
virtual BOOL IsFirstInGroup() const;
Возвращаемое значение
TRUE, если кнопка является первой кнопкой в ее группе кнопок; в противном случае ЗНАЧЕНИЕ FALSE.
Замечания
Этот метод определяет группу кнопок в виде соседнего набора кнопок, расположенных в одной строке и ограничивающихся разделителями или границой панели инструментов. Этот метод возвращает значение FALSE, если кнопка панели инструментов ссылается на кнопку "Настройка ". Дополнительные сведения о кнопке "Настройка" см. в разделе CMFCToolBar::GetCustomizeButton.
Вызовите метод CMFCToolBarButton::IsLastInGroup, чтобы определить, находится ли кнопка в последней позиции в группе кнопок.
CMFCToolBarButton::IsHidden
Определяет, скрыта ли кнопка.
BOOL IsHidden() const;
Возвращаемое значение
Ненулевое значение, если кнопка скрыта (невидимая); в противном случае — 0.
Замечания
Платформа вызывает этот метод, когда родительская панель инструментов растянута, чтобы определить, видна ли кнопка панели инструментов.
Если кнопка невидима с помощью метода CMFCToolBarButton::SetVisible , используйте CMFCToolBarButton::IsVisible , чтобы определить, видна ли кнопка панели инструментов.
По умолчанию отображаются все кнопки панели инструментов. Используйте метод CMFCToolBarButton::Show для скрытия или отображения кнопок панели инструментов.
CMFCToolBarButton::IsHorizontal
Определяет, находится ли кнопка на горизонтальной панели инструментов.
BOOL IsHorizontal() const;
Возвращаемое значение
Ненулевое значение, если кнопка панели инструментов расположена на горизонтальной панели инструментов; в противном случае — 0.
Замечания
Платформа вызывает этот метод для определения макета кнопок панели инструментов.
Этот метод возвращает m_bHorz элемент данных. Значение по умолчанию элемента m_bHorz данных — TRUE; оно сбрасывается при каждом вызове метода CMFCToolBarButton::OnDraw .
CMFCToolBarButton::IsLastInGroup
Указывает, находится ли кнопка в последней позиции в группе кнопок.
virtual BOOL IsLastInGroup() const;
Возвращаемое значение
TRUE, если кнопка является последней кнопкой в ее группе кнопок; в противном случае ЗНАЧЕНИЕ FALSE.
Замечания
Этот метод определяет группу кнопок в виде соседнего набора кнопок, расположенных в одной строке и ограничивающихся разделителями или границой панели инструментов Этот метод возвращает значение FALSE, если на панели инструментов нет родительской панели инструментов или кнопка панели инструментов ссылается на кнопку "Настройка ". Дополнительные сведения о кнопке "Настройка" см. в разделе CMFCToolBar::GetCustomizeButton.
Вызовите метод CMFCToolBarButton::IsFirstInGroup, чтобы определить, находится ли кнопка в первой позиции в группе кнопок.
CMFCToolBarButton::IsLocked
Определяет, находится ли кнопка на заблокированной (не настраиваемой) панели инструментов.
BOOL IsLocked() const;
Возвращаемое значение
Ненулевое значение, если кнопка находится на заблокированной панели инструментов; в противном случае — 0.
Замечания
Платформа вызывает этот метод, чтобы определить, может ли пользователь настроить кнопку панели инструментов с помощью операций перетаскивания или редактирования. Задайте заблокированный атрибут на родительской панели инструментов с помощью метода CMFCToolBar::LoadToolBar . Платформа передает значение этого атрибута конструктору каждой кнопки панели инструментов ( CMFCToolbarButton), которую он вставляет в родительскую панель инструментов.
CMFCToolBarButton::IsOwnerOf
Определяет, является ли кнопка владельцем предоставленного дескриптора окна.
virtual BOOL IsOwnerOf(HWND hwnd);
Параметры
hwnd
[in] Дескриптор окна.
Возвращаемое значение
Ненулевое значение, если кнопка является владельцем предоставленного дескриптора окна; в противном случае — 0.
Замечания
Этот метод возвращает ненулевое значение, если он ссылается на прямой дескриптор окна или является дочерним дескриптором окна, связанным с кнопкой. Этот метод возвращает значение 0, если hwnd имеет значение NULL.
CMFCToolBarButton::IsVisible
Определяет, отображается ли кнопка панели инструментов.
BOOL IsVisible() const;
Возвращаемое значение
Ненулевое значение, если кнопка панели инструментов видна; в противном случае — 0.
Замечания
Вы можете отобразить или скрыть кнопку панели инструментов с помощью метода CMFCToolBarButton::SetVisible . Вызовите метод CPane::AdjustSizeImmediate на родительской панели инструментов после вызова CMFCToolBarButton::SetVisible для пересчета макета родительской панели инструментов.
CMFCToolBarButton::IsWindowVisible
Определяет, отображается ли базовый дескриптор окна кнопки.
virtual BOOL IsWindowVisible();
Возвращаемое значение
Ненулевое значение, если базовый дескриптор окна кнопки отображается; в противном случае — 0.
Замечания
Этот метод возвращает ненулевое значение, если атрибут стилей базового дескриптора окна содержит стиль WS_VISIBLE. Этот метод возвращает значение FALSE, если базовый дескриптор окна кнопки имеет значение NULL.
CMFCToolBarButton::m_bImage
Указывает, отображается ли изображение на кнопке.
BOOL m_bImage;
Замечания
Если для этого элемента данных задано значение TRUE, платформа отображает изображение, связанное с кнопкой панели инструментов; в противном случае платформа не отображает изображение. Этот элемент влияет на возвращаемое значение метода CMFCToolBarButton::m_bImage .
CMFCToolBarButton::m_bText
Указывает, отображается ли текстовая метка на кнопке.
BOOL m_bText;
Замечания
Если для этого элемента данных задано значение TRUE, платформа отображает текстовую метку кнопки панели инструментов; В противном случае платформа не отображает текстовую метку. Этот элемент влияет на возвращаемое значение метода CMFCToolBarButton::m_bText .
CMFCToolBarButton::m_bTextBelow
Указывает, отображается ли текстовая метка под изображением на кнопке.
BOOL m_bTextBelow;
Замечания
Если для этой переменной-члена задано значение TRUE, платформа отображает текст кнопки под изображением. Значением по умолчанию этого элемента является FALSE.
CMFCToolBarButton::m_bUserButton
Указывает, имеет ли кнопка определяемый пользователем образ.
BOOL m_bUserButton;
Замечания
Этот элемент данных имеет значение TRUE, если кнопка содержит определяемый пользователем образ.
CMFCToolBarButton::m_bWholeText
Указывает, отображает ли кнопка полную текстовую метку, даже если она не помещается в ограничивающий прямоугольник.
BOOL m_bWholeText;
Замечания
Если для этого элемента данных задано значение TRUE, платформа отображает полную текстовую метку, увеличив кнопку. В противном случае платформа усечена и добавляет многоточие ( ...) к текстовой метки.
CMFCToolBarButton::m_bWrap
Указывает, будет ли кнопка рядом с разделителем помещена в следующую строку.
BOOL m_bWrap;
Замечания
Платформа задает этому элементу данных значение TRUE, если кнопка панели инструментов не помещается в текущую строку или при указании макета (например, определенное количество кнопок панели инструментов для каждой строки).
Платформа помещает эту кнопку в следующую строку, если этот элемент данных имеет значение TRUE, а панель инструментов закреплена горизонтально или плавает.
Значение по умолчанию этого элемента данных равно FALSE.
CMFCToolBarButton::m_bWrapText
Указывает, включены ли многострочный текстовые метки.
AFX_IMPORT_DATA static BOOL m_bWrapText;
Замечания
Если эта статическую переменную-член имеет значение TRUE, платформа позволяет всем панелям инструментов отображать многострочный текстовые метки на кнопках панели инструментов.
Значение по умолчанию этого элемента данных равно FALSE.
CMFCToolBarButton::m_nID
Идентификатор команды кнопки.
UINT m_nID;
Замечания
Идентификатор команды -1 указывает, что кнопка является разделителем. Все разделители кнопки имеют стиль TBBS_SEPARATOR. Дополнительные сведения о стилях кнопок см. в cmFCToolBarButton ::m_nStyle .
CMFCToolBarButton::m_nStyle
Стиль кнопки.
UINT m_nStyle;
Замечания
См. статью "Стили элементов управления ToolBar" для списка доступных стилей кнопок панели инструментов.
CMFCToolBarButton::m_strText
Текстовая метка кнопки.
CString m_strText;
Замечания
Этот элемент данных содержит текстовую метку кнопки. Текстовая метка может быть пуста.
CMFCToolBarButton::NotifyCommand
Указывает, обрабатывает ли кнопка сообщение WM_COMMAND .
virtual BOOL NotifyCommand(int iNotifyCode);
Параметры
iNotifyCode
[in] Сообщение уведомления, связанное с командой.
Возвращаемое значение
Этот метод возвращает ЗНАЧЕНИЕ FALSE.
Замечания
Платформа вызывает этот метод, когда речь идет о отправке сообщения WM_COMMAND в родительское окно.
По умолчанию этот метод возвращает ЗНАЧЕНИЕ FALSE. Переопределите этот метод, чтобы вернуть значение TRUE, если вы хотите обработать сообщение WM_COMMAND или FALSE, чтобы указать, что родительская панель инструментов должна обрабатывать сообщение.
CMFCToolBarButton::OnAddToCustomizePage
Вызывается платформой при добавлении кнопки в диалоговое окно "Настройка ".
virtual void OnAddToCustomizePage();
Замечания
Реализация этого метода по умолчанию ничего не делает. Переопределите этот метод, если вы хотите выполнить некоторое действие при добавлении кнопки в диалоговое окно "Настройка ".
CMFCToolBarButton::OnBeforeDrag
Указывает, можно ли перетаскивать кнопку.
virtual BOOL OnBeforeDrag() const;
Возвращаемое значение
ЗНАЧЕНИЕ TRUE, если кнопка может быть перетаскиваема; в противном случае ЗНАЧЕНИЕ FALSE.
Замечания
Платформа вызывает этот метод, прежде чем пользователь начнет перетаскивать кнопку.
Реализация этого метода по умолчанию возвращает ЗНАЧЕНИЕ TRUE. Переопределите этот метод, чтобы вернуть значение FALSE, чтобы отключить перетаскивание кнопки.
CMFCToolBarButton::OnBeforeDrop
Указывает, может ли пользователь удалить кнопку на целевую панель инструментов.
virtual BOOL OnBeforeDrop(CMFCToolBar* pTarget);
Параметры
pTarget
[in] Цель операции перетаскивания.
Возвращаемое значение
TRUE, если кнопка может быть удалена на указанную целевую панель инструментов; в противном случае ЗНАЧЕНИЕ FALSE.
Замечания
Платформа вызывает этот метод, прежде чем кнопка будет удалена на панель инструментов.
Реализация этого метода по умолчанию возвращает ЗНАЧЕНИЕ TRUE. Переопределите этот метод, чтобы вернуть значение FALSE, чтобы отключить операцию удаления для указанного целевого объекта.
CMFCToolBarButton::OnCalculateSize
Вызывается платформой для вычисления размера кнопки для указанного контекста устройства и состояния закрепления.
virtual SIZE OnCalculateSize(
CDC* pDC,
const CSize& sizeDefault,
BOOL bHorz);
Параметры
pDC
[in] Контекст устройства, отображающий кнопку.
sizeDefault
[in] Размер кнопки по умолчанию.
bHorz
[in] Состояние док-станции родительской панели инструментов. Этот параметр имеет значение TRUE, если панель инструментов закреплена горизонтально или плавает или false, если панель инструментов закреплена по вертикали.
Возвращаемое значение
Структура SIZE , содержащая размеры кнопки в пикселях.
Замечания
Платформа вызывает этот метод, чтобы определить размер кнопки панели инструментов для указанного контекста устройства и состояния док-станции.
Реализация по умолчанию рассматривает размеры текста и изображения (если они отображаются), текст и изображения (текст ниже или в правой части изображения) и состояние панели инструментов.
Переопределите этот метод, если вы хотите указать размер нестандартной кнопки (например, кнопку "Изменить").
CMFCToolBarButton::OnCancelMode
Вызывается платформой для обработки сообщения WM_CANCELMODE .
virtual void OnCancelMode();
Замечания
Реализация этого метода по умолчанию ничего не делает. Переопределите этот метод, если вы хотите обработать сообщение WM_CANCELMODE .
CMFCToolBarButton::OnChangeParentWnd
Вызывается платформой при вставке кнопки в новую панель инструментов.
virtual void OnChangeParentWnd(CWnd* pWndParent);
Параметры
pWndParent
[in] Новое родительское окно.
Замечания
Кнопка вставляется на панель инструментов, например, когда пользователь перетаскивает ее с одной панели инструментов на другую панель инструментов.
Реализация этого метода по умолчанию ничего не делает.
CMFCToolBarButton::OnClick
Вызывается платформой, когда пользователь нажимает кнопку мыши.
virtual BOOL OnClick(
CWnd* pWnd,
BOOL bDelay=TRUE);
Параметры
pWnd
[in] Родительское окно кнопки панели инструментов.
bDelay
[in] ЗНАЧЕНИЕ TRUE, если сообщение должно обрабатываться с задержкой.
Возвращаемое значение
Этот метод возвращает ЗНАЧЕНИЕ FALSE.
Замечания
Платформа вызывает этот метод, когда пользователь нажимает кнопку панели инструментов.
Реализация по умолчанию ничего не делает и возвращает FALSE. Переопределите этот метод, чтобы вернуть ненулевое значение, если кнопка обрабатывает сообщение нажатия.
CMFCToolBarButton::OnClickUp
Вызывается платформой, когда пользователь освобождает кнопку мыши.
virtual BOOL OnClickUp();
Возвращаемое значение
Этот метод возвращает ЗНАЧЕНИЕ FALSE.
Замечания
Платформа вызывает этот метод, когда пользователь освобождает кнопку панели инструментов.
Реализация по умолчанию ничего не делает и возвращает FALSE. Переопределите этот метод, чтобы вернуть ненулевое значение, если кнопка обрабатывает сообщение нажатия.
CMFCToolBarButton::OnContextHelp
Вызывается платформой, когда родительская панель инструментов обрабатывает сообщение WM_HELPHITTEST.
virtual BOOL OnContextHelp(CWnd* pWnd);
Параметры
pWnd
[in] Родительское окно кнопки панели инструментов.
Возвращаемое значение
Этот метод возвращает ЗНАЧЕНИЕ FALSE.
Замечания
Реализация этого метода по умолчанию ничего не делает и возвращает значение FALSE. Переопределите этот метод, чтобы вернуть ненулевое значение, если кнопка обрабатывает сообщение справки.
Дополнительные сведения о сообщении WM_HELPHITTEST см. в разделе TN028: поддержка справки с учетом контекста.
CMFCToolBarButton::OnCtlColor
Вызывается платформой, когда родительская панель инструментов обрабатывает сообщение WM_CTLCOLOR.
virtual HBRUSH OnCtlColor(
CDC* pDC,
UINT nCtlColor);
Параметры
pDC
[in] Контекст устройства, отображающий кнопку.
nCtlColor
[in] Уведомление о конкретном цвете.
Возвращаемое значение
Дескриптор объекта кисти, который платформа использует для рисования фона кнопки.
Замечания
Платформа вызывает этот метод, когда родительская панель инструментов обрабатывает сообщение WM_CTLCOLOR для кнопки панели инструментов, содержащей элемент управления Windows. Платформа не вызывает этот метод, если кнопка панели инструментов не отображается без окна.
Платформа вызывает этот метод, когда платформа панели инструментов находится в режиме настройки, и кнопка панели инструментов разблокирована. Дополнительные сведения о режиме настройки см. в разделе CMFCToolBar::SetCustomizeMode. Дополнительные сведения о блокировке кнопок панели инструментов см. в разделе CMFCToolBarButton::IsLocked.
Реализация по умолчанию ничего не делает и возвращает ЗНАЧЕНИЕ NULL.
CMFCToolBarButton::OnCustomizeMenu
Позволяет кнопке изменить предоставленное меню, когда приложение отображает контекстное меню на родительской панели инструментов.
virtual BOOL OnCustomizeMenu(CMenu* pMenu);
Параметры
pMenu
[in] Меню для настройки.
Возвращаемое значение
Этот метод возвращает ЗНАЧЕНИЕ FALSE.
Замечания
Реализация по умолчанию ничего не делает и возвращает FALSE. Переопределите этот метод и верните ненулевое значение, если вы хотите изменить содержимое предоставленного меню.
CMFCToolBarButton::OnDblClk
Вызывается платформой, когда родительская панель инструментов обрабатывает сообщение WM_LBUTTONDBLCLK .
virtual void OnDblClk(CWnd* pWnd);
Параметры
pWnd
[in] — родительское окно кнопки.
Замечания
Этот метод вызывается методом CMFCToolBar::OnLButtonDblClk , когда родительская панель инструментов обрабатывает сообщение WM_LBUTTONDBLCLK .
Реализация этого метода по умолчанию ничего не делает.
CMFCToolBarButton::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] Указывает, находится ли панель инструментов в режиме настройки. Этот параметр имеет значение TRUE, если панель инструментов находится в режиме настройки и false, если панель инструментов не находится в режиме настройки.
bHighlight
[in] Указывает, выделена ли кнопка. Этот параметр имеет значение TRUE, если кнопка выделена и false, если кнопка не выделена.
bDrawBorder
[in] Указывает, должна ли кнопка отображать ее границу. Этот параметр имеет значение TRUE, если кнопка должна отображать ее границу и FALSE, если кнопка не должна отображать ее границу.
bGrayDisabledButtons
[in] Указывает, следует ли оттенять отключенные кнопки или использовать коллекцию отключенных изображений. Этот параметр имеет значение TRUE, если отключенные кнопки должны быть затеняются и false, если этот метод должен использовать коллекцию отключенных образов.
Замечания
Переопределите этот метод, чтобы настроить рисунок кнопки панели инструментов.
CMFCToolBarButton::OnDrawOnCustomizeList
Вызывается платформой для рисования кнопки в области "Команды " диалогового окна "Настройка ".
virtual int OnDrawOnCustomizeList(
CDC* pDC,
const CRect& rect,
BOOL bSelected);
Параметры
pDC
[in] Контекст устройства, отображающий кнопку.
rect
[in] Ограничивающий прямоугольник кнопки.
bSelected
[in] Указывает, выбрана ли кнопка. Если этот параметр имеет значение TRUE, выбрана кнопка. Если этот параметр имеет значение FALSE, кнопка не выбрана.
Возвращаемое значение
Ширина (в пикселях) кнопки в указанном контексте устройства.
Замечания
Этот метод вызывается диалоговым окном настройки ( вкладка "Команды "), когда кнопка будет отображаться в поле списка "Рисование владельца".
Реализация этого метода по умолчанию отображает изображение и текстовую метку кнопки, если они доступны. Если текстовая метка кнопки недоступна, метод отображает текст подсказки.
Переопределите этот метод для выполнения пользовательского рисования.
CMFCToolBarButton::OnGetCustomToolTipText
Вызывается платформой для получения пользовательского текста подсказки для кнопки.
virtual BOOL OnGetCustomToolTipText(CString& strToolTip);
Параметры
strToolTip
[out] Объект CString , получающий пользовательский текст подсказки.
Возвращаемое значение
Этот метод возвращает ЗНАЧЕНИЕ FALSE.
Замечания
Платформа вызывает этот метод при отображении подсказки для кнопки панели инструментов. Если этот метод возвращает значение FALSE, платформа использует подсказку по умолчанию.
Реализация по умолчанию ничего не делает и возвращает FALSE. Переопределите этот метод и верните ненулевое значение, чтобы предоставить пользовательский текст подсказки для кнопки панели инструментов.
CMFCToolBarButton::OnGlobalFontsChanged
Вызывается платформой при изменении глобального шрифта.
virtual void OnGlobalFontsChanged();
Замечания
Реализация этого метода по умолчанию ничего не делает. Переопределите этот метод, чтобы обновить шрифт, используемый для отображения текста кнопки.
CMFCToolBarButton::OnMove
Вызывается платформой при перемещении родительской панели инструментов.
virtual void OnMove();
Замечания
Реализация этого метода по умолчанию ничего не делает. Переопределите этот метод, чтобы изменить положение кнопки при перемещении родительской панели инструментов.
CMFCToolBarButton::OnShow
Вызывается платформой, когда кнопка становится видимой или невидимой.
virtual void OnShow(BOOL bShow);
Параметры
bShow
[in] Указывает, отображается ли кнопка. Если этот параметр имеет значение TRUE, кнопка отображается. В противном случае кнопка не отображается.
Замечания
Реализация этого метода по умолчанию ничего не делает. Переопределите этот метод, чтобы обновить видимость кнопки.
CMFCToolBarButton::OnSize
Вызывается платформой, когда родительская панель инструментов изменяет размер или положение, и это изменение приводит к изменению размера кнопки.
virtual void OnSize(int iSize);
Параметры
iSize
[in] Новая ширина кнопки.
Замечания
Реализация этого метода по умолчанию ничего не делает. Переопределите этот метод, чтобы изменить размер кнопки при изменении размера или положения родительской панели инструментов.
CMFCToolBarButton::OnToolHitTest
Вызывается платформой, когда родительская панель инструментов должна определить, находится ли точка в ограничивающем прямоугольнике кнопки.
virtual BOOL OnToolHitTest(
const CWnd* pWnd,
TOOLINFO* pTI);
Параметры
pWnd
[in] Родительское окно кнопки. Может иметь значение NULL.
pTI
[in] Структура TOOLINFO , содержащая сведения о инструменте в элементе управления подсказкой.
Возвращаемое значение
Результат, OnMenuButtonToolHitTest если кнопка может получить указатель на родительское окно фрейма; в противном случае — ЗНАЧЕНИЕ FALSE.
Замечания
Этот метод вызывает один из следующих методов, если он может преобразовать родительское окно в допустимый объект кадра:
CMFCToolBarButton::OnUpdateToolTip
Вызывается платформой, когда родительская панель инструментов обновляет текст подсказки.
virtual BOOL OnUpdateToolTip(
CWnd* pWndParent,
int iButtonIndex,
CToolTipCtrl& wndToolTip,
CString& str);
Параметры
pWndParent
[in] Родительское окно.
iButtonIndex
[in] Отсчитываемый от нуля индекс кнопки в родительской коллекции кнопок.
wndToolTip
[in] Элемент управления, отображающий текст подсказки.
str
[out] Объект CString , получающий обновленный текст подсказки.
Возвращаемое значение
Этот метод возвращает ЗНАЧЕНИЕ FALSE.
Замечания
Реализация этого метода по умолчанию ничего не делает и возвращает значение FALSE. Переопределите этот метод, чтобы вернуть ненулевое значение, если вы предоставляете текстовую строку подсказки.
CMFCToolBarButton::P repareDrag
Вызывается платформой, когда кнопка будет выполнять операцию перетаскивания.
virtual BOOL PrepareDrag(COleDataSource& srcItem);
Параметры
srcItem
[in] COleDataSource Объект, в который хранятся сведения о состоянии операции перетаскивания.
Возвращаемое значение
ЗНАЧЕНИЕ TRUE, если операция выполнена успешно; в противном случае ЗНАЧЕНИЕ FALSE.
Замечания
Платформа вызывает этот метод для подготовки кнопки панели инструментов для хранения его состояния в предоставленном COleDataSource объекте. Этот метод сохраняет состояние путем сериализации себя в общий файл, а затем передачи этого файла в метод COleDataSource::CacheGlobalData . Дополнительные сведения о сериализации кнопки панели инструментов см. в разделе CMFCToolBarButton::Serialize.
Этот метод ничего не делает и возвращает значение TRUE, если кнопка не может быть сохранена ( метод CMFCToolBarButton::CanBeStored возвращает ЗНАЧЕНИЕ FALSE). Возвращает значение FALSE, если исключение возникает во время сериализации объектов.
Дополнительные сведения об операциях перетаскивания OLE см. в разделе "Перетаскивание OLE".
CMFCToolBarButton::Rect
Извлекает ограничивающий прямоугольник кнопки.
const CRect& Rect() const;
Возвращаемое значение
CRect Объект, содержащий ограничивающий прямоугольник кнопки.
CMFCToolBarButton::ResetImageToDefault
Задает значение по умолчанию изображения, связанного с кнопкой.
virtual void ResetImageToDefault();
Замечания
Этот метод извлекает изображение по умолчанию из родительской панели инструментов с помощью метода CMFCToolBar::GetDefaultImage . Если кнопка не имеет связанного изображения по умолчанию, этот метод задает текстовую метку кнопки в соответствии со строковым ресурсом с помощью метода CStringT::LoadString . Дополнительные сведения о строковых ресурсах см. в статье "Работа с файлами ресурсов".
Этот метод ничего не делает, если кнопка имеет определяемое пользователем изображение.
CMFCToolBarButton::SaveBarState
Сохраняет состояние кнопки панели инструментов.
virtual void SaveBarState();
Замечания
Платформа вызывает этот метод при создании CMFCToolBarButton объекта в результате операции перетаскивания.
Реализация этого метода по умолчанию ничего не делает. Переопределите этот метод, чтобы сохранить состояние кнопки панели инструментов во внешний источник данных.
CMFCToolBarButton::Serialize
Считывает этот объект из архива или записывает его в архив.
virtual void Serialize(CArchive& ar);
Параметры
ар
[in] CArchive Объект, из которого выполняется сериализация.
Замечания
Этот метод поддерживает такие процессы передачи данных, как буфер обмена или операции перетаскивания. Он считывает или записывает свойства кнопки, такие как идентификатор, текстовая метка и идентификатор изображения из предоставленного объекта или в него CArchive .
Примеры сериализации см. в разделе Сериализация: сериализация объекта.
CMFCToolBarButton::SetACCData
Заполняет предоставленный CAccessibilityData объект данными специальных возможностей с помощью кнопки панели инструментов.
virtual BOOL SetACCData(
CWnd* pParent,
CAccessibilityData& data);
Параметры
pParent
[in] Родительское окно кнопки панели инструментов.
data
[in] CAccessibilityData Объект, заполненный данными специальных возможностей кнопки панели инструментов.
Возвращаемое значение
Этот метод возвращает ЗНАЧЕНИЕ TRUE.
Замечания
Переопределите этот метод, чтобы вернуть значение FALSE, если кнопка панели инструментов не предоставляет данные специальных возможностей.
CMFCToolBarButton::SetClipboardFormatName
Переименовывает формат глобального буфера обмена.
static void __stdcall SetClipboardFormatName(LPCTSTR lpszName);
Параметры
lpszName
[in] Новое имя глобального формата буфера обмена. Не может быть NULL.
Замечания
Этот метод позволяет выполнять операции перетаскивания между несколькими приложениями. Каждое приложение должно указать одно и то же имя формата буфера обмена.
Этот метод необходимо вызвать перед вызовом CMFCToolBarButton::GetClipboardFormat.
CMFCToolBarButton::SetImage
Задает индекс изображения кнопки.
virtual void SetImage(int iImage);
Параметры
iImage
[in] Индекс изображения в коллекции изображений панели инструментов.
Замечания
Если кнопка панели инструментов является разделителем, iImage ссылается на новую ширину кнопки разделителя.
Если iImage меньше нуля, этот метод отключает рисование изображения и включает рисование текстовой метки кнопки.
CMFCToolBarButton::SetProtectedCommands
Задает список команд, которые пользователь не может настроить.
static void SetProtectedCommands(const CList<UINT,UINT>& lstCmds);
Параметры
lstCmds
[in] Список защищенных команд.
Замечания
В режиме настройки платформа отключает команды кнопки панели инструментов, защищенные. Пользователь не может выполнять операции перетаскивания и изменения на отключенных кнопках панели инструментов.
Используйте метод CMFCToolBarButton::GetProtectedCommands, чтобы получить список защищенных команд.
CMFCToolBarButton::SetRadio
Вызывается платформой при изменении проверяемого состояния кнопки.
virtual void SetRadio();
Замечания
Реализация этого метода по умолчанию ничего не делает. Переопределите этот метод, чтобы выполнить настраиваемое действие, когда кнопка изменяет его проверенное состояние.
CMFCToolBarButton::SetRect
Задает ограничивающий прямоугольник кнопки.
void SetRect(const CRect rect);
Параметры
rect
[in] Новый ограничивающий прямоугольник кнопки.
Замечания
Этот метод вызывает метод CMFCToolBarButton::OnMove после установки нового ограничивающего прямоугольника.
CMFCToolBarButton::SetStyle
Устанавливает стиль кнопки.
virtual void SetStyle(UINT nStyle);
Параметры
nStyle
[in] Новый стиль кнопки.
Замечания
Реализация по умолчанию задает элемент данных CMFCToolBarButton::m_nStyle для элемента данных nStyle. Переопределите этот метод, если требуется выполнить дополнительную обработку для обработки изменений в стиле. Список допустимых флагов стилей см. в разделе "Стили элементов управления ToolBar".
CMFCToolBarButton::SetVisible
Указывает, отображается ли кнопка.
void SetVisible(BOOL bShow=TRUE);
Параметры
bShow
[in] Логическое значение, указывающее, следует ли отображать или скрывать кнопку. Если этот параметр имеет значение TRUE, отображается кнопка. Если параметр имеет значение FALSE, кнопка скрыта.
Замечания
Эта функция используется для скрытия или отображения определенной кнопки панели инструментов. Вызовите метод CPane::AdjustSizeImmediate после вызова этого метода.
CMFCToolBarButton::Show
Показывает или скрывает кнопку.
void Show(BOOL bShow);
Параметры
bShow
[in] Логическое значение, указывающее, следует ли отображать или скрывать кнопку. Если этот параметр имеет значение TRUE, отображается кнопка. Если параметр имеет значение FALSE, кнопка скрыта.
Замечания
Платформа вызывает этот метод для обновления видимости кнопок панели инструментов при изменении размера родительской панели инструментов. Платформа вызывает этот метод с параметром bShow с значением FALSE, если кнопка больше не помещается в границы панели инструментов. Платформа вызывает этот метод с параметром bShow с значением TRUE, когда после изменения размера кнопки снова помещается в границы панели инструментов.
Используйте метод CMFCToolBarButton::SetVisible, чтобы задать общую видимость кнопки.
Этот метод вызывает метод CMFCToolBarButton::OnShow после обновления состояния видимости кнопки.
См. также
Диаграмма иерархии
Классы
Класс CMFCToolBar
Класс CMFCToolBarImages