Возвращает команду по номеру или по имени.

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

ICommands

Синтаксис:

Visual Basic:

Function Item(index As Variant) As ICommand

index - номер команды в наборе или её имя.

Описание:

Команды нумеруются с единицы. Допустимы номера с 1 по Count - 1; для номера 0 и для номера Count метод возвращает Nothing.

Имя команды сравнивается с учётом регистра: FileOpen находится, fileopen — уже нет.

Если команды с таким именем нет, метод возвращает не Nothing, а объект-заглушку: у неё Name — пустая строка, а ID равен -1. Проверять результат надо именно по ID = -1.

Пример:

Visual Basic:

Sub ICommands_Item
Set C = Zulu.Commands
'По номеру
Set cmd = C.Item(1)
s = "По номеру 1: " & cmd.Name & vbCrLf
'По имени, регистр важен
Set cmd = C.Item("FileSave")
s = s & "По имени FileSave: ID " & cmd.ID & vbCrLf
'Несуществующее имя дает заглушку, а не Nothing
Set cmd = C.Item("НетТакой")
s = s & "Несуществующая: ID " & cmd.ID & ", имя '" & cmd.Name & "'"
MsgBox s
End Sub

Python:

import zulu

def Macro_ICommands_Item():
    C = zulu.App.Commands
    # По номеру
    print("По номеру 1:", C.Item(1).Name)
    # По имени, регистр важен
    print("По имени FileSave: ID", C.Item("FileSave").ID)
    # Несуществующее имя дает заглушку, а не None
    cmd = C.Item("НетТакой")
    print("Несуществующая: ID", cmd.ID, ", имя", repr(cmd.Name))