SolidWorksMakroprogrammierung

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.

Deklaration Dim x As SldWorks.TriadManipulator · in der englischen .NET-Hilfe: ITriadManipulator

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

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 Sub

Bemerkungen

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

NameBeschreibung
CursorSetzt den Mauszeiger, der erscheint, wenn der Zeiger über der Triade steht.
DoNotShowLiest oder setzt, welche Griffe der Triade ausgeblendet sind.
OriginLiest oder setzt den Ursprung der Triade.
PreviousDragPointLiefert die vorige Position beim Ziehen der Triade.
XAxisLiest oder setzt die Richtung der x-Achse der Triade.
YAxisLiest oder setzt die Richtung der y-Achse der Triade.
ZAxisLiest oder setzt die Richtung der z-Achse der Triade.

Methoden 3, davon 3 beschrieben

NameBeschreibung
SetColorRefAtIndexSetzt die Farbe eines Griffs der Triade.
UpdatePositionZeigt die Triade an der Lage an, die du mit Origin und den Achsen gesetzt hast.
UpdateScaleSetzt 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.