SolidWorksMakroprogrammierung

Objekt · SldWorks

RefAxisFeatureData-Objekt

Die Definition einer Referenzachse: wie sie festgelegt ist und die Elemente, auf die sie sich stützt.

Deklaration Dim x As SldWorks.RefAxisFeatureData · in der englischen .NET-Hilfe: IRefAxisFeatureData

Beschreibung

RefAxisFeatureData gibt Zugriff auf die Daten eines Referenzachsen-Features. Du liest und setzt damit, wie die Achse festgelegt ist (durch eine Linie, als Schnitt zweier Ebenen, durch zwei Punkte, als Mittelachse einer zylindrischen oder konischen Fläche oder durch einen Punkt senkrecht zu einer Ebene) und welche Elemente sie festlegen. Anfangs- und Endpunkt der Achse im Raum liefert dagegen RefAxis.GetRefAxisParams. Die Befehle gibt es seit SOLIDWORKS 2004.

Zugriff

Beispiel

' Gibt aus, wie die ausgewählte Referenzachse festgelegt ist und auf welche
' Elemente sie sich stützt.
' Vorbedingung: Ein Teil mit einer Referenzachse ist offen, die Achse ist im
'               FeatureManager ausgewählt.
' Ergebnis:     Die Angaben stehen im Direktfenster, das Teil bleibt unverändert.
Option Explicit

Sub main()
    Dim swApp As SldWorks.SldWorks
    Dim swModel As SldWorks.ModelDoc2
    Dim swSel As Object
    Dim swFeat As SldWorks.Feature
    Dim swDaten As SldWorks.RefAxisFeatureData
    Dim vElemente As Variant
    Dim vArten As Variant
    Dim i As Long

    Set swApp = Application.SldWorks
    Set swModel = swApp.ActiveDoc
    If swModel Is Nothing Then Exit Sub
    Set swSel = swModel.SelectionManager.GetSelectedObject6(1, -1)
    If Not TypeOf swSel Is SldWorks.Feature Then Exit Sub
    Set swFeat = swSel
    If swFeat.GetTypeName2 <> "RefAxis" Then Exit Sub

    Set swDaten = swFeat.GetDefinition
    Debug.Print swFeat.Name & ": Art " & swDaten.Type & " (swRefAxisType_e)"

    If False = swDaten.AccessSelections(swModel, Nothing) Then Exit Sub
    Debug.Print swDaten.GetSelectionsCount & " Element(e):"
    vElemente = swDaten.GetSelections(vArten)
    swDaten.ReleaseSelectionAccess
    If IsArray(vElemente) Then
        For i = 0 To UBound(vElemente)
            If TypeOf vElemente(i) Is SldWorks.Feature Then
                Debug.Print "  Feature " & vElemente(i).Name & ", Art " & vArten(i)
            Else
                Debug.Print "  Element der Art " & vArten(i) & " (swSelectType_e)"
            End If
        Next i
    End If
End Sub

Bemerkungen

Ändern: Nach RefAxisFeatureData.AccessSelections setzt du die Werte und rufst Feature.ModifyDefinition auf. Änderst du nichts, rufst du RefAxisFeatureData.ReleaseSelectionAccess auf.

Anlegen: Neue Referenzachsen legst du mit ModelDoc2.InsertAxis2 aus der Auswahl an. Die Methode liefert das Feature nicht zurück.

Achse und Definition: Zum selben Feature gibt es zwei Objekte. Feature.GetSpecificFeature2 liefert die Achse selbst (RefAxis) mit ihrer Lage, Feature.GetDefinition die Definition. Das Hilfebeispiel „Get Reference Axis Data“ holt beide zur ausgewählten Achse.

Elemente: Das Hilfebeispiel „Get Selections for Reference Axis Feature“ weist jedes Element einer Variablen vom Typ Feature zu. Das klappt nur, wenn die Achse auf Features wie Ebenen beruht. Das Beispiel hier prüft das deshalb mit TypeOf.

Eigenschaften und Methoden

Eigenschaften 1, davon 1 beschrieben

NameBeschreibung
TypeLiest oder setzt, wie die Referenzachse festgelegt ist, etwa durch eine Linie, zwei Ebenen, zwei Punkte oder eine zylindrische Fläche.

Methoden 5, davon 5 beschrieben

NameBeschreibung
AccessSelectionsSetzt das Modell vor die Referenzachse zurück, damit du die Auswahlen lesen und ändern kannst, die sie festlegen.
GetSelectionsLiefert die Elemente, die die Referenzachse festlegen, und ihre Auswahlarten.
GetSelectionsCountLiefert die Zahl der Elemente, die die Referenzachse festlegen.
ReleaseSelectionAccessHebt den Rücksetz-Zustand nach AccessSelections wieder auf, wenn du die Referenzachse nicht geändert hast.
SetSelectionsSetzt die Elemente, die die Referenzachse festlegen.

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

Siehe auch

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

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