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 BooleanbOk = 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, dass1den Eintrag ans Ende hängt, vermutlich ist-1gemeint. 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:
0nicht abgehakt und gesperrt,1nicht abgehakt und aktiv (Vorgabe ohne updatefunction),2abgehakt und gesperrt,3abgehakt 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.