Objekt · SldWorks
PartialEdgeFilletData-Objekt
Die Einstellungen einer teilweisen Verrundung oder Fase an einer Kante: an welchem Ende sie beginnt und wo Anfang und Ende liegen, als Abstand, Prozentwert oder über ein Referenzelement.
Beschreibung
PartialEdgeFilletData gibt Zugriff auf die Eigenschaften einer teilweisen Verrundung oder Fase (partial fillet/chamfer). Sie läuft nur über einen Teil einer Kante. Anfang und Ende legst du je mit einer Bedingung aus swSimpleFilletPartialEdgeCondition_e fest: als Abstand oder Prozentwert vom Anfangs- oder Endpunkt der Kante oder über ein Referenzelement (Skizzenpunkt, Referenzpunkt oder ebene Fläche). Teilweise Verrundungen gibt es bei Verrundungen mit konstantem Radius und bei Fasen mit Flächenversatz. Die Befehle gibt es seit SOLIDWORKS 2020.
Alle Eigenschaften sind nur lesbar. Ändern kannst du die Werte nur mit PartialEdgeFilletData.SetPartialFilletParameters.
Zugriff
SimpleFilletFeatureData2.GetPartialEdgeFilletData: die Einstellungen für eine Kante der Verrundung, wennSimpleFilletFeatureData2.EnablePartialEdgeParametersTrueist
Zurück an die Verrundung gibst du sie mit SimpleFilletFeatureData2.SetPartialEdgeFilletData. Einen anderen Zugriff nennt die Hilfe nicht, auch nicht bei VariableFilletFeatureData2 oder ChamferFeatureData2.
Beispiel
' Verrundet die ausgewählte Kante mit 2 mm Radius, aber nur auf einem Teil:
' von 25 % hinter dem Anfangspunkt bis 25 % vor dem Endpunkt.
' Vorbedingung: Ein Teil ist offen, eine Kante ist ausgewählt.
' Ergebnis: Eine neue Verrundung auf dem mittleren Teil der Kante, der
' Fehlercode steht im Direktfenster.
Option Explicit
Sub main()
Dim swApp As SldWorks.SldWorks
Dim swModel As SldWorks.ModelDoc2
Dim swSelMgr As SldWorks.SelectionMgr
Dim swSel As Object
Dim swKante As SldWorks.Edge
Dim swEnt As SldWorks.Entity
Dim swSelData As SldWorks.SelectData
Dim swDaten As SldWorks.SimpleFilletFeatureData2
Dim swTeil As SldWorks.PartialEdgeFilletData
Dim swFeat As SldWorks.Feature
Dim nFehler As Long
Dim bWarnung As Boolean
Set swApp = Application.SldWorks
Set swModel = swApp.ActiveDoc
If swModel Is Nothing Then Exit Sub
If swModel.GetType <> swDocPART Then Exit Sub
Set swSelMgr = swModel.SelectionManager
Set swSel = swSelMgr.GetSelectedObject6(1, -1)
If Not TypeOf swSel Is SldWorks.Edge Then Exit Sub
Set swKante = swSel
' Kante mit der Markierung 1 neu auswählen
Set swEnt = swKante
Set swSelData = swSelMgr.CreateSelectData
swSelData.Mark = 1
swModel.ClearSelection2 True
swEnt.Select4 False, swSelData
Set swDaten = swModel.FeatureManager.CreateDefinition(swFmFillet)
swDaten.Initialize swConstRadiusFillet
swDaten.OverflowType = swFilletOverFlowType_Default
swDaten.DefaultRadius = 0.002
swDaten.EnablePartialEdgeParameters = True
Set swTeil = swDaten.GetPartialEdgeFilletData(swKante)
If swTeil Is Nothing Then Exit Sub
nFehler = swTeil.SetPartialFilletParameters(True, swPartialEdgePercentOffset, 25, Nothing, _
swPartialEdgePercentOffset, 25, Nothing)
If nFehler <> swFeatureErrorNone Then
Debug.Print "SetPartialFilletParameters: Fehler " & nFehler
Exit Sub
End If
Debug.Print "Anfang " & swTeil.PercentOffsetStart & " %, Ende " & swTeil.PercentOffsetEnd & " %"
swDaten.SetPartialEdgeFilletData swKante, swTeil
Set swFeat = swModel.FeatureManager.CreateFeature(swDaten)
If swFeat Is Nothing Then
Debug.Print "Die Verrundung wurde nicht angelegt."
Exit Sub
End If
nFehler = swFeat.GetErrorCode2(bWarnung)
Debug.Print swFeat.Name & ": Fehlercode " & nFehler & IIf(bWarnung, " (Warnung)", "")
End SubBemerkungen
Anlegen: Nach SimpleFilletFeatureData2 bereitest du zuerst wie sonst eine Verrundung mit konstantem Radius oder eine Fase mit Flächenversatz vor: FeatureManager.CreateDefinition mit swFmFillet, SimpleFilletFeatureData2.Initialize und die Kanten mit der Markierung 1 auswählen. Dann setzt du SimpleFilletFeatureData2.EnablePartialEdgeParameters auf True und gehst für jede Kante so vor:
- die Einstellungen mit
SimpleFilletFeatureData2.GetPartialEdgeFilletDataholen - sie mit
PartialEdgeFilletData.SetPartialFilletParameterssetzen - sie mit
SimpleFilletFeatureData2.SetPartialEdgeFilletDatazurückgeben
Zum Schluss legst du das Feature mit FeatureManager.CreateFeature an. Eine Fase statt einer Verrundung entsteht, wenn du vorher SimpleFilletFeatureData2.ConicTypeForCrossSectionProfile auf swFeatureFilletConicRhoZeroChamfer setzt.
Fehler: Prüfe nach dem Anlegen mit Feature.GetErrorCode2, ob mit dem neuen Feature etwas nicht stimmt. Die Fehlerwerte zu teilweisen Verrundungen stehen in swFeatureError_e; auch SetPartialFilletParameters liefert einen Wert daraus.
Ändern: Nach dem Anlegen änderst du die Werte mit SetPartialFilletParameters. Wie die geänderten Werte in ein vorhandenes Feature kommen, sagt die Hilfe nicht; vermutlich wie sonst über SimpleFilletFeatureData2.AccessSelections, SetPartialEdgeFilletData und Feature.ModifyDefinition.
Anfang und Ende: Ob sich Anfangs- und Endpunkt in den übrigen Eigenschaften vertauschen, wenn PartialEdgeFilletData.AlongEdgeDirection False ist, sagt die Hilfe nicht.
Einheiten: Für die Abstände nennt die Hilfe keine Einheit. Es sind Meter (0,01 und 0,03 an einer 100-mm-Kante ergaben eine 60 mm lange Verrundung); das Hilfebeispiel setzt 0.01 und 0.03. Prozentwerte liegen zwischen 0 und unter 100.
Hilfebeispiel: „Create Partial Chamfer“ legt in Block20.sldprt eine Fase auf zwei Kanten an, jeweils mit dem Abstand 0.01 vom Anfangs- und 0.03 vom Endpunkt, also 10 und 30 mm. Das VBA-Beispiel steht in der Hilfe direkt auf der Seite zum Objekt. Es ruft SetPartialEdgeFilletData nicht auf und schreibt SetPartialFilletParameters mit Klammern, aber ohne Zuweisung; so nimmt der VBA-Editor die Zeile nicht an. Bei der zweiten Kante übergibt das VBA-Beispiel False für AlongEdgeDirection, das C#-Beispiel True.
Mehr dazu: Die Hilfe verweist auf den Abschnitt „Partial Edge Parameters“ im Thema „Constant Size Fillets“ und auf den PropertyManager „Chamfer“ in der Hilfe zur Oberfläche.
Eigenschaften und Methoden
Eigenschaften 11, davon 11 beschrieben
| Name | Beschreibung |
|---|---|
| AlongEdgeDirection | Liefert, ob die teilweise Verrundung am Anfangs- oder am Endpunkt der Kante beginnt. |
| DistanceOffsetEnd | Liefert den Abstand der teilweisen Verrundung vom Endpunkt der Kante. |
| DistanceOffsetStart | Liefert den Abstand der teilweisen Verrundung vom Anfangspunkt der Kante. |
| EndCondition | Liefert, wie das Ende der teilweisen Verrundung festgelegt ist: ohne Versatz, als Abstand, als Prozentwert oder über ein Referenzelement. |
| PercentOffsetEnd | Liefert den Versatz der teilweisen Verrundung vom Endpunkt der Kante in Prozent. |
| PercentOffsetStart | Liefert den Versatz der teilweisen Verrundung vom Anfangspunkt der Kante in Prozent. |
| ReferenceOffsetEnd | Liefert das Referenzelement, das das Ende der teilweisen Verrundung festlegt: Skizzenpunkt, Referenzpunkt oder ebene Fläche. |
| ReferenceOffsetEndType | Liefert, welche Art von Element das Referenzelement für das Ende der teilweisen Verrundung ist. |
| ReferenceOffsetStart | Liefert das Referenzelement, das den Anfang der teilweisen Verrundung festlegt: Skizzenpunkt, Referenzpunkt oder ebene Fläche. |
| ReferenceOffsetStartType | Liefert, welche Art von Element das Referenzelement für den Anfang der teilweisen Verrundung ist. |
| StartCondition | Liefert, wie der Anfang der teilweisen Verrundung festgelegt ist: ohne Versatz, als Abstand, als Prozentwert oder über ein Referenzelement. |
Methoden 1, davon 1 beschrieben
| Name | Beschreibung |
|---|---|
| SetPartialFilletParameters | Setzt alle Einstellungen der teilweisen Verrundung: an welchem Ende sie beginnt und wie Anfang und Ende festgelegt sind. |
Siehe auch
Englisches Original: IPartialEdgeFilletData in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)
Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.