Application.MacroOptions-Methode (Excel)
Entspricht den Optionen im Dialogfeld Makrooptionen. Sie können diese Methode auch verwenden, um eine benutzerdefinierte Funktion (UDF) in einer integrierten oder neuen Kategorie im Dialogfeld Funktion einfügen anzuzeigen.
Syntax
Ausdruck. MacroOptions (Macro, Description, HasMenu, MenuText, HasShortcutKey, ShortcutKey, Category, StatusBar, HelpContextID, HelpFile, ArgumentDescriptions)
expression Eine Variable, die ein Application-Objekt darstellt.
Parameter
| Name | Erforderlich/Optional | Datentyp | Beschreibung |
|---|---|---|---|
| Macro | Optional | Variant | Der Makroname oder der Name einer benutzerdefinierten Funktion (UDF). |
| Beschreibung | Optional | Variant | Die Beschreibung des Makros. |
| HasMenu | Optional | Variant | Dieses Argument wird ignoriert. |
| MenuText | Optional | Variant | Dieses Argument wird ignoriert. |
| HasShortcutKey | Optional | Variant | Beim Wert True wird dem Makro eine Tastenkombination zugeordnet (ShortcutKey muss ebenfalls angegeben werden). Wenn das Argument den Wert False aufweist, wird dem Makro keine Tastenkombination zugewiesen. Ist diesem Makro bereits eine Tastenkombination zugeordnet, wird diese entfernt, wenn Sie das Argument auf False festlegen. Der Standardwert ist False. |
| ShortcutKey | Optional | Variant | Erforderlich, wenn HasShortcutKeyauf True festgelegt ist. andernfalls ignoriert. Die Tastenkombination. |
| Category | Optional | Variant | Eine ganze Zahl, die eine vorhandene Makro-Funktionskategorie (z. B. Finanzen, Datum und Uhrzeit oder Benutzerdefiniert) angibt. Siehe Abschnitt "Hinweise", um die ganzen Zahlen zu bestimmen, die den integrierten Kategorien zugeordnet sind. Sie können auch eine Zeichenfolge für eine benutzerdefinierte Kategorie angeben. Wenn Sie eine Zeichenfolge angeben, wird sie als Kategoriename behandelt, der im Dialogfeld Funktion einfügen angezeigt wird. Wenn der Kategoriename noch nie verwendet wurde, wird eine neue Kategorie mit diesem Namen definiert. Wenn Sie einen Kategorienamen verwenden, der mit einem integrierten Namen identisch ist (siehe Liste im Abschnitt "Hinweise"), ordnet Excel die benutzerdefinierte Funktion dieser integrierten Kategorie zu. |
| StatusBar | Optional | Variant | Der Statusleistentext des Makros. |
| HelpContextID | Optional | Variant | Eine ganze Zahl, die die Kontext-ID für das Hilfethema angibt, das dem Makro zugeordnet ist. |
| HelpFile | Optional | Variant | Der Name der Hilfedatei, die das durch HelpContextId definierte Hilfethema enthält. |
| ArgumentDescriptions | Optional | Array | Ein eindimensionales Array, das die Beschreibungen der Argumente für eine UDF enthält, die im Dialogfeld Funktionsargumente angezeigt werden. |
Hinweise
Die folgende Tabelle listet die jeweiligen ganzen Zahlen auf, die den integrierten Kategorien zugeordnet sind, die im Category-Parameter verwendet werden können.
| Ganze Zahl | Kategorie |
|---|---|
| 1 | Finanzmathematisch |
| 2 | Datum & Zeit |
| 3 | Math. & Trigonom. |
| 4 | Statistik |
| 5 | Nachschlagen und Verweisen |
| 6 | Datenbank |
| 7 | Text |
| 8 | Logik |
| 9 | Information |
| 10 | Befehle |
| 11 | Benutzerorientiert |
| 12 | Makrosteuerung |
| 13 | DDE/Extern |
| 14 | Benutzerdefiniert |
| 15 | Erste benutzerdefinierte Kategorie |
| 16 | Zweite benutzerdefinierte Kategorie |
| 17 | Dritte benutzerdefinierte Kategorie |
| 18 | Vierte benutzerdefinierte Kategorie |
| 19 | Fünfte benutzerdefinierte Kategorie |
| 20 | Sechste benutzerdefinierte Kategorie |
| 21 | Siebte benutzerdefinierte Kategorie |
| 22 | Achte benutzerdefinierte Kategorie |
| 23 | Neunte benutzerdefinierte Kategorie |
| 24 | Zehnte benutzerdefinierte Kategorie |
| 25 | Elfte benutzerdefinierte Kategorie |
| 26 | Zwölfte benutzerdefinierte Kategorie |
| 27 | Dreizehnte benutzerdefinierte Kategorie |
| 28 | Vierzehnte benutzerdefinierte Kategorie |
| 29 | Fünfzehnte benutzerdefinierte Kategorie |
| 30 | Sechzehnte benutzerdefinierte Kategorie |
| 31 | Siebzehnte benutzerdefinierte Kategorie |
| 32 | Achtzehnte benutzerdefinierte Kategorie |
Beispiel
In diesem Beispiel wird der benutzerdefinierten Kategorie My Custom Category ein benutzerdefiniertes Makro namens TestMacro hinzugefügt. Nachdem Sie dieses Beispiel ausgeführt haben, sollte Meine benutzerdefinierte Kategorie, die die benutzerdefinierte Funktion TestMacro enthält, in der Dropdownliste Oder kategorie auswählen im Dialogfeld Funktion einfügen angezeigt werden.
Function TestMacro()
MsgBox ActiveWorkbook.Name
End Function
Sub AddUDFToCustomCategory()
Application.MacroOptions Macro:="TestMacro", Category:="My Custom Category"
End Sub
Support und Feedback
Haben Sie Fragen oder Feedback zu Office VBA oder zu dieser Dokumentation? Unter Office VBA-Support und Feedback finden Sie Hilfestellung zu den Möglichkeiten, wie Sie Support erhalten und Feedback abgeben können.