На этом шаге мы рассмотрим назначение и основные свойства этого объекта.

    Семейство CommandBarControls содержит все элементы конкретной панели инструментов или меню. Важнейшим методом этого семейства является метод Add, создающий новый элемент. Рассмотрим синтаксис метода Add.

    Метод Add добавляет новый элемент на панель управления или в меню. Возвращает объект CommandBarButton, CommandBarComboBox или CommandBarPopup.

    Синтаксис:

  Add (Type, Id, Parameter, Before, Temporary)

• Type — задает тип добавляемого элемента. Допустимые значения:
  • msoControlButton (кнопка или элемент меню);
  • msoControlEdit (поле ввода);
  • msoControlDropdown (раскрывающийся список);
  • msoControlComboBox (поле со списком)$
  • msoControlPopup (вложенное меню).
• Id — целое число, идентифицирующее встроенный элемент управления. Если аргумент Id равен 1 или опущен, то добавляется пустой элемент управления заданного типа;
• Parameter — задает параметр, используемый встроенным элементом управления;
• Before — индекс или имя элемента управления, перед которым добавляется новый элемент управления. Если аргумент опущен, то элемент размещается в конце панели инструментов или меню;
• Temporary — допустимые значения: True (новый элемент управления автоматически удаляется из меню или панели инструментов при закрытии приложения) и False (в противном случае).

    Перечислим основные свойства объекта CommandBarControl.

Таблица 1. Свойства CommandBarControl

Свойство	Назначение
Caption	Текстовая строка, отображаемая в заголовке
DescriptionText	Возвращает описание элемента управления
Enabled	Устанавливает, является ли допустимым выбранный пользователем элемент управления
FaceID	Возвращает номер встроенной кнопки, используемой в качестве элемента управления. Если это свойство равно нулю, то возвращается пустой элемент управления
OnAction	Возвращает комбинацию горячих клавиш, назначенных элементу управления
Style	Только для объекта CommandBarButton. Устанавливает внешний вид кнопки. Допустимые значения: msoButtonAutomatic (кнопка не содержит текста и рисунка); msoButtonIcon (кнопка содержит рисунок, в этом случае надо также задать свойство Icon); msoButtonCaption (кнопка содержит текст, в этом случае надо также задать свойство Caption); msoButtonIconandCaption (кнопка содержит текст и рисунок, в этом случае надо также задать свойства Icon и Caption).
TooltipText	Текст, отображаемый в окне всплывающей подсказки
Visible	Устанавливает режим отображения (видимость) на экране кнопки

    На следующем шаге мы рассмотрим пример создания панели инструментов пользователя.

Предыдущий шаг Содержание Следующий шаг