SolidWorksMakroprogrammierung

Objekt · SldWorks

SurfaceKnitFeatureData-Objekt

Die Definition des Features „Oberfläche zusammenfügen“: die Flächen und Oberflächen, die Toleranz, die Spaltfilter und ob ein Volumenkörper entstehen soll.

Deklaration Dim x As SldWorks.SurfaceKnitFeatureData · in der englischen .NET-Hilfe: ISurfaceKnitFeatureData

Beschreibung

SurfaceKnitFeatureData gibt Zugriff auf ein Feature „Oberfläche zusammenfügen“. Es fügt angrenzende Flächen und Oberflächen zu einer Oberfläche zusammen und macht daraus auf Wunsch einen Volumenkörper. Die Toleranz legt fest, welche Spalten noch geschlossen werden. Die Grundbefehle gibt es seit SOLIDWORKS 2001Plus SP01, Toleranz, Spaltfilter und die übrigen Optionen seit SOLIDWORKS 2010.

Zugriff

Beispiel

' Gibt die Daten des ausgewählten Features „Oberfläche zusammenfügen“ aus und
' schaltet „Volumenkörper erstellen“ ein.
' Vorbedingung: Ein Teil mit einem Feature „Oberfläche zusammenfügen“ ist offen,
'               das Feature ist im FeatureManager ausgewählt.
' Ergebnis:     Die Werte stehen im Direktfenster, das Feature ist geändert.
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.SurfaceKnitFeatureData

    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 <> "SewRefSurface" Then Exit Sub

    Set swDaten = swFeat.GetDefinition
    If False = swDaten.AccessSelections(swModel, Nothing) Then Exit Sub
    Debug.Print swFeat.Name & ": " & swDaten.GetEntitiesCount & " Fläche(n)/Oberfläche(n)"
    Debug.Print "Toleranz: " & swDaten.KnitTolerance * 1000 & " mm, Spaltfilter " & swDaten.UseGapFilters
    If swDaten.UseGapFilters Then
        Debug.Print "Spaltbereich: " & swDaten.MinValueForGapRange * 1000 & " bis " & _
                    swDaten.MaxValueForGapRange * 1000 & " mm"
    End If

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

Bemerkungen

Anlegen: Das Feature legst du mit FeatureManager.InsertSewRefSurface an, nachdem du die Oberflächen mit der Markierung 1 ausgewählt hast. So macht es das Hilfebeispiel „Create Surface Knit Feature“.

Ändern: Nach SurfaceKnitFeatureData.AccessSelections setzt du die Werte und rufst Feature.ModifyDefinition auf. Änderst du nichts, rufst du SurfaceKnitFeatureData.ReleaseSelectionAccess auf. Das Hilfebeispiel „Get Knit Surface Data“ geht so vor.

Einheiten: Die Hilfe nennt die Grenzen für Toleranz und Spaltbereich in Millimetern. Die Hilfebeispiele rechnen die Werte mit * 1000 in Millimeter um, die Eigenschaften liefern also Meter (InsertSewRefSurface mit 0.0000025 ergab KnitTolerance 0,0025 mm, MinValueForGapRange = 0.000001 ergab 0,001 mm).

Eigenschaften und Methoden

Eigenschaften 8, davon 8 beschrieben

NameBeschreibung
EntitiesLiest oder setzt die Flächen und Oberflächen, die das Feature „Oberfläche zusammenfügen“ zusammenfügt.
KnitToleranceLiest oder setzt die Toleranz, bis zu der das Feature „Oberfläche zusammenfügen“ Spalten schließt.
MaxValueForGapRangeLiest oder setzt die obere Grenze des Spaltbereichs für das Feature „Oberfläche zusammenfügen“.
MinValueForGapRangeLiest oder setzt die untere Grenze des Spaltbereichs für das Feature „Oberfläche zusammenfügen“.
SeedFaceLiest oder setzt die Startfläche des Features „Oberfläche zusammenfügen“.
UseGapFiltersLiest oder setzt, ob das Feature „Oberfläche zusammenfügen“ Spaltfilter nutzt.
UseMergeEntitiesLiest oder setzt, ob das Feature „Oberfläche zusammenfügen“ Kanten und Flächen zusammenführt und überzählige Eckpunkte und Kanten entfernt.
UseTryToFormSolidLiest oder setzt, ob das Feature „Oberfläche zusammenfügen“ versucht, einen Volumenkörper zu bilden.

Methoden 3, davon 3 beschrieben

NameBeschreibung
AccessSelectionsSetzt das Modell vor das Feature „Oberfläche zusammenfügen“ zurück, damit du die Auswahlen lesen und ändern kannst, die es festlegen.
GetEntitiesCountLiefert die Zahl der Flächen und Oberflächen, die das Feature „Oberfläche zusammenfügen“ zusammenfügt.
ReleaseSelectionAccessHebt den Rücksetz-Zustand nach AccessSelections wieder auf, wenn du das Feature „Oberfläche zusammenfügen“ nicht geändert hast.

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: ISurfaceKnitFeatureData in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)

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