Объект CommandBarControl

Объект CommandBarControl предоставляет доступ ко всем элементам управления панели команд. Каждый объект CommandBarControl является элементом коллекции CommandBarControls.

Все свойства и методы, которые имеет объект CommandBarControl, также имеют и объекты CommandBarButton, CommandBarComboBox и CommandBarPopup.

ВНИМАНИЕ. Для работы с элементами управления панели команд используют объекты CommandBarButton, CommandBarComboBox и CommandBarPopup. Поскольку не все встроенные элементы управления могут быть представлены одним из этих трех объектов, то для работы с такими встроенными элементами управления используют объект CommandBarControl.

В случае объявления в программе переменной типа CommandBarControl, ей можно присвоить ссылку на объекты CommandBarButton, CommandBarComboBox и CommandBarPopup.

Свойства объекта CommandBarControl

Основные свойства объекта CommandBarControl подробно рассмотрены в табл. 5.11.

Таблица 5.11. Свойства объекта CommandBаrControl

Свойство	Тип	Описание	Запись
BeginGroup	Boolean	Позволяет начать группу элементов управления на панели команд, начиная с данного, при задании данному свойству значения True	X
Caption	String	Определяет текст заголовка элемента управления панели команд. Для свойства TooltipText значение данного свойства является значением по умолчанию	X
HelpContextld	Long	Определяет идентификатор справки, присоединенной к элементу управления панели команд. Данное свойство используется совместно со свойством HelpFile	X
HelpFile	String	Определяет имя файла справки, присоединенного к элементу управления панели команд. Чтобы использовать данное свойство, вы должны сначала присвоить какое-либо значение свойству HelpContextID. Если элемент управления выделен, то определяемый этим свойством файл справки будет появляться при нажатии клавиши F1	X
Index	Long	Возвращает порядковый номер объекта в коллекции. Первый элемент управления панели команд в коллекции CommandBarControls имеет номер 1. Разделители не включаются в коллекцию CommandBarControls
OnAction	String	Определяет имя макроса или функции Visual Basic, которая будет выполнена при нажатии на элементе управления или изменении его значения	X
Parameter	String	Определяет строку, которую может использовать приложение для выполнения команды при нажатии на элементе управления панели команд. Эта строка может быть, например, параметром функции, определенной свойством OnAction. С помощью данного свойства можно изменить поведение встроенного элемента управления. Для этого ему необходимо присвоить соответствующее значение	X
Priority		Определяет приоритет элементов управления панелей команд в том случае, если элементы управления не помещаются на одной строке. Допустимыми значениями данного свойства являются числа в диапазоне от 0 до 7. Если значение этого свойство равно 1 , то элемент управления не может быть удален с панели команд. При этом все остальные значения данного свойства игнорируются. Обратите внимание, что данное свойство используется только для элементов управления панелей инструментов и не применимо для пунктов меню
ShortcutText	String	Определяет название горячей клавиши, отображаемый в меню, подменю или контекстных меню. Это свойство можно задать только в том случае, если установлено свойство OnAction	X
Tag	String	Предназначено для введения дополнительной информации об элементе управления. Эта информация может использоваться, например, как аргумент в процедуре или для идентификации элемента управления	X
TooltipText	String	Определяет текст экранной подсказки, отображаемой для элемента управления панели команд. По умолчанию в качестве значения данного свойства используется значение свойства Caption	X
Type	Long	Определяет тип элемента управления панели команд. Значение данного свойства должно равняться одной из констант, определяющих тип элемента управления (MsoControlType)