Метод Application.MacroOptions (Excel)

Соответствует параметрам в диалоговом окне "Параметры макроса ". Кроме того, с помощью этого метода можно отобразить пользовательскую функцию (UDF) во встроенной или новой категории в диалоговом окне "Вставка функции ".

Синтаксис

выражение. MacroOptions (Macro, Description, HasMenu, MenuText, HasShortcutKey, ShortcutKey, Category, StatusBar, HelpContextID,HelpFile, ArgumentDescriptions)

выражение: переменная, представляющая объект Application.

Параметры

Имя	Обязательный или необязательный	Тип данных	Описание
Macro	Необязательный	Variant	Имя макроса или пользовательской функции (UDF).
Описание	Необязательный	Variant	Описание макроса.
HasMenu	Необязательный	Variant	Этот аргумент игнорируется.
Текст меню	Необязательный	Variant	Этот аргумент игнорируется.
HasShortcutKey	Необязательный	Variant	True , чтобы назначить макросу сочетание клавиш (также необходимо указать ShortcutKey ). Если этот аргумент имеет значение False, макросу не назначается сочетание клавиш. Если в макросе уже есть сочетания клавиш, если для этого аргумента задать значение False , эта клавиша будет удалена. Значение по умолчанию — False.
ShortcutKey	Необязательный	Variant	Обязательный, если HasShortcutKey имеет значение True; в противном случае игнорируется. Сочетание клавиш.
Категория	Необязательный	Variant	Целое число, определяющее существующую категорию функции макроса (например, "Финансовая", "Дата & время" или "Определенная пользователем"). См. раздел "Замечания", чтобы определить целые числа, сопоставленные со встроенными категориями. Можно также указать строку для настраиваемой категории. Если указана строка, она рассматривается как имя категории, отображаемой в диалоговом окне "Вставка функции ". Если имя категории никогда не использовалось, определяется новая категория с этим именем. Если используется имя категории, совпадающее со встроенным именем (см. список в разделе "Замечания"), пользовательская функция сопоставляется с этой встроенной категорией.
StatusBar	Необязательный	Variant	Текст макроса в строке состояния.
HelpContextID	Optional	Variant	Целое число, определяющее идентификатор контекста раздела справки, назначенного макросу.
HelpFile	Optional	Variant	Имя файла справки, который содержит раздел справки, определенный HelpContextId.
ArgumentDescriptions	Необязательный	Array	Одномерный массив, содержащий описания аргументов пользовательской функции, отображаемых в диалоговом окне "Аргументы функции ".

Примечания

В следующей таблице перечислены целые числа, сопоставленные со встроенными категориями, которые можно использовать в параметре Category .

Integer	Категория
1	Финансовые
2	Дата & время
3	Математические & тригонометрические представления
4	Статистические функции
5	Справочные материалы по & поиска
6	База данных
7	Text
8	Логическая
9	Information
10	Команды
11	Настройка
12	Управление макросами
13	DDE/внешний
14	Определяется пользователем
15	Первая настраиваемая категория
16	Вторая настраиваемая категория
17	Третья настраиваемая категория
18	Четвертая настраиваемая категория
19	Пятая настраиваемая категория
20	Шестая пользовательская категория
21	Седьмая настраиваемая категория
22	Восьмая пользовательская категория
23	Девятая пользовательская категория
24	Десятая настраиваемая категория
25	Одиннадцатая настраиваемая категория
26	Двенадцатая пользовательская категория
27	Тринадцатая пользовательская категория
28	Четырнадцатая пользовательская категория
29	Пятнадцатая настраиваемая категория
30	Шестнадцатая пользовательская категория
31	Семнадцатая пользовательская категория
32	Восемнадцатая пользовательская категория

Пример

В этом примере пользовательский макрос TestMacro добавляется в настраиваемую категорию с именем "Моя настраиваемая категория". После выполнения этого примера вы увидите Моя настраиваемая категория, содержащая пользовательскую функцию TestMacro, в раскрывающемся списке Или выберите категорию в диалоговом окне Вставка функции .

Function TestMacro() 
    MsgBox ActiveWorkbook.Name 
End Function 
 
Sub AddUDFToCustomCategory() 
    Application.MacroOptions Macro:="TestMacro", Category:="My Custom Category" 
End Sub

Поддержка и обратная связь

Есть вопросы или отзывы, касающиеся Office VBA или этой статьи? Руководство по другим способам получения поддержки и отправки отзывов см. в статье Поддержка Office VBA и обратная связь.