SolidWorksMakroprogrammierung

Objekt · SldWorks

SurfCutFeatureData-Objekt

Die Definition des Features „Mit Oberfläche schneiden“: die schneidende Fläche, die Seite und die betroffenen Körper.

Deklaration Dim x As SldWorks.SurfCutFeatureData

Beschreibung

SurfCutFeatureData ist der VBA-Name der Definition eines Features „Mit Oberfläche schneiden“. Die Hilfe beschreibt die Befehle unter dem .NET-Namen SurfaceCutFeatureData und sagt dazu, dass du die Variable als SurfCutFeatureData deklarieren musst. Das Feature schneidet Volumenkörper mit einer Fläche oder Ebene ab. Die meisten Befehle gibt es seit SOLIDWORKS 2001Plus, die für Mehrkörperteile seit SOLIDWORKS 2013 SP01.

Zugriff

Beispiel

' Gibt die Einstellungen des ausgewählten Features „Mit Oberfläche schneiden“ aus
' und kehrt die Seite um, die weggeschnitten wird.
' Vorbedingung: Ein Teil mit einem Feature „Mit Oberfläche schneiden“ ist offen,
'               das Feature ist im FeatureManager ausgewählt.
' Ergebnis:     Die andere Seite ist weggeschnitten, die 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.SurfCutFeatureData

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

    Set swDaten = swFeat.GetDefinition
    Debug.Print swFeat.Name & ": umgekehrt " & swDaten.Flip & ", Körperauswahl " & swDaten.FeatureScope & _
                ", automatisch " & swDaten.AutoSelect & ", " & swDaten.GetFeatureScopeBodiesCount & " Körper"

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

Bemerkungen

Anlegen: Das Feature legst du mit FeatureManager.InsertCutSurface an, nachdem du die Fläche oder Ebene ausgewählt hast. So macht es das Hilfebeispiel „Insert Surface-cut Feature“.

Ändern: Nach SurfCutFeatureData.AccessSelections setzt du die Werte und rufst Feature.ModifyDefinition auf. Änderst du nichts, rufst du SurfCutFeatureData.ReleaseSelectionAccess auf. Das Hilfebeispiel „Modify Surface-cut Feature“ kehrt so die Seite um.

Name: Die .NET-Hilfe führt die Befehle unter SurfaceCutFeatureData (ISurfaceCutFeatureData). Die VBA-Hilfe hat nur unter SurfCutFeatureData eine Syntax, aber keine Beschreibung. Die Angaben auf diesen Seiten stammen deshalb aus der .NET-Hilfe.

Eigenschaften und Methoden

Eigenschaften 5, davon 5 beschrieben

NameBeschreibung
AutoSelectLiest oder setzt, ob das Feature „Mit Oberfläche schneiden“ in einem Mehrkörperteil automatisch alle Körper schneidet.
FeatureScopeLiest oder setzt, ob das Feature „Mit Oberfläche schneiden“ in einem Mehrkörperteil nur bestimmte Körper schneidet.
FeatureScopeBodiesLiest oder setzt die Volumenkörper, die das Feature „Mit Oberfläche schneiden“ in einem Mehrkörperteil schneidet.
FlipLiest oder setzt, ob das Feature „Mit Oberfläche schneiden“ die andere Seite wegschneidet.
SurfaceForCutLiest oder setzt die Fläche, mit der das Feature „Mit Oberfläche schneiden“ die Körper schneidet.

Methoden 4, davon 4 beschrieben

NameBeschreibung
AccessSelectionsSetzt das Modell vor das Feature „Mit Oberfläche schneiden“ zurück, damit du die Auswahlen lesen und ändern kannst, die es festlegen.
GetBodyIndexKeptLiefert die Nummer des Teils, der beim Schneiden bleibt, wenn das Ergebnis nicht eindeutig ist.
GetFeatureScopeBodiesCountLiefert die Zahl der Körper, die das Feature „Mit Oberfläche schneiden“ schneidet.
ReleaseSelectionAccessHebt den Rücksetz-Zustand nach AccessSelections wieder auf, wenn du das Feature „Mit Oberfläche schneiden“ 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

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