SolidWorksMakroprogrammierung

Methode · CommandManager

CreateCommandGroup2-Methode (CommandManager)

Legt eine neue Befehlsgruppe an, also ein Menü und eine Symbolleiste des Add-ins.

Syntax

Function CreateCommandGroup2( _
   ByVal UserID As Long, _
   ByVal Title As String, _
   ByVal ToolTip As String, _
   ByVal Hint As String, _
   ByVal Position As Long, _
   ByVal IgnorePreviousVersion As Boolean, _
   ByRef Errors As Long _
) As CommandGroup
Set swCmdGrp = swCmdMgr.CreateCommandGroup2(10, "Werkzeuge", "Eigene Werkzeuge", "", -1, True, nFehler)

Parameter

UserIDLongByVal
Eine eigene, eindeutige ID für die Gruppe.
TitleStringByVal
Der Name der Gruppe. Mit übergeordnetem Menü, etwa "&Help/Meine Hilfe", landet der Eintrag in diesem Menü (siehe Bemerkungen).
ToolTipStringByVal
Die QuickInfo der Gruppe.
HintStringByVal
Der Text in der Statusleiste, wenn der Mauszeiger auf der Gruppe steht.
PositionLongByVal
Die Stelle im CommandManager für alle Dokumentarten: 0 am Anfang, -1 am Ende.
IgnorePreviousVersionBooleanByVal
True: gespeicherte Anpassungen und Symbolleisten-Daten vorher löschen. False: nicht.
ErrorsLongByRef · Rückgabe
Gibt einen Wert aus swCreateCommandGroupErrors zurück.

Rückgabewert

Die neue Befehlsgruppe (CommandGroup).

Beispiel

' Im Add-in, in ConnectToSW: swCmdMgr ist der CommandManager.
Dim swCmdGrp As SldWorks.CommandGroup
Dim nFehler As Long
Set swCmdGrp = swCmdMgr.CreateCommandGroup2(10, "Werkzeuge", "Eigene Werkzeuge", "", -1, True, nFehler)
If nFehler <> swCreateCommandGroup_Success Then Debug.Print "Fehler " & nFehler

Bemerkungen

Vorher rufst du CommandManager.GetGroupDataFromRegistry auf, um zu entscheiden, wie du IgnorePreviousVersion setzt. Mit True speichert SOLIDWORKS die aktuellen Symbolleisten-Einstellungen nicht in der Registry. Änderst du die Befehle einer vorhandenen Gruppe, gibst du ihr eine neue, eindeutige UserID.

Ohne übergeordnetes Menü im Titel steht der Eintrag im Menü Extras unter „Xpress Products“. In Visual Basic trennst du Menü und Eintrag mit /, in C++ und C# mit einem Backslash (im Quelltext \\). Die Stelle für einzelne Dokumentarten legst du mit CommandGroup.MenuPosition fest.

Aus einem Makro heraus liefert SldWorks.GetCommandManager Nothing; Befehlsgruppen gibt es nur in einem Add-in.

Siehe auch

Verfügbarkeit

SOLIDWORKS 2011

Englisches Original: ICommandManager::CreateCommandGroup2 in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)

Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.