SolidWorksMakroprogrammierung

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.

Deklaration Dim x As SldWorks.PartialEdgeFilletData · in der englischen .NET-Hilfe: IPartialEdgeFilletData

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

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 Sub

Bemerkungen

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:

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

NameBeschreibung
AlongEdgeDirectionLiefert, ob die teilweise Verrundung am Anfangs- oder am Endpunkt der Kante beginnt.
DistanceOffsetEndLiefert den Abstand der teilweisen Verrundung vom Endpunkt der Kante.
DistanceOffsetStartLiefert den Abstand der teilweisen Verrundung vom Anfangspunkt der Kante.
EndConditionLiefert, wie das Ende der teilweisen Verrundung festgelegt ist: ohne Versatz, als Abstand, als Prozentwert oder über ein Referenzelement.
PercentOffsetEndLiefert den Versatz der teilweisen Verrundung vom Endpunkt der Kante in Prozent.
PercentOffsetStartLiefert den Versatz der teilweisen Verrundung vom Anfangspunkt der Kante in Prozent.
ReferenceOffsetEndLiefert das Referenzelement, das das Ende der teilweisen Verrundung festlegt: Skizzenpunkt, Referenzpunkt oder ebene Fläche.
ReferenceOffsetEndTypeLiefert, welche Art von Element das Referenzelement für das Ende der teilweisen Verrundung ist.
ReferenceOffsetStartLiefert das Referenzelement, das den Anfang der teilweisen Verrundung festlegt: Skizzenpunkt, Referenzpunkt oder ebene Fläche.
ReferenceOffsetStartTypeLiefert, welche Art von Element das Referenzelement für den Anfang der teilweisen Verrundung ist.
StartConditionLiefert, wie der Anfang der teilweisen Verrundung festgelegt ist: ohne Versatz, als Abstand, als Prozentwert oder über ein Referenzelement.

Methoden 1, davon 1 beschrieben

NameBeschreibung
SetPartialFilletParametersSetzt 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.