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.
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:
swTriadManipulator: eine Triade (TriadManipulator)swDragArrowManipulator: ein Ziehpfeil (DragArrowManipulator)swPlaneManipulator: eine Ebene (PlaneManipulator)
Anzeigen, Sichtbarkeit, Auswahl und Entfernen erledigst du am Manipulator selbst.
Zugriff
ModelViewManager.CreateManipulator: legt den Manipulator an. Den ModelViewManager liefertModelDoc2.ModelViewManager.
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 SubBemerkungen
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
| Name | Beschreibung |
|---|---|
| Name | Liest oder setzt den Namen des Manipulators. |
| Options | Liest oder setzt, ob der Manipulator gelöscht wird, wenn eine Komponente der Baugruppe geändert oder gelöscht wird. |
| Selectable | Liest oder setzt, ob der Manipulator in einem Auswahlfeld einer PropertyManager-Seite ausgewählt werden kann. |
| Visible | Liest oder setzt, ob der Manipulator im Teil oder in der Baugruppe sichtbar ist. |
Methoden 4, davon 4 beschrieben
| Name | Beschreibung |
|---|---|
| GetSpecificManipulator | Liefert das spezifische Objekt des Manipulators: eine Triade, einen Ziehpfeil oder eine Ebene. |
| Remove | Entfernt den Manipulator aus dem Teil oder der Baugruppe. |
| Select | Wählt den Manipulator aus. |
| Show | Zeigt 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.