SolidWorksMakroprogrammierung

Objekt · SldWorks

ChamferFeatureData2-Objekt

Die Feature-Daten einer Fase: Art, Abstände und Winkel sowie die Kanten, Flächen, Schleifen oder der Eckpunkt, an denen sie liegt.

Deklaration Dim x As SldWorks.ChamferFeatureData2 · in der englischen .NET-Hilfe: IChamferFeatureData2

Beschreibung

ChamferFeatureData2 gibt Zugriff auf ein Fasen-Feature. Es ersetzt das veraltete ChamferFeatureData. Eine Kantenfase liegt an Kanten, Flächen oder Schleifen und hat einen Abstand und einen Winkel oder zwei Abstände. Eine Eckpunktfase liegt an einem Eckpunkt und hat drei Abstände.

Zugriff

Neu anlegen kannst du eine Fase mit FeatureManager.InsertFeatureChamfer.

Beispiel

' Gibt Art, Abstände und Winkel der ausgewählten Fase aus und zeigt für jede Kante,
' ob die Fase dort umgedreht ist.
' Vorbedingung: Ein Teil ist offen, eine Fase ist im FeatureManager ausgewählt.
' Ergebnis:     Die Werte stehen im Direktfenster, das Teil bleibt unverändert.
Option Explicit

Sub main()
    Const PI As Double = 3.14159265358979
    Dim swApp As SldWorks.SldWorks
    Dim swModel As SldWorks.ModelDoc2
    Dim swSel As Object
    Dim swFeat As SldWorks.Feature
    Dim swChamfer As SldWorks.ChamferFeatureData2
    Dim vKanten 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 <> "Chamfer" Then Exit Sub
    Set swChamfer = swFeat.GetDefinition

    Debug.Print swFeat.Name & ", Art " & swChamfer.Type
    Select Case swChamfer.Type
        Case swChamferAngleDistance
            Debug.Print "  Abstand " & swChamfer.GetEdgeChamferDistance(0) * 1000 & " mm, Winkel " & _
                        Round(swChamfer.EdgeChamferAngle * 180 / PI, 1) & "°"
        Case swChamferDistanceDistance
            Debug.Print "  Abstände " & swChamfer.GetEdgeChamferDistance(0) * 1000 & " und " & _
                        swChamfer.GetEdgeChamferDistance(1) * 1000 & " mm"
        Case swChamferVertex
            For i = 0 To 2
                Debug.Print "  Abstand " & i & ": " & swChamfer.GetVertexChamferDistance(i) * 1000 & " mm"
            Next i
    End Select

    If swChamfer.AccessSelections(swModel, Nothing) Then      ' für Kanten, Flächen, Schleifen und Eckpunkt
        vKanten = swChamfer.Edges
        If Not IsEmpty(vKanten) Then
            For i = 0 To UBound(vKanten)
                Debug.Print "  Kante " & i & " umgedreht: " & swChamfer.GetIsFlipped(vKanten(i))
            Next i
        End If
        swChamfer.ReleaseSelectionAccess
    End If
End Sub

Bemerkungen

Arten: Fasen mit Winkel und Abstand und mit zwei Abständen sind Kantenfasen, alle Maße gehen von der Kante aus. Eine Eckpunktfase geht nur an einem Eckpunkt mit drei angrenzenden Kanten gleicher Wölbung. Bei gekrümmten Kanten ist ihr Abstand eine Bogenlänge, keine Sehne.

Lesen und Ändern: Die Hilfebeispiele lesen Art, Abstände und Winkel direkt nach Feature.GetDefinition. Erst für Kanten, Flächen, Schleifen und Eckpunkt rufen sie ChamferFeatureData2.AccessSelections auf und danach ChamferFeatureData2.ReleaseSelectionAccess. Änderungen übernimmst du mit Feature.ModifyDefinition.

Einheiten: Die Seiten nennen keine Einheiten. Die Hilfebeispiele rechnen Abstände als Meter in Millimeter und den Winkel vom Bogenmaß in Grad um. In SOLIDWORKS 2024 waren es Meter und Bogenmaß.

Fehler in der Hilfe: ChamferFeatureData2.SetIsFlipped ist dort mit „Gets whether the chamfer feature is flipped“ beschrieben, ihr Parameter Entity mit „Chamfer feature“.

Eine Fase mit zwei Abständen legt FeatureManager.InsertFeatureChamfer nur an, wenn die Abstände in Width und OtherDist stehen. Mit VertexChamDist1 und VertexChamDist2 liefert der Befehl Nothing.

Eigenschaften und Methoden

Eigenschaften 11, davon 11 beschrieben

NameBeschreibung
EdgeChamferAngleLiest oder setzt den Winkel einer Fase mit Winkel und Abstand.
EdgesLiest oder setzt die Kanten, an denen die Fase liegt.
EqualDistanceLiest oder setzt, ob für die Abstände der Fase ein einziger Wert gilt.
FacesLiest oder setzt die Flächen, an denen die Fase liegt.
KeepFeaturesLiest oder setzt, ob vorhandene Features an den gewählten Elementen erhalten bleiben.
LoopCountLiefert die Zahl der Schleifen (Loops), an denen die Fase liegt.
LoopsLiest oder setzt die Schleifen (Loops), an denen die Fase liegt.
PropagateFeatureToPartsLiest oder setzt, ob die Fase in einer Baugruppe auf alle betroffenen Teile übertragen wird.
TangentPropagationLiest oder setzt, ob die Fase auf alle Flächen fortgesetzt wird, die tangential an die gewählten Flächen oder Kanten anschließen.
TypeLiest oder setzt die Art der Fase, etwa Winkel und Abstand, zwei Abstände oder Eckpunkt.
VertexLiest oder setzt den Eckpunkt einer Eckpunktfase.

Methoden 10, davon 10 beschrieben

NameBeschreibung
AccessSelectionsSetzt das Modell vor die Fase zurück, damit du die Kanten, Flächen, Schleifen und den Eckpunkt lesen und ändern kannst.
GetEdgeChamferDistanceLiefert den Abstand der Kantenfase auf einer Seite der Kante.
GetEdgeCountLiefert die Zahl der Kanten, an denen die Fase liegt.
GetFaceCountLiefert die Zahl der Flächen, an denen die Fase liegt.
GetIsFlippedLiefert, ob die Fase an einer Kante, Fläche oder Schleife umgedreht ist.
GetVertexChamferDistanceLiefert einen der drei Abstände einer Eckpunktfase.
ReleaseSelectionAccessHebt den Rücksetz-Zustand nach AccessSelections wieder auf, wenn du die Fase nicht geändert hast.
SetEdgeChamferDistanceSetzt den Abstand der Kantenfase auf einer Seite der Kante.
SetIsFlippedDreht die Fase an einer Kante, Fläche oder Schleife um oder setzt die Richtung zurück.
SetVertexChamferDistanceSetzt einen der drei Abstände einer Eckpunktfase.

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

Siehe auch

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

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