SolidWorksMakroprogrammierung

Objekt · SldWorks

RipFeatureData-Objekt

Die Definition einer Trennung (Riss) in einem Blechteil: die getrennten Kanten, die Richtung je Kante und der Spalt.

Deklaration Dim x As SldWorks.RipFeatureData · in der englischen .NET-Hilfe: IRipFeatureData

Beschreibung

RipFeatureData gibt Zugriff auf ein Feature Trennung (rip). Es trennt einen Körper, etwa eine Schale, an ausgewählten Kanten auf, damit daraus ein Blechteil werden kann. Je Kante legst du fest, in welche Richtung getrennt wird, und für alle Kanten die Breite des Spalts. Die Befehle gibt es seit SOLIDWORKS 2001Plus SP01.

Zugriff

Beispiel

' Gibt Spalt und Richtung je Kante der ausgewählten Trennung aus und setzt den
' Spalt auf 0,2 mm.
' Vorbedingung: Ein Teil mit einer Trennung ist offen, das Feature ist im
'               FeatureManager ausgewählt.
' Ergebnis:     Der Spalt ist 0,2 mm breit, die alten Werte stehen im Direktfenster.
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.RipFeatureData
    Dim swKante As SldWorks.Edge
    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 <> "Rip" Then Exit Sub

    Set swDaten = swFeat.GetDefinition
    Debug.Print swFeat.Name & ": Spalt " & swDaten.Gap * 1000 & " mm"
    If False = swDaten.AccessSelections(swModel, Nothing) Then Exit Sub
    If swDaten.GetEdgesCount > 0 Then
        vKanten = swDaten.Edges
        For i = 0 To UBound(vKanten)
            Set swKante = vKanten(i)
            Debug.Print "  Kante " & i + 1 & ": Richtung " & swDaten.GetDirection(swKante)   ' 0, 1 oder 2
        Next i
    End If

    swDaten.Gap = 0.0002
    If False = swFeat.ModifyDefinition(swDaten, swModel, Nothing) Then swDaten.ReleaseSelectionAccess
End Sub

Bemerkungen

Anlegen: Eine neue Trennung legst du mit ModelDoc2.InsertRip an. Das Hilfebeispiel „Access Edges on Rip Feature“ macht aus einem Quader eine Schale, wählt eine Kante mit der Markierung 64 (beide Richtungen) aus und trennt sie mit einem Spalt von 0.0001. Danach liest es Spalt, Kanten und Richtungen und wählt die Kanten aus.

Ändern: Nach RipFeatureData.AccessSelections setzt du die Werte und rufst Feature.ModifyDefinition auf. Änderst du nichts, rufst du RipFeatureData.ReleaseSelectionAccess auf. Für Kanten und Richtungen verweist die Hilfe auf das Thema „Accessing Selections that Define Features“.

Richtungen: RipFeatureData.GetDirection und RipFeatureData.SetDirection kennen 0 (diese Richtung), 1 (die andere Richtung) und 2 (beide Richtungen). Eine Konstante dafür nennt die Hilfe nicht.

Einheiten: Für den Spalt nennt die Hilfe keine Einheit. Es sind Meter, das Hilfebeispiel rechnet mit 1000 in Millimeter um.

Eigenschaften und Methoden

Eigenschaften 2, davon 2 beschrieben

NameBeschreibung
EdgesLiest oder setzt die Kanten, an denen die Trennung den Körper auftrennt.
GapLiest oder setzt die Breite des Spalts an den getrennten Kanten.

Methoden 5, davon 5 beschrieben

NameBeschreibung
AccessSelectionsSetzt das Modell vor die Trennung zurück, damit du die Auswahlen lesen und ändern kannst, die sie festlegen.
GetDirectionLiefert, in welche Richtung die Trennung an einer Kante verläuft.
GetEdgesCountLiefert die Zahl der Kanten der Trennung.
ReleaseSelectionAccessHebt den Rücksetz-Zustand nach AccessSelections wieder auf, wenn du die Trennung nicht geändert hast.
SetDirectionLegt fest, in welche Richtung die Trennung an einer Kante verläuft.

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

Siehe auch

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

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