Objekt · SldWorks
TriadManipulator-Objekt
Ein Manipulator in Form eines Koordinatendreiecks, mit dem der Anwender im Grafikbereich verschiebt und dreht: Ursprung, Achsen, Farben, Größe und sichtbare Griffe.
Beschreibung
TriadManipulator gibt Zugriff auf einen Triaden-Manipulator. Er ähnelt der Triade von SOLIDWORKS, mit der du Komponenten verschiebst und drehst oder Körper verschiebst und kopierst. Der Anwender zieht an den Achsen, Ebenen oder Ringen. Was dabei passiert, bestimmt dein Programm in einer Klasse, die SwManipulatorHandler2 umsetzt. Die meisten Befehle gibt es seit SOLIDWORKS 2005.
Zugriff
Manipulator.GetSpecificManipulator: bei einem Manipulator, den du mitModelViewManager.CreateManipulatorundswTriadManipulator(swManipulatorType_e) angelegt hast
Beispiel
' Legt eine Triade an der Stelle an, an der die ausgewählte Fläche angeklickt wurde,
' blendet die Ringe aus und färbt die x-Achse rot.
' Vorbedingung: Verweis auf die swpublished-Typbibliothek, ein Klassenmodul
' swDragManipHdlr mit "Implements SwManipulatorHandler2" wie im
' Hilfebeispiel "Create Triad Manipulator". Ein Teil ist offen, eine
' Fläche ist ausgewählt.
' Ergebnis: Die Triade erscheint auf der Fläche. Ziehen meldet die Klasse.
Option Explicit
Dim swManip As SldWorks.Manipulator
Dim swTriade As SldWorks.TriadManipulator
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
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
Set swHandler = New swDragManipHdlr
Set swManip = swModel.ModelViewManager.CreateManipulator(swTriadManipulator, swHandler)
Set swTriade = swManip.GetSpecificManipulator
swTriade.Origin = swMathUtil.CreatePoint((vPunkt))
swTriade.DoNotShow = swTriadManipulatorDoNotShowXYRING + swTriadManipulatorDoNotShowYZRING + _
swTriadManipulatorDoNotShowZXRING
swTriade.SetColorRefAtIndex swTriadManipulatorXAxis, RGB(255, 0, 0)
swTriade.UpdatePosition
swManip.Show swModel
End SubBemerkungen
Ablauf (Programmierhandbuch, „Manipulators“): Dein Programm setzt zuerst die Klasse für SwManipulatorHandler2 um. Dann legst du den Manipulator mit ModelViewManager.CreateManipulator an, holst mit Manipulator.GetSpecificManipulator die Triade und passt Größe und Aussehen mit ihren Befehlen an. Angezeigt wird sie mit Manipulator.Show.
Lage ändern: Nachdem du TriadManipulator.Origin oder eine Achse gesetzt hast, rufst du TriadManipulator.UpdatePosition auf. Dein Handler verschiebt die Triade an diese Stelle, SOLIDWORKS tut es nicht von selbst.
Variablen auf Modulebene: Das Hilfebeispiel hält Manipulator, Triade und Handler in Variablen auf Modulebene. Vermutlich verschwindet der Manipulator sonst, sobald das Makro endet und die Objekte freigegeben werden. Die Hilfe sagt dazu nichts.
Griffe: Die Nummern der Griffe (Ursprung, Achsen, Ebenen) stehen in swTriadManipulatorControlPoints_e. Die Ereignisse des Handlers liefern sie als handleIndex.
Eigenschaften und Methoden
Eigenschaften 7, davon 7 beschrieben
| Name | Beschreibung |
|---|---|
| Cursor | Setzt den Mauszeiger, der erscheint, wenn der Zeiger über der Triade steht. |
| DoNotShow | Liest oder setzt, welche Griffe der Triade ausgeblendet sind. |
| Origin | Liest oder setzt den Ursprung der Triade. |
| PreviousDragPoint | Liefert die vorige Position beim Ziehen der Triade. |
| XAxis | Liest oder setzt die Richtung der x-Achse der Triade. |
| YAxis | Liest oder setzt die Richtung der y-Achse der Triade. |
| ZAxis | Liest oder setzt die Richtung der z-Achse der Triade. |
Methoden 3, davon 3 beschrieben
| Name | Beschreibung |
|---|---|
| SetColorRefAtIndex | Setzt die Farbe eines Griffs der Triade. |
| UpdatePosition | Zeigt die Triade an der Lage an, die du mit Origin und den Achsen gesetzt hast. |
| UpdateScale | Setzt die Länge der drei Achsen der Triade. |
Siehe auch
Englisches Original: ITriadManipulator in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)
Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.