Objekt · SldWorks
PlaneManipulator-Objekt
Ein Manipulator in Form einer Ebene, die der Anwender im Grafikbereich verschiebt und dreht: Lage, Abstand, Winkel, Größe und Farbe.
Beschreibung
PlaneManipulator gibt Zugriff auf eine Ebene mit Manipulator. Im Hilfebeispiel verschiebt der Anwender die Ebene am Manipulator nach oben und unten und dreht sie, indem er an einer Kante der Ebene zieht. Was dabei passiert, bestimmt dein Programm in einer Klasse, die SwManipulatorHandler2 umsetzt. Die Befehle gibt es seit SOLIDWORKS 2011.
Zugriff
Manipulator.GetSpecificManipulator: bei einem Manipulator, den du mitModelViewManager.CreateManipulatorundswPlaneManipulator(swManipulatorType_e) angelegt hast
Beispiel
' Legt eine rote Ebene mit Manipulator an, verschiebt und dreht sie etwas und zeigt
' sie im aktiven Dokument an. Die Werte stammen aus dem Hilfebeispiel.
' Vorbedingung: Verweis auf die swpublished-Typbibliothek, ein Klassenmodul
' swEbenenHdlr mit "Implements SwManipulatorHandler2" wie im
' Hilfebeispiel "Insert and Use Plane with Manipulator". Ein Teil ist offen.
' Ergebnis: Die Ebene erscheint. Ziehen und Drehen meldet die Klasse.
Option Explicit
Dim swManip As SldWorks.Manipulator
Dim swEbenenManip As SldWorks.PlaneManipulator
Dim swHandler As swEbenenHdlr
Sub main()
Const PI As Double = 3.14159265358979
Dim swApp As SldWorks.SldWorks
Dim swModel As SldWorks.ModelDoc2
Set swApp = Application.SldWorks
Set swModel = swApp.ActiveDoc
If swModel Is Nothing Then Exit Sub
Set swHandler = New swEbenenHdlr
Set swManip = swModel.ModelViewManager.CreateManipulator(swPlaneManipulator, swHandler)
Set swEbenenManip = swManip.GetSpecificManipulator
swEbenenManip.Distance = 0.04 ' vermutlich Meter
swEbenenManip.XAngle = 2 * PI / 180 ' 2° in Bogenmaß
swEbenenManip.YAngle = 10 * PI / 180
swEbenenManip.Height = 0.1
swEbenenManip.Width = 0.075
swEbenenManip.Color = RGB(255, 0, 0)
If False = swEbenenManip.Update Then Debug.Print "Ebene nicht aktualisiert"
swManip.Show swModel
End SubBemerkungen
Ablauf: Dein Programm setzt zuerst die Klasse für SwManipulatorHandler2 um (Programmierhandbuch, „Manipulators“). Dann legst du den Manipulator mit ModelViewManager.CreateManipulator an, holst mit Manipulator.GetSpecificManipulator die Ebene und passt Größe und Aussehen mit ihren Befehlen an. Das Hilfebeispiel ruft danach PlaneManipulator.Update auf und zeigt die Ebene mit Manipulator.Show an.
Ursprung und Normale: Wird die Ebene schon angezeigt, setzt du keinen neuen Ursprung und keine neue Normale mehr. Setz PlaneManipulator.Origin und PlaneManipulator.Normal also vor Manipulator.Show.
Einheiten: Die Hilfe nennt keine. Das Hilfebeispiel rechnet die Winkel von Grad in Bogenmaß um. Abstand, Höhe und Breite gibt es als 0.04, 0.1 und 0.075 an, vermutlich Meter.
Handler: Im Hilfebeispiel weist der Handler in OnUpdateDrag pManipulator einer Variablen vom Typ PlaneManipulator zu. Ist handleIndex 8, liest er PlaneManipulator.Distance, sonst PlaneManipulator.XAngle und PlaneManipulator.YAngle. Eine Aufzählung der Griffe wie swTriadManipulatorControlPoints_e bei der Triade gibt es für die Ebene nicht.
Variablen auf Modulebene: Wie bei TriadManipulator hält das Hilfebeispiel Manipulator, Ebene und Handler in Variablen auf Modulebene. Vermutlich verschwindet der Manipulator sonst, sobald das Makro endet. Die Hilfe sagt dazu nichts.
PlaneManipulator.Update liefert beim Beispiel False. Die Meldung „Ebene nicht aktualisiert“ erscheint also auch bei richtig eingerichteter Ebene.
Eigenschaften und Methoden
Eigenschaften 8, davon 8 beschrieben
| Name | Beschreibung |
|---|---|
| Color | Liest oder setzt die Farbe der Ebene mit Manipulator. |
| Distance | Liest oder setzt den Abstand, um den die Ebene mit Manipulator verschoben ist. |
| Height | Liest oder setzt die Höhe der Ebene mit Manipulator. |
| Normal | Liest oder setzt die Normale der Ebene mit Manipulator. |
| Origin | Liest oder setzt den Ursprung der Ebene mit Manipulator. |
| Width | Liest oder setzt die Breite der Ebene mit Manipulator. |
| XAngle | Liest oder setzt den x-Anteil des Winkels, um den die Ebene mit Manipulator gedreht ist. |
| YAngle | Liest oder setzt den y-Anteil des Winkels, um den die Ebene mit Manipulator gedreht ist. |
Methoden 1, davon 1 beschrieben
| Name | Beschreibung |
|---|---|
| Update | Übernimmt die Änderungen an der Ebene mit Manipulator. |
Siehe auch
Englisches Original: IPlaneManipulator in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)
Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.