Objekt · SldWorks
DragOperator-Objekt
Zieht Komponenten einer Baugruppe per Makro wie mit „Komponente verschieben“: Verschieben und Drehen in Schritten, mit Kollisionserkennung und dynamischem Abstand.
Beschreibung
DragOperator gibt Zugriff auf die Einstellungen des Befehls „Komponente verschieben“ (Move Components) in SOLIDWORKS. Du gibst die Komponenten an, startest den Ziehvorgang, bewegst sie Schritt für Schritt mit einer Transformation (MathTransform) und beendest den Vorgang. Das ist der bevorzugte Weg, eine Komponente zu bewegen, weil dabei alle Verknüpfungen und Beziehungen im Kontext beachtet werden. Die meisten Befehle gibt es seit SOLIDWORKS 2001Plus, DragAsUI seit SOLIDWORKS 2004, DragCorrected und UseAbsoluteTransform seit SOLIDWORKS 2004 SP03, GraphicsRedrawEnabled seit SOLIDWORKS 2004 SP04.
Zugriff
AssemblyDoc.GetDragOperator: liefert den DragOperator der Baugruppe
Beispiel
' Dreht die ausgewählte Komponente in 90 Schritten zu je 1° um die
' X-Achse der Baugruppe, wie das Hilfebeispiel.
' Vorbedingung: Eine Baugruppe ist offen, eine frei bewegliche (nicht
' fixierte) Komponente ist ausgewählt.
' Ergebnis: Die Komponente dreht sich sichtbar um 90°, soweit die
' Verknüpfungen das zulassen.
Option Explicit
Sub main()
Const PI As Double = 3.14159265358979
Dim swApp As SldWorks.SldWorks
Dim swModel As SldWorks.ModelDoc2
Dim swAssy As SldWorks.AssemblyDoc
Dim swSelMgr As SldWorks.SelectionMgr
Dim swComp As SldWorks.Component2
Dim swDrag As SldWorks.DragOperator
Dim swMathUtil As SldWorks.MathUtility
Dim swPunkt As SldWorks.MathPoint
Dim swAchse As SldWorks.MathVector
Dim swDrehung As SldWorks.MathTransform
Dim dWerte(2) As Double
Dim vWerte As Variant
Dim i As Long
Set swApp = Application.SldWorks
Set swModel = swApp.ActiveDoc
If swModel Is Nothing Then Exit Sub
If swModel.GetType <> swDocASSEMBLY Then Exit Sub
Set swAssy = swModel
Set swSelMgr = swModel.SelectionManager
Set swComp = swSelMgr.GetSelectedObjectsComponent4(1, -1)
If swComp Is Nothing Then
Debug.Print "Bitte eine Komponente auswählen."
Exit Sub
End If
' Drehung um 1° um die X-Achse durch den Ursprung
Set swMathUtil = swApp.GetMathUtility
dWerte(0) = 0#: dWerte(1) = 0#: dWerte(2) = 0#
vWerte = dWerte
Set swPunkt = swMathUtil.CreatePoint(vWerte)
dWerte(0) = 1#
vWerte = dWerte
Set swAchse = swMathUtil.CreateVector(vWerte)
Set swDrehung = swMathUtil.CreateTransformRotateAxis(swPunkt, swAchse, 1# * PI / 180#)
Set swDrag = swAssy.GetDragOperator
If False = swDrag.AddComponent(swComp, False) Then
Debug.Print "Die Komponente lässt sich nicht ziehen (fixiert?)."
Exit Sub
End If
swDrag.CollisionDetectionEnabled = False
swDrag.DynamicClearanceEnabled = False
swDrag.TransformType = 1 ' nur Drehung um eine Achse
swDrag.DragMode = 2 ' Lösen durch Relaxation
swDrag.UseAbsoluteTransform = False ' jeder Schritt dreht um 1° weiter
If False = swDrag.BeginDrag Then Exit Sub
For i = 1 To 90
If False = swDrag.Drag(swDrehung) Then
Debug.Print "Schritt " & i & " nicht möglich."
Exit For
End If
DoEvents
Next i
swDrag.EndDrag
End SubBemerkungen
Hilfebeispiele: „Rotate Assembly Component on Axis Using IDragOperator::Drag“ öffnet die Baugruppe assem2.sldasm, wählt eine Komponente aus und dreht sie wie oben in 91 Schritten zu je 1°, mit einer Pause von 0,1 s nach jedem Schritt. „… Using IDragOperator::DragAsUI“ macht dasselbe mit DragOperator.DragAsUI in 501 Schritten. Beide setzen die Transformation mit MathUtility.CreateTransformRotateAxis auf und verwenden sie in jedem Schritt wieder, weil sie relativ ist.
Ablauf: Komponenten mit DragOperator.AddComponent angeben, Einstellungen setzen, DragOperator.BeginDrag, beliebig oft DragOperator.Drag oder DragOperator.DragAsUI, zum Schluss DragOperator.EndDrag. Danach musst du unter Umständen ModelDoc2.EditRebuild3 aufrufen, damit die Geometrie des Modells aktualisiert wird.
Drag oder DragAsUI: DragOperator.Drag ist genauer, DragOperator.DragAsUI verhält sich eher wie das Ziehen mit der Maus und zeichnet unter Umständen schneller. Beide liefern False, wenn der Schritt nicht möglich ist, meist wegen einer Kollision. Nur Drag setzt DragOperator.DragCorrected.
Kollisionserkennung: Die Hilfe widerspricht sich, ob DragOperator.Drag Kollisionen erkennt. Auf der Seite von Drag steht, dass bei eingeschalteter Kollisionserkennung oder eingeschaltetem dynamischem Abstand der langsamere ursprüngliche Modus verwendet wird. Auf der Seite von Component2.SetTransformAndSolve3 steht dagegen, dass Drag Kollisionserkennung und dynamischen Abstand nicht unterstützt. Prüf das im eigenen Modell.
Werte ohne Konstanten: Für DragOperator.DragMode und DragOperator.TransformType gibt es keine Enumeration, du setzt Zahlen. Bei DragMode weicht ein Kommentar im Hilfebeispiel zu DragAsUI von der Seite der Eigenschaft ab (siehe dort).
Einheiten: Für Abstände und Koordinaten nennt die Hilfe keine Einheit. Die Verschiebung der Transformation ist in Metern, für die übrigen Werte vermutlich ebenso.
In SOLIDWORKS 2024 bleiben die Einstellungen des DragOperator auch nach dem Schließen und erneuten Öffnen der Baugruppe erhalten.
Eigenschaften und Methoden
Eigenschaften 16, davon 16 beschrieben
| Name | Beschreibung |
|---|---|
| ApplyToThisConfiguration | Liest oder setzt, ob die Bewegung der Komponenten nur für die aktive Konfiguration oder für alle Konfigurationen gilt. |
| Clearance | Liefert den Abstand zwischen den Komponenten eines Abstandspaars. |
| CollisionDetectionEnabled | Liest oder setzt, ob beim Ziehen Kollisionen erkannt werden. |
| DragCorrected | Liefert, ob SOLIDWORKS den letzten Schritt von Drag korrigiert hat, weil die gewünschte Lage nicht möglich war. |
| DragMode | Liest oder setzt, wie die Geometrie beim Ziehen nachgeführt wird: möglichst starr, möglichst wenig, durch Relaxation oder ohne Weitergabe. |
| DynamicClearanceEnabled | Liest oder setzt, ob beim Ziehen der dynamische Abstand überwacht wird. |
| GraphicsRedrawEnabled | Liest oder setzt, ob SOLIDWORKS die Grafik nach dem Bewegen der Komponenten neu zeichnet. |
| HearClashes | Liest oder setzt, ob bei einer Kollision ein Ton erklingt. |
| HighlightClashes | Liest oder setzt, ob Kollisionen hervorgehoben werden. |
| IgnoreComplexSurfaces | Liest oder setzt, ob komplexe Flächen ignoriert werden. |
| IsDragByRay | Liest oder setzt, ob beim Ziehen mit der Maus entlang eines Strahls statt mit einer Transformation gezogen wird. |
| IsDragSpecific | Liest oder setzt, ob „drag specific“ oder „drag possible“ gilt. |
| IsRelaxationEval | Liest oder setzt, ob die Verknüpfungen beim Ziehen durch Relaxation oder auf die übliche Weise ausgewertet werden. |
| SmartMating | Liest oder setzt, ob beim Ziehen SmartMates entstehen. |
| TransformType | Liest oder setzt, welche Art von Transformation beim Ziehen gilt: nur Verschiebung, nur Drehung um eine Achse oder beides. |
| UseAbsoluteTransform | Liest oder setzt, ob die Transformationen für Drag absolut oder relativ gelten. |
Methoden 9, davon 9 beschrieben
| Name | Beschreibung |
|---|---|
| AddComponent | Nimmt eine Komponente in die Liste der Komponenten auf, die gezogen werden. |
| AddDynamicClearance | Legt einen dynamischen Abstand zwischen zwei Komponenten fest, der beim Ziehen überwacht wird. |
| BeginDrag | Startet den Ziehvorgang. |
| CollisionDetection | Legt fest, zwischen welchen Komponenten beim Ziehen Kollisionen erkannt werden und ob die Bewegung bei Berührung anhält. |
| Drag | Führt einen Schritt des Ziehvorgangs mit einer Transformation aus, genau und mit dem Löser der Verknüpfungen. |
| DragAsUI | Führt einen Schritt des Ziehvorgangs so aus wie das Ziehen mit der Maus, weniger genau als Drag. |
| EndDrag | Beendet den Ziehvorgang. |
| GetDragPoint | Liefert den Punkt, an dem die Komponenten gezogen werden. |
| SetDragPoint | Setzt den Punkt, an dem die Komponenten gezogen werden. |
Nicht aufgeführt sind 6 C++-Varianten (Namen mit I davor, zum Beispiel IAddComponent). In VBA nimmst du immer den Befehl ohne I.
Siehe auch
Englisches Original: IDragOperator in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)
Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.