SolidWorksMakroprogrammierung

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.

Deklaration Dim x As SldWorks.PlaneManipulator · in der englischen .NET-Hilfe: IPlaneManipulator

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

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 Sub

Bemerkungen

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

NameBeschreibung
ColorLiest oder setzt die Farbe der Ebene mit Manipulator.
DistanceLiest oder setzt den Abstand, um den die Ebene mit Manipulator verschoben ist.
HeightLiest oder setzt die Höhe der Ebene mit Manipulator.
NormalLiest oder setzt die Normale der Ebene mit Manipulator.
OriginLiest oder setzt den Ursprung der Ebene mit Manipulator.
WidthLiest oder setzt die Breite der Ebene mit Manipulator.
XAngleLiest oder setzt den x-Anteil des Winkels, um den die Ebene mit Manipulator gedreht ist.
YAngleLiest oder setzt den y-Anteil des Winkels, um den die Ebene mit Manipulator gedreht ist.

Methoden 1, davon 1 beschrieben

NameBeschreibung
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.