Objekt · SldWorks
SimpleFilletFeatureData2-Objekt
Die Definition einer Verrundung mit konstantem Radius, einer Flächenverrundung oder einer vollständigen Rundung: Elemente, Radien, Profil, Rücksetzabstände und Teilkanten.
Beschreibung
SimpleFilletFeatureData2 gibt Zugriff auf eine einfache Verrundung. Dazu zählen drei Arten aus swSimpleFilletType_e: die Verrundung mit konstantem Radius, die Flächenverrundung und die vollständige Rundung (full round fillet). Mit dem Querschnittsprofil swFeatureFilletConicRhoZeroChamfer legst du über dasselbe Objekt auch eine Fase mit Flächenversatz oder eine Fase zwischen zwei Flächen an. Eine Verrundung kann symmetrisch sein (ein Radius) oder asymmetrisch (Abstand 1 und Abstand 2). Die ältesten Befehle gibt es seit SOLIDWORKS 2001Plus, die für kegelige und asymmetrische Verrundungen seit 2014 und 2015, die für Teilkanten seit 2020.
Zugriff
FeatureManager.CreateDefinitionmitswFmFillet: eine neue Definition, die du mitSimpleFilletFeatureData2.Initializevorbereitest und mitFeatureManager.CreateFeatureanlegstFeature.GetDefinition: bei einer Verrundung mit dem TypnamenFillet
Beispiel
' Gibt Art, Profil und Radien der ausgewählten Verrundung aus und vergrößert den
' vorgegebenen Radius um 1 mm.
' Vorbedingung: Ein Teil mit einer Verrundung mit konstantem Radius ist offen, die
' Verrundung ist im FeatureManager ausgewählt.
' Ergebnis: Die Werte stehen im Direktfenster, der Radius ist 1 mm größer.
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.SimpleFilletFeatureData2
Dim swElement As Object
Dim i As Integer
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 <> "Fillet" Then Exit Sub
Set swDaten = swFeat.GetDefinition
If False = swDaten.AccessSelections(swModel, Nothing) Then Exit Sub
Debug.Print swFeat.Name & ": Art " & swDaten.Type & ", Profil " & swDaten.ConicTypeForCrossSectionProfile & _
", " & IIf(swDaten.AsymmetricFillet, "asymmetrisch", "symmetrisch")
Debug.Print "Vorgabe: " & swDaten.DefaultRadius * 1000 & " mm, " & swDaten.GetEdgeCount & " Kanten"
If swDaten.IsMultipleRadius Then
For i = 0 To swDaten.FilletItemsCount - 1
Set swElement = swDaten.GetFilletItemAtIndex(i)
If Not swElement Is Nothing Then
Debug.Print "Element " & i & ": " & swDaten.GetRadius(swElement) * 1000 & " mm"
End If
Next i
End If
If swDaten.Type = swConstRadiusFillet And False = swDaten.IsMultipleRadius Then
swDaten.DefaultRadius = swDaten.DefaultRadius + 0.001
If False = swFeat.ModifyDefinition(swDaten, swModel, Nothing) Then swDaten.ReleaseSelectionAccess
Else
swDaten.ReleaseSelectionAccess
End If
End SubBemerkungen
Anlegen: Mit FeatureManager.CreateDefinition und swFmFillet holst du eine neue Definition und rufst SimpleFilletFeatureData2.Initialize mit swConstRadiusFillet, swFaceFillet oder swFullRoundFillet auf. Dann legst du mit SimpleFilletFeatureData2.ConicTypeForCrossSectionProfile das Profil fest. Vor FeatureManager.CreateFeature wählst du mit ModelDocExtension.SelectByID2 aus:
- Verrundung mit konstantem Radius oder Fase mit Flächenversatz: Kanten, Flächen, Features oder Schleifen mit der Markierung
1; dazu setzt duSimpleFilletFeatureData2.OverflowType - Flächenverrundung oder Fase zwischen zwei Flächen: Flächensatz 1 mit
2, Flächensatz 2 mit4, Haltelinien mit8 - vollständige Rundung: Flächensatz 1 mit
2, mittlerer Flächensatz mit512, Flächensatz 2 mit4
Das Hilfebeispiel zum Objekt legt so eine asymmetrische Flächenverrundung an, das Beispiel zu PartialEdgeFilletData eine Fase auf Teilkanten.
Ändern: Nach SimpleFilletFeatureData2.AccessSelections setzt du die Werte und rufst Feature.ModifyDefinition auf. Änderst du nichts, rufst du SimpleFilletFeatureData2.ReleaseSelectionAccess auf.
Was wann gilt: Steht SimpleFilletFeatureData2.CurvatureContinuous auf True, gelten SimpleFilletFeatureData2.RoundCorners und das Querschnittsprofil nicht. Mehrere Radien (SimpleFilletFeatureData2.IsMultipleRadius) gibt es nur bei symmetrischen Verrundungen mit konstantem Radius und symmetrischen Fasen mit Flächenversatz.
Einheiten: Für Radien und Abstände nennt die Hilfe keine Einheit. Es sind wie sonst in der API Meter, das Hilfebeispiel setzt 0.01 und 0.02.
Mehr dazu: Die Hilfe verweist auf die Themen „Fillets“, „Constant Size Fillets“, „Face Fillets“, „Full Round Fillets“ und den PropertyManager „Chamfer“ in der Hilfe zur Oberfläche und bei vielen Befehlen auf „Accessing Selections that Define Features“.
Eigenschaften und Methoden
Eigenschaften 24, davon 24 beschrieben
| Name | Beschreibung |
|---|---|
| AsymmetricFillet | Liest oder setzt, ob die Verrundung oder Fase asymmetrisch ist, also mit Abstand 1 und Abstand 2 statt einem Radius. |
| ConicTypeForCrossSectionProfile | Liest oder setzt das Querschnittsprofil: kreisförmig, Kegelschnitt mit Rho-Wert oder Radius, oder Fase. |
| ConstantWidth | Liest oder setzt, ob die Verrundung eine konstante Breite hat. |
| CurvatureContinuous | Liest oder setzt, ob die Verrundung krümmungsstetig in die Nachbarflächen übergeht. |
| DefaultConicRhoOrRadius | Liest oder setzt den vorgegebenen Rho-Wert oder Kegelschnitt-Radius der Verrundung. |
| DefaultDistance | Liest oder setzt den vorgegebenen Abstand 2 einer asymmetrischen Verrundung oder Fase. |
| DefaultRadius | Liest oder setzt den vorgegebenen Radius einer symmetrischen Verrundung oder den Abstand 1 einer asymmetrischen. |
| Edges | Liest oder setzt die Kanten, die mit konstantem Radius verrundet werden. |
| EnablePartialEdgeParameters | Liest oder setzt, ob die Verrundung auf allen Kanten Teilkanten-Einstellungen zulässt. |
| Features | Liest oder setzt die Features, deren Kanten verrundet werden. |
| FilletItemsCount | Liefert die Zahl der Elemente einer Verrundung mit mehreren Radien. |
| HelpPoint | Liest oder setzt den Hilfspunkt, der bei einer Flächenverrundung oder Fase zwischen zwei Flächen die Seite festlegt. |
| HoldLines | Liest oder setzt die Haltelinien (Begrenzungen) einer Flächenverrundung. |
| IsMultipleRadius | Liest oder setzt, ob die symmetrische Verrundung oder Fase mehrere Radien hat, also je Element einen eigenen. |
| KeepFeatures | Liest oder setzt, ob vorhandene Features auf den verrundeten Elementen erhalten bleiben. |
| Loops | Liest oder setzt die Schleifen, deren Kanten verrundet werden. |
| OmitAttachedEdges | Liest, ob die Verrundung die Anschlusskanten des Features auslässt. |
| OverflowType | Liest oder setzt, wie sich die Verrundung verhält, wenn sie auf Nachbarflächen überläuft. |
| PropagateFeatureToParts | Liest oder setzt, ob die Verrundung in einer Baugruppe auf alle betroffenen Teile übertragen wird. |
| PropagateToTangentFaces | Liest oder setzt, ob die Verrundung auf alle tangential anschließenden Flächen fortgesetzt wird. |
| ReverseFaceNormal | Liest oder setzt die Option „Flächennormale umkehren“ für einen Flächensatz einer Flächenverrundung zwischen Flächenkörpern. |
| RoundCorners | Liest oder setzt, ob die Ecken der Verrundung gerundet werden. |
| TrimAndAttachSurfaces | Liest oder setzt, ob eine Flächenverrundung an Flächenkörpern die Flächen trimmt und zusammenfügt. |
| Type | Liefert die Art der Verrundung: konstanter Radius, Flächenverrundung oder vollständige Rundung. |
Methoden 26, davon 26 beschrieben
| Name | Beschreibung |
|---|---|
| AccessSelections | Setzt das Modell vor die Verrundung zurück, damit du die Auswahlen lesen und ändern kannst, die sie festlegen. |
| GetConicRhoOrRadius | Liefert den Rho-Wert oder Kegelschnitt-Radius an einem Element der Verrundung. |
| GetDistance | Liefert Abstand 2 an einem Element einer asymmetrischen Verrundung oder Fase. |
| GetEdgeCount | Liefert die Zahl der Kanten, die mit konstantem Radius verrundet werden. |
| GetFaceCount | Liefert die Zahl der Flächen in einem Flächensatz der Verrundung. |
| GetFaces | Liefert die Flächen eines Flächensatzes der Verrundung. |
| GetFeatureCount | Liefert die Zahl der Features, deren Kanten verrundet werden. |
| GetFilletItemAtIndex | Liefert ein Element einer Verrundung mit mehreren Radien: eine Kante, Fläche oder Schleife. |
| GetHoldLineCount | Liefert die Zahl der Haltelinien einer Flächenverrundung. |
| GetLoopCount | Liefert die Zahl der Schleifen, deren Kanten verrundet werden. |
| GetPartialEdgeFilletData | Liefert die Teilkanten-Einstellungen einer Kante der Verrundung. |
| GetRadius | Liefert den Radius einer symmetrischen Verrundung oder Abstand 1 einer asymmetrischen an einem Element. |
| GetSetbackDistanceCount | Liefert die Zahl der Rücksetzabstände an einem Eckpunkt, also auch die Zahl der Kanten dort. |
| GetSetbackVertexDistance | Liefert die Rücksetzabstände und die zugehörigen Kanten an einem Eckpunkt. |
| GetSetbackVertices | Liefert die Eckpunkte, an denen die Verrundung Rücksetzabstände hat. |
| GetSetbackVerticesCount | Liefert die Zahl der Eckpunkte mit Rücksetzabständen. |
| Initialize | Bereitet eine neue Definition auf eine Art vor: konstanter Radius, Flächenverrundung oder vollständige Rundung. |
| ReleaseSelectionAccess | Hebt den Rücksetz-Zustand nach AccessSelections wieder auf, wenn du die Verrundung nicht geändert hast. |
| RepairMissingReferences | Sucht fehlende Bezüge der Verrundung oder Fase und weist sie neuen Kanten zu. |
| SetConicRhoOrRadius | Setzt den Rho-Wert oder Kegelschnitt-Radius an einem Element der Verrundung. |
| SetDistance | Setzt Abstand 2 an einem Element einer asymmetrischen Verrundung oder Fase. |
| SetFaces | Setzt die Flächen eines Flächensatzes der Verrundung. |
| SetPartialEdgeFilletData | Setzt die Teilkanten-Einstellungen einer Kante der Verrundung oder entfernt sie. |
| SetRadius | Setzt den Radius einer symmetrischen Verrundung oder Abstand 1 einer asymmetrischen an einem Element. |
| SetSetbackVertexDistance | Setzt die Rücksetzabstände auf den Kanten an einem Eckpunkt, an dem mehrere Verrundungen zusammenkommen. |
| SetSetbackVertices | Legt die Eckpunkte fest, an denen die Verrundung Rücksetzabstände hat. |
Nicht aufgeführt sind 20 C++-Varianten (Namen mit I davor, zum Beispiel IAccessSelections). In VBA nimmst du immer den Befehl ohne I.
Siehe auch
Englisches Original: ISimpleFilletFeatureData2 in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)
Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.