SolidWorksMakroprogrammierung

Methode · PropertyManagerPage2

AddMenuPopupItem-Methode (PropertyManagerPage2)

Fügt dem Kontextmenü, solange die PropertyManager-Seite offen ist, einen eigenen Eintrag hinzu.

Syntax

Function AddMenuPopupItem( _
   ByVal ID As Long, _
   ByVal ItemText As String, _
   ByVal DocumentType As Long, _
   ByVal HintText As String _
) As Boolean
bOk = swSeite.AddMenuPopupItem(100, "Alle zurücksetzen", swDocPART, "Setzt alle Werte der Seite zurück")

Parameter

IDLongByVal
Eine eigene Nummer für den Eintrag. Mit ihr melden OnPopupMenuItem und OnPopupMenuItemUpdate, welcher Eintrag gemeint ist.
ItemTextStringByVal
Der Text des Eintrags.
DocumentTypeLongByVal
Für welche Dokumentart der Eintrag erscheint, als Wert aus swDocumentTypes_e, etwa swDocPART.
HintTextStringByVal
Der Text in der Statusleiste, wenn der Mauszeiger über dem Eintrag steht.

Rückgabewert

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

Beispiel

' swSeite ist eine PropertyManager-Seite (PropertyManagerPage2) in einem Teil.
If False = swSeite.AddMenuPopupItem(100, "Alle zurücksetzen", swDocPART, "Setzt alle Werte zurück") Then
    Debug.Print "Eintrag nicht hinzugefügt"
End If

' Im Klassenmodul des Handlers:
Private Sub PropertyManagerPage2Handler9_OnPopupMenuItem(ByVal Id As Long)
    If Id = 100 Then Debug.Print "Zurücksetzen gewählt"
End Sub

Bemerkungen

Du brauchst dafür zwei Methoden im Handler der Seite:

  • OnPopupMenuItem: SOLIDWORKS meldet, welchen Eintrag der Benutzer gewählt hat. Das Makro führt dann die passende Aktion aus.
  • OnPopupMenuItemUpdate: SOLIDWORKS fragt hier den Zustand des Eintrags ab, etwa ob er aktiv oder angehakt ist, und das Makro gibt ihn im Parameter retval zurück.

Welche Werte retval annimmt und ob du den Befehl vor oder nach dem Anzeigen der Seite aufrufst, sagt die Hilfe nicht. Ob sich mehrere Dokumentarten kombinieren lassen, auch nicht. Die Werte in swDocumentTypes_e sind keine Bitmaske.

Siehe auch

Verfügbarkeit

SOLIDWORKS 2007

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

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