SolidWorksMakroprogrammierung

Objekt · SldWorks

Mouse-Objekt

Die Maus einer Modellansicht: Ein Makro bewegt damit den Mauszeiger, klickt und zoomt mit dem Mausrad, und ein Klassenmodul reagiert auf Mausereignisse.

Deklaration Dim x As SldWorks.Mouse · in der englischen .NET-Hilfe: IMouse

Beschreibung

Mouse gibt Zugriff auf die Maus in einer Modellansicht. Ein Makro erzeugt damit Mausereignisse im Grafikbereich, als hätte der Anwender die Maus benutzt: Zeiger bewegen, Tasten drücken und loslassen, mit dem Mausrad zoomen. Das Hilfebeispiel „Run SOLIDWORKS Commands and Synthesize Mouse Events“ verbindet das mit Befehlen, die es mit ModelDocExtension.RunCommand startet. Move und MoveXYZ gibt es seit SOLIDWORKS 2007, MouseWheelXYZ seit SOLIDWORKS 2009.

Dazu hat Mouse Ereignisse, die SOLIDWORKS bei Mausaktionen in der Ansicht auslöst: für das Drücken, Loslassen und Doppelklicken der linken, rechten und mittleren Taste (etwa MouseLBtnDownNotify), für die Bewegung (MouseMoveNotify), für eine Auswahl mit der Maus (MouseSelectNotify) und ein allgemeines MouseNotify. In VBA nutzt du sie über eine Variable mit WithEvents in einem Klassenmodul. Für die Ereignisse gibt es hier noch keine eigenen Seiten, ihre Kennungen stehen in swMouseNotify_e.

Zugriff

Beispiel

' Klickt mit der linken Maustaste an einen Punkt im Modell und zoomt an derselben Stelle
' mit dem Mausrad eine Stufe hinein.
' Vorbedingung: Ein Teil oder eine Baugruppe ist offen und im Grafikbereich zu sehen.
'               Den Punkt (Modellkoordinaten in Metern) passt du an dein Modell an.
' Ergebnis:     SOLIDWORKS erhält den Klick wie von der Maus und wählt aus, was
'               dort liegt. Die Zahl der ausgewählten Elemente und der Maßstab vor und nach
'               dem Zoomen stehen im Direktfenster (Strg+G).
Option Explicit

' Werte aus swMouse_e (Bibliothek swcommands), hier als Zahlen
Const MAUS_LINKS_AB As Long = 2                 ' swMouse_LeftDown
Const MAUS_LINKS_AUF As Long = 4                ' swMouse_LeftUp
Const MAUS_RECHTS_AUF As Long = 16              ' swMouse_RightUp, wie im Hilfebeispiel zu MouseWheelXYZ

Sub main()
    Dim swApp As SldWorks.SldWorks
    Dim swModel As SldWorks.ModelDoc2
    Dim swModelView As SldWorks.ModelView
    Dim swMouse As SldWorks.Mouse
    Dim x As Double, y As Double, z As Double

    Set swApp = Application.SldWorks
    Set swModel = swApp.ActiveDoc
    If swModel Is Nothing Then Exit Sub
    Set swModelView = swModel.ActiveView
    If swModelView Is Nothing Then Exit Sub
    Set swMouse = swModelView.GetMouse

    x = 0.03: y = 0.02: z = 0.05
    swModel.ClearSelection2 True
    If False = swMouse.MoveXYZ(x, y, z, MAUS_LINKS_AB) Then Debug.Print "MoveXYZ fehlgeschlagen"
    swMouse.Move 0, 0, MAUS_LINKS_AUF
    Debug.Print "Ausgewählt: " & swModel.SelectionManager.GetSelectedObjectCount2(-1)

    Debug.Print "Maßstab vorher:  " & swModelView.Scale2
    swMouse.MouseWheelXYZ x, y, z, -120, MAUS_RECHTS_AUF       ' -120: eine Stufe hinein
    Debug.Print "Maßstab nachher: " & swModelView.Scale2
End Sub

Bemerkungen

Flags: Was die Maus tut, legst du mit dem Parameter Flags fest, einem Wert aus swMouse_e. Diese Enumeration steht nicht in SwConst, sondern in der Bibliothek swcommands. Für die Methoden brauchst du einen Verweis auf diese Bibliothek, unter Extras > Verweise „SOLIDWORKS <Version> Commands type library“. Die Beispiele hier setzen stattdessen die Zahlen als eigene Konstanten, so laufen sie auch ohne den Verweis. Werte kombinierst du durch Addition. Die Werte zum Bewegen und Klicken:

  • swMouse_MouseMove (1): Zeiger bewegen
  • swMouse_LeftDown (2) und swMouse_LeftUp (4): linke Taste drücken und loslassen
  • swMouse_RightDown (8) und swMouse_RightUp (16): rechte Taste
  • swMouse_MiddleDown (32) und swMouse_MiddleUp (64): mittlere Taste
  • swMouse_Wheel (128): dem Namen nach das Mausrad
  • swMouse_Absolute (256): dem Namen nach absolute Fensterkoordinaten
  • swMouse_Click (512), swMouse_DoubleClick (1024), swMouse_RightClick (2048), swMouse_RightDoubleClick (4096) und swMouse_MiddleDoubleClick (8192, „Zoom to fit“)

Dazu kommen Werte wie swMouse_SelectFACES oder swMouse_SelectEDGES, die die Auswahl mit der Maus auf eine Art von Elementen beschränken. Wie du sie mit den übrigen Werten verbindest, sagt die Hilfe nicht.

Koordinaten: Mouse.Move arbeitet im Fenster: Der Ursprung ist die linke obere Ecke, x zeigt nach rechts, y nach unten. Mouse.MoveXYZ und Mouse.MouseWheelXYZ arbeiten im Koordinatensystem des Modells. Eine Einheit nennt die Hilfe dafür nicht. Es sind Meter (MoveXYZ mit (0; 0,02; 0,02) und gedrückter linker Taste wählte die Oberseite eines 40 mm hohen Quaders um den Ursprung genau an diesem Punkt aus).

Hilfebeispiel: „Run SOLIDWORKS Commands and Synthesize Mouse Events“ ruft Move zuerst mit swMouse_Absolute + swMouse_MouseMove + swMouse_LeftDown an der Stelle (50, 150) auf, dann fünfmal mit (5, 5) und swMouse_MouseMove, schließlich mit (0, 0) und swMouse_LeftUp. Danach drückt es die linke Taste mit MoveXYZ an einem Modellpunkt und wiederholt die Bewegung. In den Schleifen ruft es DoEvents auf. Ein Klassenmodul gibt dabei die Ereignisse MouseSelectNotify und MouseLBtnDownNotify im Direktfenster aus.

Mouse.MouseWheelXYZ kann wirkungslos bleiben: Der Maßstab der Ansicht ändert sich danach nicht.

Eigenschaften, Methoden und Ereignisse

Methoden 3, davon 3 beschrieben

NameBeschreibung
MouseWheelXYZZoomt an einem Punkt im Modell mit dem Mausrad hinein oder heraus.
MoveBewegt den Mauszeiger im Fenster der Ansicht und drückt oder löst dabei Maustasten, je nach Flags.
MoveXYZBewegt den Mauszeiger an einen Punkt im Modell und drückt oder löst dabei Maustasten, je nach Flags.

Ereignisse 12, davon 0 beschrieben

NameBeschreibung
MouseLBtnDblClkNotifyNoch nicht beschrieben
MouseLBtnDownNotifyNoch nicht beschrieben
MouseLBtnUpNotifyNoch nicht beschrieben
MouseMBtnDblClkNotifyNoch nicht beschrieben
MouseMBtnDownNotifyNoch nicht beschrieben
MouseMBtnUpNotifyNoch nicht beschrieben
MouseMoveNotifyNoch nicht beschrieben
MouseNotifyNoch nicht beschrieben
MouseRBtnDblClkNotifyNoch nicht beschrieben
MouseRBtnDownNotifyNoch nicht beschrieben
MouseRBtnUpNotifyNoch nicht beschrieben
MouseSelectNotifyNoch nicht beschrieben

Siehe auch

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

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