SolidWorksMakroprogrammierung

Objekt · SldWorks

DragArrowManipulator-Objekt

Ein Manipulator in Form eines Ziehpfeils, dessen Länge der Anwender im Grafikbereich durch Ziehen ändert: Ursprung, Richtung, Länge, Gegenrichtung und Lineal.

Deklaration Dim x As SldWorks.DragArrowManipulator · in der englischen .NET-Hilfe: IDragArrowManipulator

Beschreibung

DragArrowManipulator gibt Zugriff auf Ziehpfeile, die in der Oberfläche von SOLIDWORKS „Ziehpunkte“ (handles) heißen. Klickt der Anwender auf den Pfeil und zieht daran, ändert sich die Länge dieses Ziehpfeils. Was dabei passiert, bestimmt dein Programm in einer Klasse, die SwManipulatorHandler2 umsetzt. Die meisten Befehle gibt es seit SOLIDWORKS 2007.

Zugriff

Beispiel

' Legt einen Ziehpfeil an der Stelle an, an der die ausgewählte Fläche angeklickt
' wurde. Er zeigt in +Y, ist 20 mm lang und zeigt beim Ziehen ein Lineal.
' Die Werte stammen aus dem Hilfebeispiel.
' Vorbedingung: Verweis auf die swpublished-Typbibliothek, ein Klassenmodul
'               swDragManipHdlr mit "Implements SwManipulatorHandler2" wie im
'               Hilfebeispiel "Create Drag Arrow Manipulator". Ein Teil oder eine
'               Baugruppe ist offen, eine Fläche ist ausgewählt.
' Ergebnis:     Der Ziehpfeil erscheint auf der Fläche. Ziehen meldet die Klasse.
Option Explicit

Dim swManip As SldWorks.Manipulator
Dim swZiehpfeil As SldWorks.DragArrowManipulator
Dim swHandler As swDragManipHdlr

Sub main()
    Dim swApp As SldWorks.SldWorks
    Dim swModel As SldWorks.ModelDoc2
    Dim swSelMgr As SldWorks.SelectionMgr
    Dim swMathUtil As SldWorks.MathUtility
    Dim vPunkt As Variant
    Dim dRichtung(2) As Double

    Set swApp = Application.SldWorks
    Set swModel = swApp.ActiveDoc
    If swModel Is Nothing Then Exit Sub
    Set swSelMgr = swModel.SelectionManager
    If swSelMgr.GetSelectedObjectType3(1, -1) <> swSelFACES Then Exit Sub
    vPunkt = swSelMgr.GetSelectionPoint2(1, -1)
    Set swMathUtil = swApp.GetMathUtility
    dRichtung(1) = 1                              ' Richtung +Y

    Set swHandler = New swDragManipHdlr
    Set swManip = swModel.ModelViewManager.CreateManipulator(swDragArrowManipulator, swHandler)
    Set swZiehpfeil = swManip.GetSpecificManipulator

    swZiehpfeil.ShowRuler = True
    swZiehpfeil.AllowFlip = True
    swZiehpfeil.ShowOppositeDirection = False     ' nur eine Richtung
    swZiehpfeil.Length = 0.02                     ' vermutlich Meter
    swZiehpfeil.Direction = swMathUtil.CreateVector(dRichtung)
    swZiehpfeil.Origin = swMathUtil.CreatePoint((vPunkt))
    swManip.Show swModel
    swZiehpfeil.Update
End Sub

Bemerkungen

Ablauf: Wie im Programmierhandbuch („Manipulators“) beschrieben, setzt dein Programm zuerst die Klasse für SwManipulatorHandler2 um. Dann legst du den Manipulator mit ModelViewManager.CreateManipulator an, holst mit Manipulator.GetSpecificManipulator den Ziehpfeil und passt Größe und Aussehen mit seinen Befehlen an. Das Hilfebeispiel zeigt ihn mit Manipulator.Show an und ruft danach DragArrowManipulator.Update auf.

Eine oder beide Richtungen: Mit DragArrowManipulator.ShowOppositeDirection auf True zeigt SOLIDWORKS einen Ziehpfeil in beide Richtungen, die Länge der Gegenrichtung steht in DragArrowManipulator.LengthOppositeDirection. DragArrowManipulator.AllowFlip gilt nur, wenn ShowOppositeDirection False ist.

Länge ändern: Nachdem du DragArrowManipulator.Length oder DragArrowManipulator.LengthOppositeDirection gesetzt hast, rufst du DragArrowManipulator.Update auf, damit der Ziehpfeil mit der neuen Länge erscheint.

Handler: Zieht der Anwender, bekommt der Handler in OnDoubleValueChanged die Länge des Ziehpfeils als Wert. In OnHandleSelected, OnUpdateDrag und OnEndDrag steht in handleIndex ein Wert aus swDragArrowManipulatorOptions_e für die erste oder zweite Richtung. Das Hilfebeispiel weist pManipulator dort direkt einer Variablen vom Typ DragArrowManipulator zu und verschiebt im Handler den Ursprung (siehe DragArrowManipulator.FixedLength).

Einheiten: Die Hilfe nennt keine. Das Hilfebeispiel gibt die Längen als 0.02 und 0.01 an, vermutlich Meter.

Variablen auf Modulebene: Wie bei TriadManipulator und PlaneManipulator hält das Hilfebeispiel Manipulator, Ziehpfeil und Handler in Variablen auf Modulebene. Vermutlich verschwindet der Manipulator sonst, sobald das Makro endet. Die Hilfe sagt dazu nichts.

Der Ursprung (DragArrowManipulator.Origin) ist in Metern angegeben, wie Modellkoordinaten.

Eigenschaften und Methoden

Eigenschaften 8, davon 8 beschrieben

NameBeschreibung
AllowFlipLiest oder setzt, ob der Ziehpfeil die Richtung umkehrt, wenn der Anwender über die Länge 0 hinaus zieht.
DirectionLiest oder setzt die Richtung des Ziehpfeils.
FixedLengthLiest oder setzt, ob sich der Ursprung des Ziehpfeils ändern lässt.
LengthLiest oder setzt die Länge des Ziehpfeils.
LengthOppositeDirectionLiest oder setzt die Länge des Ziehpfeils in Gegenrichtung.
OriginLiest oder setzt den Ursprung des Ziehpfeils.
ShowOppositeDirectionLiest oder setzt, ob der Ziehpfeil in beide Richtungen zeigt.
ShowRulerLiest oder setzt, ob beim Ziehen des Ziehpfeils ein Lineal erscheint.

Methoden 1, davon 1 beschrieben

NameBeschreibung
UpdateZeigt den Ziehpfeil an, nachdem du seine Länge geändert hast.

Siehe auch

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

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