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.
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
Feature.GetDefinition: aus einem Fasen-Feature (TypnameChamfer)
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 SubBemerkungen
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
| Name | Beschreibung |
|---|---|
| EdgeChamferAngle | Liest oder setzt den Winkel einer Fase mit Winkel und Abstand. |
| Edges | Liest oder setzt die Kanten, an denen die Fase liegt. |
| EqualDistance | Liest oder setzt, ob für die Abstände der Fase ein einziger Wert gilt. |
| Faces | Liest oder setzt die Flächen, an denen die Fase liegt. |
| KeepFeatures | Liest oder setzt, ob vorhandene Features an den gewählten Elementen erhalten bleiben. |
| LoopCount | Liefert die Zahl der Schleifen (Loops), an denen die Fase liegt. |
| Loops | Liest oder setzt die Schleifen (Loops), an denen die Fase liegt. |
| PropagateFeatureToParts | Liest oder setzt, ob die Fase in einer Baugruppe auf alle betroffenen Teile übertragen wird. |
| TangentPropagation | Liest oder setzt, ob die Fase auf alle Flächen fortgesetzt wird, die tangential an die gewählten Flächen oder Kanten anschließen. |
| Type | Liest oder setzt die Art der Fase, etwa Winkel und Abstand, zwei Abstände oder Eckpunkt. |
| Vertex | Liest oder setzt den Eckpunkt einer Eckpunktfase. |
Methoden 10, davon 10 beschrieben
| Name | Beschreibung |
|---|---|
| AccessSelections | Setzt das Modell vor die Fase zurück, damit du die Kanten, Flächen, Schleifen und den Eckpunkt lesen und ändern kannst. |
| GetEdgeChamferDistance | Liefert den Abstand der Kantenfase auf einer Seite der Kante. |
| GetEdgeCount | Liefert die Zahl der Kanten, an denen die Fase liegt. |
| GetFaceCount | Liefert die Zahl der Flächen, an denen die Fase liegt. |
| GetIsFlipped | Liefert, ob die Fase an einer Kante, Fläche oder Schleife umgedreht ist. |
| GetVertexChamferDistance | Liefert einen der drei Abstände einer Eckpunktfase. |
| ReleaseSelectionAccess | Hebt den Rücksetz-Zustand nach AccessSelections wieder auf, wenn du die Fase nicht geändert hast. |
| SetEdgeChamferDistance | Setzt den Abstand der Kantenfase auf einer Seite der Kante. |
| SetIsFlipped | Dreht die Fase an einer Kante, Fläche oder Schleife um oder setzt die Richtung zurück. |
| SetVertexChamferDistance | Setzt 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.