AddCommand method (ICommandBar)

Добавляет команду на панель инструментов.

Применяется к:

ICommandBar

Синтаксис:

Visual Basic:

Function AddCommand(Command As Variant, Pos As Integer) As Boolean

Command - числовой идентификатор команды или объект ICommand.

Pos - целое число; на место кнопки не влияет.

Описание:

Команду берут из набора Commands объекта Zulu: метод принимает ее числовой идентификатор (свойство ID) или сам объект ICommand, который возвращает метод Item. В макросах на python объект команды метод не принимает и возвращает False: там команду задают только идентификатором.

Кнопки встают на панель в порядке вызовов, каждая следующая — после уже добавленных, независимо от значения Pos. Если у команды нет значка, на кнопке выводится ее название.

Метод возвращает True и тогда, когда команды с таким идентификатором в наборе нет; кнопка в этом случае не появляется.

Добавленные кнопки появляются на панели не сразу, а при ее перерисовке, например после следующего вызова AddCommandBar.

Пример:

Visual Basic:

Sub ICommandBar_AddCommand
'Набор панелей инструментов и набор команд
Set CB = Zulu.CommandBars
Set C = Zulu.Commands
'Создаем свою панель
Set bar = CB.AddCommandBar("Моя панель", "Моя панель")
'Команда задается числовым идентификатором
s = "Открыть по идентификатору: " & bar.AddCommand(C.Item("FileOpen").ID, 0) & vbCrLf
'или объектом команды
s = s & "Сохранить объектом команды: " & bar.AddCommand(C.Item("FileSave"), 0)
MsgBox s
End Sub

Python:

import zulu

def Macro_ICommandBar_AddCommand():
    # Набор панелей инструментов и набор команд
    CB = zulu.App.CommandBars
    C = zulu.App.Commands
    # Создаем свою панель
    bar = CB.AddCommandBar("Моя панель", "Моя панель")
    # В python команда задается числовым идентификатором
    print("Открыть:", bar.AddCommand(C.Item("FileOpen").ID, 0))
    print("Сохранить:", bar.AddCommand(C.Item("FileSave").ID, 0))