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.
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
Manipulator.GetSpecificManipulator: bei einem Manipulator, den du mitModelViewManager.CreateManipulatorundswDragArrowManipulator(swManipulatorType_e) angelegt hast
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 SubBemerkungen
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
| Name | Beschreibung |
|---|---|
| AllowFlip | Liest oder setzt, ob der Ziehpfeil die Richtung umkehrt, wenn der Anwender über die Länge 0 hinaus zieht. |
| Direction | Liest oder setzt die Richtung des Ziehpfeils. |
| FixedLength | Liest oder setzt, ob sich der Ursprung des Ziehpfeils ändern lässt. |
| Length | Liest oder setzt die Länge des Ziehpfeils. |
| LengthOppositeDirection | Liest oder setzt die Länge des Ziehpfeils in Gegenrichtung. |
| Origin | Liest oder setzt den Ursprung des Ziehpfeils. |
| ShowOppositeDirection | Liest oder setzt, ob der Ziehpfeil in beide Richtungen zeigt. |
| ShowRuler | Liest oder setzt, ob beim Ziehen des Ziehpfeils ein Lineal erscheint. |
Methoden 1, davon 1 beschrieben
| Name | Beschreibung |
|---|---|
| Update | Zeigt 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.