SolidWorksMakroprogrammierung

Objekt · SldWorks

CoordinateSystemFeatureData-Objekt

Die Definition eines Koordinatensystems: das Element für den Ursprung, die Elemente für die Achsen, umgekehrte Achsen und die Lage als Transformation.

Deklaration Dim x As SldWorks.CoordinateSystemFeatureData · in der englischen .NET-Hilfe: ICoordinateSystemFeatureData

Beschreibung

CoordinateSystemFeatureData gibt Zugriff auf das Feature eines Koordinatensystems. Der Ursprung sitzt auf einem Element wie einem Eckpunkt. Die Richtungen der Achsen legen Punkte, Linien, Kanten, Ebenen oder Flächen fest, für zwei der drei Achsen, die dritte ergibt sich daraus. Jede Achse lässt sich umkehren. Die Befehle gibt es seit SOLIDWORKS 2009.

Zugriff

Beispiel

' Gibt für jedes Koordinatensystem im FeatureManager die Art des Ursprungs, die Zahl der
' Elemente je Achse, umgekehrte Achsen und die Verschiebung aus.
' Vorbedingung: Ein Teil mit mindestens einem Koordinatensystem ist offen.
' Ergebnis:     Die Werte stehen im Direktfenster, das Teil bleibt unverändert.
Option Explicit

Sub main()
    Dim swApp As SldWorks.SldWorks
    Dim swModel As SldWorks.ModelDoc2
    Dim swFeat As SldWorks.Feature
    Dim swDaten As SldWorks.CoordinateSystemFeatureData
    Dim v As Variant

    Set swApp = Application.SldWorks
    Set swModel = swApp.ActiveDoc
    If swModel Is Nothing Then Exit Sub

    Set swFeat = swModel.FirstFeature
    Do While Not swFeat Is Nothing
        If swFeat.GetTypeName2 = "CoordSys" Then
            Set swDaten = swFeat.GetDefinition
            If swDaten.AccessSelections(swModel, Nothing) Then
                Debug.Print swFeat.Name & ": Ursprung Art " & swDaten.GetOriginEntityType
                Debug.Print "  Elemente X/Y/Z: " & swDaten.GetXAxisEntitiesCount & "/" & _
                            swDaten.GetYAxisEntitiesCount & "/" & swDaten.GetZAxisEntitiesCount
                Debug.Print "  Umgekehrt X/Y/Z: " & swDaten.XFlipped & "/" & swDaten.YFlipped & "/" & swDaten.ZFlipped
                v = swDaten.Transform.ArrayData
                Debug.Print "  Verschiebung: " & v(9) * 1000 & ", " & v(10) * 1000 & ", " & v(11) * 1000 & " mm"
                swDaten.ReleaseSelectionAccess                 ' nichts geändert
            End If
        End If
        Set swFeat = swFeat.GetNextFeature
    Loop
End Sub

Bemerkungen

Anlegen: Neue Koordinatensysteme legst du mit FeatureManager.CreateCoordinateSystem an, dem du Ursprung und Achsen direkt übergibst, oder mit FeatureManager.InsertCoordinateSystem nach vorheriger Auswahl.

Ändern: Nach CoordinateSystemFeatureData.AccessSelections setzt du Ursprung, Achsen oder Umkehrung und rufst Feature.ModifyDefinition auf. Ohne Änderung rufst du CoordinateSystemFeatureData.ReleaseSelectionAccess auf. Neue Elemente wählt das Hilfebeispiel „Create Coordinate System Feature“ erst nach AccessSelections aus, holt sie aus der Auswahl und weist sie dann zu.

Zwei Achsen: Im Hilfebeispiel sind nur zwei Achsen aktiv. Für die dritte gibt es dann keine Elemente, ihre Anzahl ist 0.

Transformation: In welche Richtung CoordinateSystemFeatureData.Transform abbildet, sagt die Hilfe nicht. Das Beispiel oben gibt deshalb nur die Verschiebung aus, ohne sie zu deuten.

Koordinatensystem-Elemente: Features, die auf einer einzelnen Achse, Ebene oder dem Punkt eines Koordinatensystems aufbauen, lassen sich nicht über ModifyDefinition ändern, siehe CoordinateSystemElement.

Die Verschiebung in CoordinateSystemFeatureData.Transform kommt in Metern.

Eigenschaften und Methoden

Eigenschaften 8, davon 8 beschrieben

NameBeschreibung
OriginEntityLiest oder setzt das Element, das den Ursprung des Koordinatensystems festlegt, etwa einen Eckpunkt.
TransformLiefert die Lage des Koordinatensystems als Transformation mit Drehung und Verschiebung.
XAxisEntitiesLiest oder setzt die Elemente, die die Richtung der X-Achse des Koordinatensystems festlegen.
XFlippedLiest oder setzt, ob die X-Achse des Koordinatensystems umgekehrt wird.
YAxisEntitiesLiest oder setzt die Elemente, die die Richtung der Y-Achse des Koordinatensystems festlegen.
YFlippedLiest oder setzt, ob die Y-Achse des Koordinatensystems umgekehrt wird.
ZAxisEntitiesLiest oder setzt die Elemente, die die Richtung der Z-Achse des Koordinatensystems festlegen.
ZFlippedLiest oder setzt, ob die Z-Achse des Koordinatensystems umgekehrt wird.

Methoden 9, davon 9 beschrieben

NameBeschreibung
AccessSelectionsSetzt das Modell vor das Koordinatensystem zurück, damit du Ursprung und Achsen lesen und ändern kannst.
GetOriginEntityTypeLiefert die Art des Elements, das den Ursprung des Koordinatensystems festlegt.
GetXAxisEntitiesCountLiefert die Zahl der Elemente, die die X-Achse des Koordinatensystems festlegen.
GetXAxisEntitiesTypesLiefert die Art der Elemente, die die X-Achse des Koordinatensystems festlegen.
GetYAxisEntitiesCountLiefert die Zahl der Elemente, die die Y-Achse des Koordinatensystems festlegen.
GetYAxisEntitiesTypesLiefert die Art der Elemente, die die Y-Achse des Koordinatensystems festlegen.
GetZAxisEntitiesCountLiefert die Zahl der Elemente, die die Z-Achse des Koordinatensystems festlegen.
GetZAxisEntitiesTypesLiefert die Art der Elemente, die die Z-Achse des Koordinatensystems festlegen.
ReleaseSelectionAccessHebt den Rücksetz-Zustand nach AccessSelections wieder auf, wenn du das Koordinatensystem nicht geändert hast.

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

Siehe auch

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

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