Метод Application.MacroOptions (Excel)

Статья
04/07/2023

Соответствует параметрам в диалоговом окне Параметры макросов . Этот метод также можно использовать для отображения определяемой пользователем функции (UDF) во встроенной или новой категории в диалоговом окне Вставка функции .

Синтаксис

expression. MacroOptions (Macro, Description, HasMenu, MenuText, HasShortcutKey, ShortcutKey, Category, StatusBar, HelpContextID, HelpFile, ArgumentDescriptions)

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

Параметры

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

Замечания

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

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

Пример

В этом примере в настраиваемую категорию с именем My Custom Category добавляется определяемый пользователем макрос с именем 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 и обратная связь.