Метод Application.MacroOptions (Excel)
Соответствует параметрам в диалоговом окне Параметры макросов . Этот метод также можно использовать для отображения определяемой пользователем функции (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 и обратная связь.