Objekt · SldWorks
RefAxisFeatureData-Objekt
Die Definition einer Referenzachse: wie sie festgelegt ist und die Elemente, auf die sie sich stützt.
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
Feature.GetDefinition: bei einem Feature mit dem TypnamenRefAxis
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 SubBemerkungen
Ä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
| Name | Beschreibung |
|---|---|
| Type | Liest 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
| Name | Beschreibung |
|---|---|
| AccessSelections | Setzt das Modell vor die Referenzachse zurück, damit du die Auswahlen lesen und ändern kannst, die sie festlegen. |
| GetSelections | Liefert die Elemente, die die Referenzachse festlegen, und ihre Auswahlarten. |
| GetSelectionsCount | Liefert die Zahl der Elemente, die die Referenzachse festlegen. |
| ReleaseSelectionAccess | Hebt den Rücksetz-Zustand nach AccessSelections wieder auf, wenn du die Referenzachse nicht geändert hast. |
| SetSelections | Setzt 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.