SolidWorksMakroprogrammierung

Methode · Frame

AddMenuItem2-Methode (Frame)

Fügt einem vorhandenen Menü einen Eintrag mit Bild oder eine Trennlinie hinzu. Nur für C++-Anwendungen als DLL.

Syntax

Function AddMenuItem2( _
   ByVal Menu As String, _
   ByVal Item As String, _
   ByVal Position As Long, _
   ByVal CallbackFcnAndModule As String, _
   ByVal BitmapFileName As String _
) As Boolean
bOk = swFrame.AddMenuItem2(Menu, Item, Position, CallbackFcnAndModule, BitmapFileName)

Parameter

MenuStringByVal
Name des Menüs, in das der Eintrag kommt.
ItemStringByVal
Text des Eintrags, mit & vor dem Buchstaben der Zugriffstaste. Leer, um eine Trennlinie einzufügen.
PositionLongByVal
Stelle des neuen Eintrags, der erste Eintrag hat die Stelle 0. Die Hilfe gibt an, dass 1 den Eintrag ans Ende hängt, vermutlich ist -1 gemeint.
CallbackFcnAndModuleStringByVal
Die Funktion, die beim Klick aufgerufen wird, im Format "dllname@function@updatefunction,hintstring" (siehe Bemerkungen).
BitmapFileNameStringByVal
Pfad und Name der Bitmap für den Eintrag.

Rückgabewert

True, wenn der Eintrag hinzugefügt wurde, sonst False.

Beispiel

' In einer C++-DLL. swFrame ist der Rahmen für Teile, geholt, als ein Teil aktiv war.
bOk = swFrame.AddMenuItem2("&Werkzeuge", "&Quader", -1, "Userdll@AddBox@checkForUserSelects,Quader anlegen", "")

Bemerkungen

Der Befehl funktioniert nur in C++-Anwendungen, die als DLL umgesetzt sind, nicht als EXE. Jede Rückruffunktion muss als EXPORT deklariert oder in der .def-Datei aufgeführt sein. Du kannst den Eintrag einem der vier Rahmen hinzufügen: Hauptrahmen, Teil, Baugruppe oder Zeichnung. Dazu holst du das Frame-Objekt mit SldWorks.Frame, während der gewünschte Rahmen aktiv ist, etwa wenn ein Teil zum ersten Mal geladen oder angelegt wird. Danach musst du es in der laufenden Sitzung nicht noch einmal tun.

Die Teile von CallbackFcnAndModule:

  • dllname: der Name deiner Bibliothek wie in der .def-Datei, er muss mit dem Dateinamen der DLL übereinstimmen
  • function: die Funktion, die beim Klick aufgerufen wird, als EXPORT deklariert
  • updatefunction: optional, gibt den Zustand des Eintrags als Ganzzahl zurück: 0 nicht abgehakt und gesperrt, 1 nicht abgehakt und aktiv (Vorgabe ohne updatefunction), 2 abgehakt und gesperrt, 3 abgehakt und aktiv
  • hintstring: optional, der Hinweis in der Statusleiste, mit einem Komma davor, etwa "Userdll@AddBox@checkForUserSelects,Add a box"

Für Add-ins in anderen Sprachen gibt es SldWorks.AddMenuItem5. Der Befehl ersetzt die veralteten Befehle AddMenuItem und GetMenuState.

Das Codestück ist für eine C++-DLL gedacht.

Siehe auch

Verfügbarkeit

SOLIDWORKS 2005

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

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