Методы объекта СommandBar

Объект СommandBar имеет несколько методов:

• Delete

• FindControl

• Reset

• ShowPopup

Ниже рассмотрено назначение каждого из перечисленных методов.

Метод Delete

Метод Delete удаляет элемент управления из коллекции CommandBars. Данный метод имеет два варианта синтаксиса:

1.Expression.Delete

2.Expression.Delete(Temporary)

Элементы обоих вариантов синтаксиса метода Delete приведены в табл. 5.7.

Таблица 5.7. Элементы синтаксиса метода Delete

Элемент	Описание
Expression	Обязательный элемент— выражение, которое возвращает объекты CommandBar (Синтаксис 1) или CommandBarControl (Синтаксис 2)
Temporary	Необязательный элемент типа Boolean. Если значение данного параметра равно True, то элемент управления удаляется в текущем сеансе работы, но в следующем будет снова отображен

Метод FindControl

Метод FindControl возвращает объект CommandBarControl, который удовлетворяет определенным критериям, задаваемым параметрами метода FindControl. Синтаксис этого метода имеет вид:

Expression.FindControl(Type, Id, Tag. Visible, Recursive)

Элементы синтаксиса метода FindControl приведены в табл. 5.8.

Таблица 5.8. Элементы синтаксиса метода FindControl

Элемент	Описание
Expression	Обязательный элемент — выражение, которое возвращает объект CommandBar
Туре	Необязательный элемент, определяющий тип элемента управления. Значение данного аргумента может равняться одной из констант, представленных в табл. 5.6
Id	Необязательный элемент типа Variant, выполняющий функцию идентификатора элемента управления
Tag	Необязательный элемент типа Variant. Задает значение свойства Tag элемента управления
Visible	Необязательный элемент типа Variant. По умолчанию данное значение равно False. При задании данному параметру значения True в поиск включаются только видимые элементы управления панели инструментов. Видимые панели команд включают все видимые элементы панели инструментов и любые меню, которые открыты во время выполнения метода FindControl
Recursive	Необязательный элемент типа Boolean. Определяет, включаются (True) или нет (False) в поиск всплывающие панели команд, расположенные на панели команд, к которой применяется метод FindControl. По умолчанию используется значение False

Метод Reset

Метод Reset сбрасывает настройки встроенных панелей команд к исходным настройкам, установленным по умолчанию, или устанавливает оригинальное функционирование и внешний вид элементов управления панели команд. Синтаксис метода Reset:

Expression.Reset

Элемент синтаксиса Expression метода Reset представляет собой выражение, которое возвращает один из следующих объектов: CommandBar, CommandBarControl, CommandBarButton, CommandBarPopup или CommandBarComboBox.

Метод ShowPopup

Метод ShowPopup выводит на экран панель команд как контекстное меню в заданных координатах или в текущей позиции указателя. Если свойство Position панели команд имеет значение, отличное от значения константы msoBarPopup, то этот метод не выполняется. Синтаксис метода ShowPopup:

Еxpression. ShowPopup (X, Y)

Элементы синтаксиса метода ShowPopup приведены в табл. 5.9.

Таблица 5.9. Элементы синтаксиса метода ShowPopup

Элемент	Описание
Expression	Обязательный элемент, представляющий собой выражение, возвращающее объект CommandBar
Х	Необязательный элемент типа Variant, задающий координату .расположения контекстного меню по горизонтали. В случае отсутствия этого параметра используется текущая координата указателя
У	Необязательный элемент типа Variant, задающий координату расположения контекстного меню по вертикали. Если этот параметр отсутствует, то используется текущая координата указателя