SolidWorksMakroprogrammierung

Methode · Frame

AddMenuPopupIcon3-Methode (Frame)

Fügt in einem Add-in einem Kontextmenü ein Symbol hinzu, mit Bildern in mehreren Größen.

Syntax

Function AddMenuPopupIcon3( _
   ByVal DocType As Long, _
   ByVal SelectType As Long, _
   ByVal HintString As String, _
   ByVal Identifier As Long, _
   ByVal CallbackFunction As String, _
   ByVal CallbackUpdateFunction As String, _
   ByVal CustomNames As String, _
   ByVal ImageList As Variant _
) As Boolean
bOk = swFrame.AddMenuPopupIcon3(DocType, SelectType, HintString, Identifier, CallbackFunction, CallbackUpdateFunction, CustomNames, ImageList)

Parameter

DocTypeLongByVal
Dokumentart, in deren Kontextmenüs das Symbol erscheint, vermutlich ein Wert aus swDocumentTypes_e.
SelectTypeLongByVal
Auswahlart, in deren Kontextmenüs das Symbol erscheint, vermutlich ein Wert aus swSelectType_e.
HintStringStringByVal
Text in der Statusleiste, wenn der Mauszeiger über dem Symbol steht.
IdentifierLongByVal
Kennung des Add-ins, der Wert von Cookie aus SwAddin.ConnectToSW.
CallbackFunctionStringByVal
Name der Funktion, die beim Klick aufgerufen wird.
CallbackUpdateFunctionStringByVal
Optionaler Name einer Funktion für den Zustand des Symbols: 0 nicht ausgewählt und gesperrt, 1 nicht ausgewählt und aktiv (Vorgabe ohne Funktion), 4 ausgeblendet.
CustomNamesStringByVal
Nur bei eigenen Feature-Arten wie swSelATTRIBUTES: die Namen der Arten, durch Semikolon getrennt, bei Attributen der Name der Attributdefinition. Sonst leer.
ImageListVariantByVal
Array mit den Pfaden der Bilddateien für das Symbol in verschiedenen Größen.

Rückgabewert

True, wenn das Symbol hinzugefügt wurde, sonst False.

Beispiel

' In einem Add-in. swFrame ist das Hauptfenster (Frame), etwa aus SldWorks.Frame,
' nCookie der Wert von Cookie aus ConnectToSW.
Dim sBilder(2) As String
Dim vBilder As Variant
sBilder(0) = "C:\Bilder\symbol_20.png"
sBilder(1) = "C:\Bilder\symbol_32.png"
sBilder(2) = "C:\Bilder\symbol_40.png"
vBilder = sBilder
bOk = swFrame.AddMenuPopupIcon3(swDocPART, swSelFACES, "Fläche prüfen", nCookie, _
    "PruefeFlaeche", "PruefeFlaecheAktiv", "", vBilder)

Bemerkungen

Wie du CallbackFunction und CallbackUpdateFunction angibst, beschreibt die Hilfe im Kapitel „Add-in Callback and Enable Methods“. Die Funktion beim Klick kann etwa ein eigenes Kontextmenü zeigen. So macht es das Hilfebeispiel „Add Button to Context-sensitive Menu“ (nur VB.NET und C#): Es legt das Symbol bei Flächen in Teilen an und baut mit SldWorks.RegisterThirdPartyPopupMenu und SldWorks.AddItemToThirdPartyPopupMenu2 ein Kontextmenü dazu.

Der Befehl unterstützt die Skalierung für hochauflösende Bildschirme. Die Bilder in ImageList können 20 × 20, 32 × 32, 40 × 40, 64 × 64, 96 × 96 oder 128 × 128 Pixel groß sein und sollten eine Palette mit 256 Farben haben. Das Hilfebeispiel übergibt drei Bilder. Welche Größen Pflicht sind, sagt die Hilfe nicht. Der Befehl ersetzt den veralteten Befehl AddMenuPopupIcon2.

Siehe auch

Verfügbarkeit

SOLIDWORKS 2016

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

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