SolidWorksMakroprogrammierung

Objekt · SldWorks

CoordinateSystemElement-Objekt

Ein einzelnes Element eines Koordinatensystems, etwa seine X-Achse, die XY-Ebene oder sein Punkt, wenn es ausgewählt ist.

Deklaration Dim x As SldWorks.CoordinateSystemElement · in der englischen .NET-Hilfe: ICoordinateSystemElement

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

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 Sub

Bemerkungen

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

NameBeschreibung
GetCoordinateSystemLiefert das Koordinatensystem, zu dem das Element gehört.
GetElementTypeLiefert, 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.