SolidWorksMakroprogrammierung

Objekt · SldWorks

Manipulator-Objekt

Ein Griff im Grafikbereich eines Teils oder einer Baugruppe, etwa eine Triade, ein Ziehpfeil oder eine Ebene, an dem der Anwender zieht: anzeigen, ausblenden, auswählen, entfernen und das spezifische Objekt holen.

Deklaration Dim x As SldWorks.Manipulator · in der englischen .NET-Hilfe: IManipulator

Beschreibung

Manipulator gibt Zugriff auf einen Manipulator in einem Teil oder einer Baugruppe. Er ähnelt der Triade oder dem Ziehpfeil von SOLIDWORKS. Was beim Ziehen geschieht, bestimmt dein Programm in einer Klasse, die SwManipulatorHandler2 umsetzt. Die ersten Befehle gibt es seit SOLIDWORKS 2005.

Manipulator ist das allgemeine Objekt. Welche Form der Griff hat, legst du beim Anlegen mit ModelViewManager.CreateManipulator und einem Wert aus swManipulatorType_e fest. Das spezifische Objekt mit den Befehlen für Lage, Größe und Aussehen holst du dann mit Manipulator.GetSpecificManipulator:

Anzeigen, Sichtbarkeit, Auswahl und Entfernen erledigst du am Manipulator selbst.

Zugriff

Beispiel

' Legt einen Manipulator vom Typ Triade an, holt die Triade, setzt ihren Ursprung
' auf den Punkt, an dem die ausgewählte Fläche angeklickt wurde, und zeigt sie an.
' Vorbedingung: Verweis auf die swpublished-Typbibliothek, ein Klassenmodul
'               swDragManipHdlr mit "Implements SwManipulatorHandler2" wie im
'               Hilfebeispiel "Create Triad Manipulator". Ein Teil oder eine
'               Baugruppe ist offen, eine Fläche ist ausgewählt.
' Ergebnis:     Die Triade erscheint auf der Fläche. Ein zweiter Aufruf von
'               Entfernen nimmt sie wieder weg.
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)
    swManip.Name = "Meine Triade"
    swManip.Options = swManipulatorOpts_KeepAfterComponentModify

    Set swTriade = swManip.GetSpecificManipulator
    swTriade.Origin = swMathUtil.CreatePoint((vPunkt))
    swManip.Show swModel
    Debug.Print swManip.Name & " sichtbar: " & swManip.Visible
End Sub

Sub Entfernen()
    If swManip Is Nothing Then Exit Sub
    swManip.Remove
    Set swTriade = Nothing
    Set swManip = Nothing
End Sub

Bemerkungen

Ablauf: Zuerst setzt dein Programm die Klasse für SwManipulatorHandler2 um (Programmierhandbuch „Manipulators“). Sie bestimmt, wie sich der Manipulator bewegt, zeigt vorläufige Grafik an und wendet Transformationen an. Dann legst du den Manipulator mit ModelViewManager.CreateManipulator an. Mit seinen Befehlen zeigst du ihn an, steuerst die Sichtbarkeit und entfernst ihn. Mit Manipulator.GetSpecificManipulator holst du das spezifische Objekt und passt mit dessen Befehlen Größe und Aussehen an.

Handler: Die Ereignisse des Handlers bekommen den Manipulator als Parameter pManipulator. Die Hilfebeispiele „Insert and Use Plane with Manipulator“ und „Create Drag Arrow Manipulator“ weisen ihn dort direkt einer Variablen vom Typ PlaneManipulator bzw. DragArrowManipulator zu. Vermutlich ist pManipulator also schon das spezifische Objekt. Ausdrücklich sagt die Hilfe das nicht.

Variablen auf Modulebene: Die Hilfebeispiele halten Manipulator, spezifisches Objekt und Handler in Variablen auf Modulebene. Vermutlich verschwindet der Manipulator sonst, sobald das Makro endet. Die Hilfe sagt dazu nichts.

Baugruppen: Manipulatoren, die über die API angelegt wurden, werden gelöscht, wenn eine Komponente im Kontext der Baugruppe geändert oder gelöscht wird. Für Baugruppen empfiehlt die Hilfe deshalb swManipulatorOpts_KeepAfterComponentModify in Manipulator.Options.

Auswahl: In swSelectType_e steht ein Manipulator als swSelMANIPULATORS („MANIPULATOR“). Das Hilfebeispiel „Create PropertyManager Page and Selectable Triad Manipulator“ setzt diesen Typ als Filter eines Auswahlfelds (PropertyManagerPageSelectionbox.SetSelectionFilters) und Manipulator.Selectable auf True.

Zoomen: Nach ModelViewManager.CreateManipulator siehst du einen Manipulator nach „Zoomen auf Gesamtansicht“ nicht mehr, wenn du ihn weit vom Modell weg verschoben hast.

Eigenschaften und Methoden

Eigenschaften 4, davon 4 beschrieben

NameBeschreibung
NameLiest oder setzt den Namen des Manipulators.
OptionsLiest oder setzt, ob der Manipulator gelöscht wird, wenn eine Komponente der Baugruppe geändert oder gelöscht wird.
SelectableLiest oder setzt, ob der Manipulator in einem Auswahlfeld einer PropertyManager-Seite ausgewählt werden kann.
VisibleLiest oder setzt, ob der Manipulator im Teil oder in der Baugruppe sichtbar ist.

Methoden 4, davon 4 beschrieben

NameBeschreibung
GetSpecificManipulatorLiefert das spezifische Objekt des Manipulators: eine Triade, einen Ziehpfeil oder eine Ebene.
RemoveEntfernt den Manipulator aus dem Teil oder der Baugruppe.
SelectWählt den Manipulator aus.
ShowZeigt den Manipulator im Teil oder in der Baugruppe an.

Siehe auch

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

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