SolidWorksMakroprogrammierung

Methode · Frame

AddMenuPopupItem2-Methode (Frame)

Fügt einem Kontextmenü (Rechtsklick) einen Eintrag oder eine Trennlinie hinzu. Nur für C++-Anwendungen als DLL.

Syntax

Function AddMenuPopupItem2( _
   ByVal DocType As Long, _
   ByVal SelectType As Long, _
   ByVal Item As String, _
   ByVal CallbackFcnAndModule As String, _
   ByVal CustomNames As String, _
   ByVal Unused As Long, _
   ByVal BitmapFileName As String _
) As Boolean
bOk = swFrame.AddMenuPopupItem2(DocType, SelectType, Item, CallbackFcnAndModule, CustomNames, Unused, BitmapFileName)

Parameter

DocTypeLongByVal
Dokumentart, deren Kontextmenü den Eintrag bekommt, vermutlich ein Wert aus swDocumentTypes_e.
SelectTypeLongByVal
Auswahlart, deren Kontextmenü den Eintrag bekommt, vermutlich ein Wert aus swSelectType_e.
ItemStringByVal
Text des Eintrags. Leer, um eine Trennlinie einzufügen.
CallbackFcnAndModuleStringByVal
Die Funktion, die beim Klick aufgerufen wird, im Format "dllname@function@updatefunction,hintstring" wie bei Frame.AddMenuItem2.
CustomNamesStringByVal
Nur bei eigenen Feature-Arten wie swSelATTRIBUTES: die Namen der Arten, durch Semikolon getrennt, bei Attributen der Name der Attributdefinition. Sonst leer.
UnusedLongByVal
Für später reserviert, 0 übergeben.
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.AddMenuPopupItem2(swDocPART, swSelFACES, "Fläche prüfen", _
    "Userdll@PruefeFlaeche@PruefeAktiv,Fläche prüfen", "", 0, "")

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. Wie bei Frame.AddMenuItem2 fügst du den Eintrag einem der vier Rahmen hinzu (Hauptrahmen, Teil, Baugruppe, Zeichnung) und holst dafür das Frame-Objekt, während der gewünschte Rahmen aktiv ist. Für ein Aufklappmenü in der Menüleiste nimmst du Frame.AddMenu.

Die Teile von CallbackFcnAndModule (dllname, function, updatefunction mit den Rückgabewerten 0 bis 3, hintstring mit Komma davor) beschreibt die Hilfe wie bei Frame.AddMenuItem2. Für Add-ins in anderen Sprachen gibt es SldWorks.AddMenuPopupItem3. Der Befehl ersetzt den veralteten Befehl AddMenuPopupItem.

Siehe auch

Verfügbarkeit

SOLIDWORKS 2009

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

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