SolidWorksMakroprogrammierung

Objekt · SldWorks

RefAxis-Objekt

Eine Referenzachse: ihre Lage im Raum und ob es eine temporäre Achse ist.

Deklaration Dim x As SldWorks.RefAxis · in der englischen .NET-Hilfe: IRefAxis

Beschreibung

RefAxis gibt Zugriff auf Referenzachsen. Eine Referenzachse ist eine Gerade, die du im FeatureManager als Feature anlegst, etwa als Schnitt zweier Ebenen oder als Mittelachse einer zylindrischen Fläche. Viele Features und Verknüpfungen nehmen sie als Richtung oder Drehachse, etwa kreisförmige Muster, Rotationen und konzentrische Verknüpfungen.

Zum Feature einer Referenzachse gibt es zwei Objekte:

RefAxis steht außerdem für die temporären Achsen, die SOLIDWORKS in zylindrischen und konischen Flächen anzeigt. GetRefAxisParams nennt kein Versionsdatum, die Befehle für temporäre Achsen gibt es seit SOLIDWORKS 2017.

Zugriff

Beispiel

' Geht alle Features des aktiven Modells durch und gibt für jede Referenzachse
' Anfangs- und Endpunkt in Millimeter und die Art ihrer Definition aus.
' Vorbedingung: Ein Teil oder eine Baugruppe mit Referenzachsen ist offen.
' Ergebnis:     Die Achsen stehen im Direktfenster, das Modell bleibt unverändert.
Option Explicit

Sub main()
    Dim swApp As SldWorks.SldWorks
    Dim swModel As SldWorks.ModelDoc2
    Dim swFeat As SldWorks.Feature
    Dim swAchse As SldWorks.RefAxis
    Dim swDaten As SldWorks.RefAxisFeatureData
    Dim vWerte 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 = "RefAxis" Then
            Set swAchse = swFeat.GetSpecificFeature2
            vWerte = swAchse.GetRefAxisParams
            Set swDaten = swFeat.GetDefinition
            Debug.Print swFeat.Name & " (Art " & swDaten.Type & "):"
            Debug.Print "  Anfang (" & Format(vWerte(0) * 1000, "0.00") & ", " & _
                Format(vWerte(1) * 1000, "0.00") & ", " & Format(vWerte(2) * 1000, "0.00") & ") mm"
            Debug.Print "  Ende   (" & Format(vWerte(3) * 1000, "0.00") & ", " & _
                Format(vWerte(4) * 1000, "0.00") & ", " & Format(vWerte(5) * 1000, "0.00") & ") mm"
        End If
        Set swFeat = swFeat.GetNextFeature
    Loop
End Sub

Bemerkungen

Typname: Referenzachsen haben nach Feature.GetTypeName2 den Typnamen RefAxis. Daran erkennt sie das Beispiel. Für diesen Typnamen nennt die Hilfe sowohl RefAxis als auch RefAxisFeatureData, je nachdem, ob du Feature.GetSpecificFeature2 oder Feature.GetDefinition aufrufst.

Ausgewählte Achse: Die Hilfebeispiele „Get Parameters of Reference Axis“ und „Get Reference Axis Data“ weisen die ausgewählte Achse aus SelectionMgr.GetSelectedObject6 einer Variablen vom Typ Feature zu und rufen dann GetSpecificFeature2 auf. „Get Reference Axis Data“ holt zusätzlich mit GetDefinition die Art aus swRefAxisType_e.

Anlegen: Neue Referenzachsen legst du mit ModelDoc2.InsertAxis2 aus der Auswahl an. Die Anzeige der Referenzachsen schaltest du mit ModelDoc2.ViewDispRefaxes um, die der temporären Achsen mit ModelDoc2.ViewDispTempRefaxes.

Einheiten: Die Hilfebeispiele rechnen die Werte aus RefAxis.GetRefAxisParams mit * 1000 in Millimeter um, es sind Meter.

Eigenschaften und Methoden

Methoden 3, davon 3 beschrieben

NameBeschreibung
GetRefAxisParamsLiefert Anfangs- und Endpunkt der Referenzachse.
GetTempAxisReferenceFaceLiefert die Fläche, aus der die temporäre Achse entsteht.
IsTempAxisLiefert, ob die Referenzachse eine temporäre Achse ist.

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

Siehe auch

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

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