Objekt · SldWorks
RefAxis-Objekt
Eine Referenzachse: ihre Lage im Raum und ob es eine temporäre Achse ist.
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, das du mit
Feature.GetSpecificFeature2holst: die Achse selbst mit Anfangs- und Endpunkt RefAxisFeatureData, das du mitFeature.GetDefinitionholst: die Definition, also wie die Achse festgelegt ist und auf welche Elemente sie sich stützt
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
Feature.GetSpecificFeature2: beim Feature einer Referenzachse (TypnameRefAxis) und bei einer ausgewählten temporären Achse- Bei Features und Verknüpfungen, die eine Achse verlangen, etwa
CircularPatternFeatureData.Axis,RevolveFeatureData2.AxisundConcentricMateFeatureData.EntitiesToMate
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 SubBemerkungen
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
| Name | Beschreibung |
|---|---|
| GetRefAxisParams | Liefert Anfangs- und Endpunkt der Referenzachse. |
| GetTempAxisReferenceFace | Liefert die Fläche, aus der die temporäre Achse entsteht. |
| IsTempAxis | Liefert, 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.