SolidWorksMakroprogrammierung

Objekt · SldWorks

DragOperator-Objekt

Zieht Komponenten einer Baugruppe per Makro wie mit „Komponente verschieben“: Verschieben und Drehen in Schritten, mit Kollisionserkennung und dynamischem Abstand.

Deklaration Dim x As SldWorks.DragOperator · in der englischen .NET-Hilfe: IDragOperator

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

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 Sub

Bemerkungen

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

NameBeschreibung
ApplyToThisConfigurationLiest oder setzt, ob die Bewegung der Komponenten nur für die aktive Konfiguration oder für alle Konfigurationen gilt.
ClearanceLiefert den Abstand zwischen den Komponenten eines Abstandspaars.
CollisionDetectionEnabledLiest oder setzt, ob beim Ziehen Kollisionen erkannt werden.
DragCorrectedLiefert, ob SOLIDWORKS den letzten Schritt von Drag korrigiert hat, weil die gewünschte Lage nicht möglich war.
DragModeLiest oder setzt, wie die Geometrie beim Ziehen nachgeführt wird: möglichst starr, möglichst wenig, durch Relaxation oder ohne Weitergabe.
DynamicClearanceEnabledLiest oder setzt, ob beim Ziehen der dynamische Abstand überwacht wird.
GraphicsRedrawEnabledLiest oder setzt, ob SOLIDWORKS die Grafik nach dem Bewegen der Komponenten neu zeichnet.
HearClashesLiest oder setzt, ob bei einer Kollision ein Ton erklingt.
HighlightClashesLiest oder setzt, ob Kollisionen hervorgehoben werden.
IgnoreComplexSurfacesLiest oder setzt, ob komplexe Flächen ignoriert werden.
IsDragByRayLiest oder setzt, ob beim Ziehen mit der Maus entlang eines Strahls statt mit einer Transformation gezogen wird.
IsDragSpecificLiest oder setzt, ob „drag specific“ oder „drag possible“ gilt.
IsRelaxationEvalLiest oder setzt, ob die Verknüpfungen beim Ziehen durch Relaxation oder auf die übliche Weise ausgewertet werden.
SmartMatingLiest oder setzt, ob beim Ziehen SmartMates entstehen.
TransformTypeLiest oder setzt, welche Art von Transformation beim Ziehen gilt: nur Verschiebung, nur Drehung um eine Achse oder beides.
UseAbsoluteTransformLiest oder setzt, ob die Transformationen für Drag absolut oder relativ gelten.

Methoden 9, davon 9 beschrieben

NameBeschreibung
AddComponentNimmt eine Komponente in die Liste der Komponenten auf, die gezogen werden.
AddDynamicClearanceLegt einen dynamischen Abstand zwischen zwei Komponenten fest, der beim Ziehen überwacht wird.
BeginDragStartet den Ziehvorgang.
CollisionDetectionLegt fest, zwischen welchen Komponenten beim Ziehen Kollisionen erkannt werden und ob die Bewegung bei Berührung anhält.
DragFührt einen Schritt des Ziehvorgangs mit einer Transformation aus, genau und mit dem Löser der Verknüpfungen.
DragAsUIFührt einen Schritt des Ziehvorgangs so aus wie das Ziehen mit der Maus, weniger genau als Drag.
EndDragBeendet den Ziehvorgang.
GetDragPointLiefert den Punkt, an dem die Komponenten gezogen werden.
SetDragPointSetzt 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.