Objekt · SldWorks
SurfaceCutFeatureData-Objekt
Der .NET-Name der Definition des Features „Mit Oberfläche schneiden“. In VBA heißt das Objekt SurfCutFeatureData.
Beschreibung
SurfaceCutFeatureData (ISurfaceCutFeatureData) gibt Zugriff auf die Definition eines Features „Mit Oberfläche schneiden“. Unter diesem Namen beschreibt die .NET-Hilfe die Befehle. Für den Zugriff musst du die Variable aber als SurfCutFeatureData deklarieren, und nur unter diesem Namen hat die VBA-Hilfe eine Syntax. In VBA-Makros nimmst du deshalb SurfCutFeatureData; dort stehen die Befehle ausführlich. Die meisten Befehle gibt es seit SOLIDWORKS 2001Plus, die für Mehrkörperteile seit SOLIDWORKS 2013 SP01.
Zugriff
Feature.GetDefinition: bei einem Feature mit dem TypnamenSurfCut, in VBA einer Variablen vom TypSurfCutFeatureDatazugewiesen
Beispiel
' Schneidet alle Körper mit der ausgewählten Ebene und gibt die Einstellungen
' des neuen Features aus, wie im Hilfebeispiel „Insert Surface-cut Feature“.
' Vorbedingung: Ein Teil mit Volumenkörpern ist offen, eine Ebene oder Fläche,
' die sie schneidet, ist ausgewählt.
' Ergebnis: Ein neues Feature „Mit Oberfläche schneiden“, die Werte stehen im
' Direktfenster.
Option Explicit
Sub main()
Dim swApp As SldWorks.SldWorks
Dim swModel As SldWorks.ModelDoc2
Dim swFeat As SldWorks.Feature
Dim swDaten As SldWorks.SurfCutFeatureData ' nicht SurfaceCutFeatureData
Dim nFehler As Long
Set swApp = Application.SldWorks
Set swModel = swApp.ActiveDoc
If swModel Is Nothing Then Exit Sub
Set swFeat = swModel.FeatureManager.InsertCutSurface(False, 0, False, True, Nothing, nFehler)
If swFeat Is Nothing Then
Debug.Print "Kein Feature, Fehlercode " & nFehler
Exit Sub
End If
Set swDaten = swFeat.GetDefinition
Debug.Print swFeat.Name & ": Körperauswahl " & swDaten.FeatureScope & _
", " & swDaten.GetFeatureScopeBodiesCount & " Körper, automatisch " & swDaten.AutoSelect
End SubBemerkungen
Welcher Name: Die Befehle sind unter beiden Namen dieselben. Auf den Seiten von SurfaceCutFeatureData steht die Syntax von SurfCutFeatureData, weil die VBA-Hilfe nur diese hat. Die Beispiele deklarieren deshalb SurfCutFeatureData.
Mehr dazu: Die Hilfe verweist auf das Thema „Accessing Selections that Define Features“.
Die Werte für FeatureScope und AutoSelect, die du an FeatureManager.InsertCutSurface übergibst, kommen nicht unbedingt im Feature an: Mit FeatureScope False und AutoSelect True hatte das neue Feature FeatureScope True und AutoSelect False.
Eigenschaften und Methoden
Eigenschaften 5, davon 5 beschrieben
| Name | Beschreibung |
|---|---|
| AutoSelect | Liest oder setzt, ob das Feature „Mit Oberfläche schneiden“ in einem Mehrkörperteil automatisch alle Körper schneidet. |
| FeatureScope | Liest oder setzt, ob das Feature „Mit Oberfläche schneiden“ in einem Mehrkörperteil nur bestimmte Körper schneidet. |
| FeatureScopeBodies | Liest oder setzt die Volumenkörper, die das Feature „Mit Oberfläche schneiden“ in einem Mehrkörperteil schneidet. |
| Flip | Liest oder setzt, ob das Feature „Mit Oberfläche schneiden“ die andere Seite wegschneidet. |
| SurfaceForCut | Liest oder setzt die Fläche, mit der das Feature „Mit Oberfläche schneiden“ die Körper schneidet. |
Methoden 4, davon 4 beschrieben
| Name | Beschreibung |
|---|---|
| AccessSelections | Setzt das Modell vor das Feature „Mit Oberfläche schneiden“ zurück, damit du die Auswahlen lesen und ändern kannst. |
| GetBodyIndexKept | Liefert die Nummer des Teils, der beim Schneiden bleibt, wenn das Ergebnis nicht eindeutig ist. |
| GetFeatureScopeBodiesCount | Liefert die Zahl der Körper, die das Feature „Mit Oberfläche schneiden“ schneidet. |
| ReleaseSelectionAccess | Hebt 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
Englisches Original: ISurfaceCutFeatureData in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)
Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.