SolidWorksMakroprogrammierung

Objekt · SldWorks

RefPlaneFeatureData-Objekt

Die Definition einer Referenzebene: ihre Art, die Referenzen mit Bedingung, Winkel oder Abstand und weitere Optionen.

Deklaration Dim x As SldWorks.RefPlaneFeatureData · in der englischen .NET-Hilfe: IRefPlaneFeatureData

Beschreibung

RefPlaneFeatureData gibt Zugriff auf die Daten eines Referenzebenen-Features. Du liest damit, wie die Ebene festgelegt ist, und änderst Referenzen, Winkel, Abstände und Optionen. Die Lage der Ebene im Raum liefert dagegen das Objekt RefPlane, das du mit Feature.GetSpecificFeature2 holst. Die meisten Befehle gibt es seit SOLIDWORKS 2003, die Befehle für Ebenen mit Bedingungen seit 2010.

Wichtig ist der Unterschied zwischen zwei Arten von Ebenen. Ebenen, die ab SOLIDWORKS 2010 erstellt wurden, sind mit Bedingungen aufgebaut: Sie haben bis zu drei Referenzen, jede mit einer Bedingung wie parallel, senkrecht, im Abstand oder im Winkel. Ältere Ebenen haben stattdessen eine feste Art, etwa im Abstand, im Winkel oder durch drei Punkte. Welche Befehle gelten, hängt davon ab (siehe Bemerkungen).

Zugriff

Beispiel

' Gibt aus, ob die ausgewählte Ebene mit Bedingungen aufgebaut ist, und dazu ihre
' Referenzen oder ihren Abstand.
' Vorbedingung: Ein Teil ist offen, eine Referenzebene ist im FeatureManager ausgewählt.
' Ergebnis:     Die Angaben stehen im Direktfenster, das Teil bleibt unverändert.
Option Explicit

Sub main()
    Dim swApp As SldWorks.SldWorks
    Dim swModel As SldWorks.ModelDoc2
    Dim swSel As Object
    Dim swFeat As SldWorks.Feature
    Dim swDaten As SldWorks.RefPlaneFeatureData
    Dim i As Long

    Set swApp = Application.SldWorks
    Set swModel = swApp.ActiveDoc
    If swModel Is Nothing Then Exit Sub
    Set swSel = swModel.SelectionManager.GetSelectedObject6(1, -1)
    If Not TypeOf swSel Is SldWorks.Feature Then Exit Sub
    Set swFeat = swSel
    If swFeat.GetTypeName2 <> "RefPlane" Then Exit Sub

    Set swDaten = swFeat.GetDefinition
    If swDaten.Type2 = swRefPlaneConstraintBase Then
        Debug.Print swFeat.Name & ": Ebene mit Bedingungen"
        For i = swRefPlaneReference_First To swRefPlaneReference_Third
            If swDaten.Constraint(i) <> 0 Then
                Debug.Print "  " & i + 1 & ". Referenz: Bedingung " & swDaten.Constraint(i) & _
                            ", Winkel oder Abstand " & swDaten.AngleOrDistance(i)
            End If
        Next i
    Else
        Debug.Print swFeat.Name & ": Ebene ohne Bedingungen, Art " & swDaten.Type & " (swRefPlaneType_e)"
    End If

    Select Case swDaten.Type
        Case swRefPlaneDistance: Debug.Print "  Abstand " & swDaten.Distance * 1000 & " mm"
        Case swRefPlaneAngle: Debug.Print "  Winkel " & swDaten.Angle * 180 / 3.14159265358979 & " Grad"
    End Select
End Sub

Bemerkungen

Welche Befehle gelten: Prüfe zuerst mit RefPlaneFeatureData.Type2, ob die Ebene mit Bedingungen aufgebaut ist (swRefPlaneConstraintBase). Bei einer solchen Ebene sagt RefPlaneFeatureData.Type, ob sie eine Winkel- (swRefPlaneAngle) oder Abstandsreferenz (swRefPlaneDistance) hat. Bei älteren Ebenen liefert Type die Art. Es gelten:

  • bei allen Ebenen: AccessSelections, GetSelectionsCount, ReleaseSelectionAccess und Selections, bei Ebenen mit Bedingungen ohne Winkel- oder Abstandsreferenz aber nur lesend
  • nur bei Ebenen mit Bedingungen: Reference, Constraint und AngleOrDistance, die Tabelle in der Hilfe nennt auch Type2
  • nicht bei Ebenen mit Bedingungen ohne Winkel- oder Abstandsreferenz: Angle, Distance, AutoSize, OriginOnCurve, ProjectionType, SolutionIndex, Type und UseNormalPlane

ReversedReferenceDirection und UpdatePlane fehlen in der Tabelle.

Ändern: Nach RefPlaneFeatureData.AccessSelections setzt du die Werte und rufst Feature.ModifyDefinition auf. Änderst du nichts, rufst du RefPlaneFeatureData.ReleaseSelectionAccess auf. So ändert das Hilfebeispiel „Modify Plane by Editing Its Definition“ den Abstand einer Ebene.

Anlegen: Neue Referenzebenen legst du mit FeatureManager.InsertRefPlane an. Die Referenzen wählst du vorher mit ModelDocExtension.SelectByID2 und den Markierungen 0, 1 und 2 aus, die Bedingungen kommen aus swRefPlaneReferenceConstraints_e.

Ebene und Definition: Zum selben Feature gibt es zwei Objekte: RefPlane aus Feature.GetSpecificFeature2 mit Lage, Eckpunkten und umgebendem Quader, und RefPlaneFeatureData aus Feature.GetDefinition. Das Hilfebeispiel „Get Corner Points of Reference Plane“ deklariert beide.

Veraltet: ReverseDirection ist durch RefPlaneFeatureData.ReversedReferenceDirection ersetzt.

Einheiten: Winkel sind im Bogenmaß. Für Distance nennt die Hilfe widersprüchlich Meter und Bogenmaß, gemeint sind Meter. Für AngleOrDistance nennt sie keine Einheit.

Eigenschaften und Methoden

Eigenschaften 16, davon 15 beschrieben, 1 veraltet

NameBeschreibung
AngleLiest oder setzt den Winkel einer Referenzebene im Winkel zu einer anderen Ebene oder Fläche.
AngleOrDistanceLiest oder setzt den Winkel oder Abstand zu einer der bis zu drei Referenzen einer Ebene mit Bedingungen.
AutoSizeLiest oder setzt, ob sich die Größe der Referenzebene automatisch nach der Geometrie richtet.
ConstraintLiest oder setzt die Bedingung zu einer der bis zu drei Referenzen einer Ebene mit Bedingungen.
DistanceLiest oder setzt den Abstand einer Referenzebene im Abstand zu einer anderen Ebene oder Fläche.
OriginOnCurveLiest oder setzt, ob der Ursprung der Referenzebene auf der Kurve liegt oder auf dem Eckpunkt oder Punkt.
ProjectionTypeLiest oder setzt, wie eine Referenzebene auf einer Fläche projiziert wird.
ReferenceLiest oder setzt das Element einer der bis zu drei Referenzen einer Ebene mit Bedingungen.
ReverseDirectionveraltet ersetzt durch RefPlaneFeatureData.ReversedReferenceDirection
ReversedReferenceDirectionLiest oder setzt, ob die Richtung einer der bis zu drei Referenzen einer Referenzebene umgekehrt ist.
SelectionsLiest oder setzt die Elemente, auf denen die Referenzebene aufbaut.
SolutionIndexLiest oder setzt, welche von mehreren möglichen Ebenen bei einer Referenzebene auf einer Fläche gemeint ist.
TypeLiefert die Art einer Referenzebene ohne Bedingungen oder, bei einer Ebene mit Bedingungen, ob sie eine Winkel- oder Abstandsreferenz hat.
Type2Liefert, ob die Referenzebene mit Bedingungen aufgebaut ist, also ab SOLIDWORKS 2010 erstellt wurde.
UpdatePlaneLiest oder setzt, ob die Referenzebene neu parallel zum Bildschirm ausgerichtet wird.
UseNormalPlaneLiest oder setzt, ob die Ebene senkrecht zur ausgewählten Ebene liegt und ihre Größe automatisch bekommt.

Methoden 3, davon 3 beschrieben

NameBeschreibung
AccessSelectionsSetzt das Modell vor die Referenzebene zurück, damit du die Auswahlen lesen und ändern kannst, die sie festlegen.
GetSelectionsCountLiefert die Zahl der Elemente, auf denen die Referenzebene aufbaut.
ReleaseSelectionAccessHebt den Rücksetz-Zustand nach AccessSelections wieder auf, wenn du die Referenzebene nicht geändert hast.

Nicht aufgeführt sind 3 C++-Varianten (Namen mit I davor, zum Beispiel IAccessSelections). In VBA nimmst du immer den Befehl ohne I.

Siehe auch

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

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