Objekt · SldWorks
CoordinateSystemElement-Objekt
Ein einzelnes Element eines Koordinatensystems, etwa seine X-Achse, die XY-Ebene oder sein Punkt, wenn es ausgewählt ist.
Beschreibung
CoordinateSystemElement gibt Zugriff auf ein Element eines Koordinatensystems. Seit SOLIDWORKS 2025 SP01 lassen sich die Achsen, Ebenen und der Punkt eines Koordinatensystems einzeln auswählen und als Referenz für andere Features nutzen, etwa für eine Achse. Das Objekt sagt, welches Element ausgewählt ist und zu welchem Koordinatensystem es gehört.
Zugriff
SelectionMgr.GetSelectedCoordSysElement: das ausgewählte Element, nachdemSelectionMgr.IsCoordSysElementSelectedTruegeliefert hat
Beispiel
' Gibt aus, welches Element eines Koordinatensystems ausgewählt ist und zu welchem
' Koordinatensystem es gehört.
' Vorbedingung: Ein Teil mit einem Koordinatensystem ist offen, ein Element davon ist
' ausgewählt, etwa die X-Achse.
' Ergebnis: Art des Elements und Name des Koordinatensystems stehen im Direktfenster.
Option Explicit
Sub main()
Dim swApp As SldWorks.SldWorks
Dim swModel As SldWorks.ModelDoc2
Dim swSelMgr As SldWorks.SelectionMgr
Dim swElement As SldWorks.CoordinateSystemElement
Dim swFeat As SldWorks.Feature
Dim sArt As String
Set swApp = Application.SldWorks
Set swModel = swApp.ActiveDoc
If swModel Is Nothing Then Exit Sub
Set swSelMgr = swModel.SelectionManager
If swSelMgr.GetSelectedObjectType3(1, -1) <> swSelCOORDSYS Then Exit Sub
If False = swSelMgr.IsCoordSysElementSelected(1, -1) Then
Debug.Print "Ausgewählt ist das ganze Koordinatensystem, kein einzelnes Element."
Exit Sub
End If
Set swElement = swSelMgr.GetSelectedCoordSysElement(1, -1)
Select Case swElement.GetElementType
Case swCoordSysElement_XAxis, swCoordSysElement_YAxis, swCoordSysElement_ZAxis: sArt = "Achse"
Case swCoordSysElement_XYPlane, swCoordSysElement_XZPlane, swCoordSysElement_YZPlane: sArt = "Ebene"
Case swCoordSysElement_Point: sArt = "Punkt"
End Select
Set swFeat = swElement.GetCoordinateSystem
Debug.Print sArt & " (" & swElement.GetElementType & ") von " & swFeat.Name
End SubBemerkungen
Features mit Koordinatensystem-Elementen ändern: Der übliche Weg über Feature.GetDefinition und Feature.ModifyDefinition funktioniert nicht für Features, die mit einem Element eines Koordinatensystems angelegt wurden. Stattdessen wählst du das Feature aus, öffnest mit ModelDocExtension.RunCommand und swCommands_EditFeature seinen PropertyManager, prüfst mit SelectionMgr.GetSelectedObjectType3 und SelectionMgr.IsCoordSysElementSelected die Auswahl und holst das Element mit SelectionMgr.GetSelectedCoordSysElement. Das Hilfebeispiel dazu schließt den PropertyManager danach mit swCommands_Dve_Rmb_Cancel wieder.
Auswahl: Das Hilfebeispiel nennt als Weg zur Auswahl auch ModelDocExtension.SelectByID2 mit einem Namen wie Coordinate System1\X Axis und dem Typ COORDSYS. Die Namen hängen vermutlich von der Sprache von SOLIDWORKS ab.
In SOLIDWORKS 2024 nicht prüfbar: Die Typbibliothek kennt CoordinateSystemElement noch nicht, schon Dim swElement As SldWorks.CoordinateSystemElement brach beim Kompilieren ab („Benutzerdefinierter Typ nicht definiert“). Das Objekt gibt es erst ab SOLIDWORKS 2025 SP01.
Eigenschaften und Methoden
Methoden 2, davon 2 beschrieben
| Name | Beschreibung |
|---|---|
| GetCoordinateSystem | Liefert das Koordinatensystem, zu dem das Element gehört. |
| GetElementType | Liefert, welches Element des Koordinatensystems es ist: eine der drei Ebenen, eine der drei Achsen oder der Punkt. |
Siehe auch
Englisches Original: ICoordinateSystemElement in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)
Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.