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.
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
ModelView.GetMouse: die Maus einer Modellansicht, etwa der aktiven ausModelDoc2.ActiveView
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 SubBemerkungen
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
| Name | Beschreibung |
|---|---|
| MouseWheelXYZ | Zoomt an einem Punkt im Modell mit dem Mausrad hinein oder heraus. |
| Move | Bewegt den Mauszeiger im Fenster der Ansicht und drückt oder löst dabei Maustasten, je nach Flags. |
| MoveXYZ | Bewegt den Mauszeiger an einen Punkt im Modell und drückt oder löst dabei Maustasten, je nach Flags. |
Ereignisse 12, davon 0 beschrieben
| Name | Beschreibung |
|---|---|
| MouseLBtnDblClkNotify | Noch nicht beschrieben |
| MouseLBtnDownNotify | Noch nicht beschrieben |
| MouseLBtnUpNotify | Noch nicht beschrieben |
| MouseMBtnDblClkNotify | Noch nicht beschrieben |
| MouseMBtnDownNotify | Noch nicht beschrieben |
| MouseMBtnUpNotify | Noch nicht beschrieben |
| MouseMoveNotify | Noch nicht beschrieben |
| MouseNotify | Noch nicht beschrieben |
| MouseRBtnDblClkNotify | Noch nicht beschrieben |
| MouseRBtnDownNotify | Noch nicht beschrieben |
| MouseRBtnUpNotify | Noch nicht beschrieben |
| MouseSelectNotify | Noch 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.