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.
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
Feature.GetDefinition: bei einem Feature mit dem TypnamenCoordSysCoordinateSystemElement.GetCoordinateSystem: das Feature zu einem ausgewählten Element des Koordinatensystems
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 SubBemerkungen
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
| Name | Beschreibung |
|---|---|
| OriginEntity | Liest oder setzt das Element, das den Ursprung des Koordinatensystems festlegt, etwa einen Eckpunkt. |
| Transform | Liefert die Lage des Koordinatensystems als Transformation mit Drehung und Verschiebung. |
| XAxisEntities | Liest oder setzt die Elemente, die die Richtung der X-Achse des Koordinatensystems festlegen. |
| XFlipped | Liest oder setzt, ob die X-Achse des Koordinatensystems umgekehrt wird. |
| YAxisEntities | Liest oder setzt die Elemente, die die Richtung der Y-Achse des Koordinatensystems festlegen. |
| YFlipped | Liest oder setzt, ob die Y-Achse des Koordinatensystems umgekehrt wird. |
| ZAxisEntities | Liest oder setzt die Elemente, die die Richtung der Z-Achse des Koordinatensystems festlegen. |
| ZFlipped | Liest oder setzt, ob die Z-Achse des Koordinatensystems umgekehrt wird. |
Methoden 9, davon 9 beschrieben
| Name | Beschreibung |
|---|---|
| AccessSelections | Setzt das Modell vor das Koordinatensystem zurück, damit du Ursprung und Achsen lesen und ändern kannst. |
| GetOriginEntityType | Liefert die Art des Elements, das den Ursprung des Koordinatensystems festlegt. |
| GetXAxisEntitiesCount | Liefert die Zahl der Elemente, die die X-Achse des Koordinatensystems festlegen. |
| GetXAxisEntitiesTypes | Liefert die Art der Elemente, die die X-Achse des Koordinatensystems festlegen. |
| GetYAxisEntitiesCount | Liefert die Zahl der Elemente, die die Y-Achse des Koordinatensystems festlegen. |
| GetYAxisEntitiesTypes | Liefert die Art der Elemente, die die Y-Achse des Koordinatensystems festlegen. |
| GetZAxisEntitiesCount | Liefert die Zahl der Elemente, die die Z-Achse des Koordinatensystems festlegen. |
| GetZAxisEntitiesTypes | Liefert die Art der Elemente, die die Z-Achse des Koordinatensystems festlegen. |
| ReleaseSelectionAccess | Hebt 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.