Application.MacroOptions-Methode (Excel)

  • Artikel

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.