Objekt · SldWorks
SurfaceTrimFeatureData-Objekt
Die Definition des Features „Oberfläche trimmen“: Art des Trimmens, Trimmwerkzeuge und die Teile, die bleiben.
Beschreibung
SurfaceTrimFeatureData gibt Zugriff auf ein Feature „Oberfläche trimmen“. Es trimmt Oberflächen entweder mit einem Trimmwerkzeug (Fläche, Ebene oder Skizze) oder gegenseitig untereinander. Über das Objekt liest du die Art, die Trimmwerkzeuge und die Teile, die bleiben. Ändern lassen sich die Werte nicht, die Eigenschaften sind nur lesbar. Die Befehle gibt es seit SOLIDWORKS 2001Plus SP02.
Zugriff
Feature.GetDefinition: bei einem Feature mit dem TypnamenTrimRefSurface
Beispiel
' Gibt Art, Trimmwerkzeuge und Zahl der behaltenen Teile des ausgewählten
' Features „Oberfläche trimmen“ aus.
' Vorbedingung: Ein Teil mit einem Feature „Oberfläche trimmen“ ist offen, das
' Feature ist im FeatureManager ausgewählt.
' Ergebnis: Die Werte stehen im Direktfenster (Strg+G).
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.SurfaceTrimFeatureData
Dim vWerkzeuge 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 <> "TrimRefSurface" Then Exit Sub
Set swDaten = swFeat.GetDefinition
If False = swDaten.AccessSelections(swModel, Nothing) Then Exit Sub
Debug.Print swFeat.Name & ": " & IIf(swDaten.GetType = swTypeMutualTrim, "gegenseitig", "mit Trimmwerkzeug") & _
", " & swDaten.GetPiecesToKeepCount & " behaltene(s) Teil(e)"
vWerkzeuge = swDaten.TrimTools
For i = 0 To swDaten.GetTrimToolsCount - 1
If TypeName(vWerkzeuge(i)) = "IFeature" Then
Debug.Print " Trimmwerkzeug: " & vWerkzeuge(i).Name
Else
Debug.Print " Trimmwerkzeug " & i + 1 & ": " & TypeName(vWerkzeuge(i)) ' etwa eine Ebene
End If
Next i
swDaten.ReleaseSelectionAccess
End SubBemerkungen
Anlegen: Das Feature legst du in zwei Schritten an: FeatureManager.PreTrimSurface legt die Optionen fest, dann wählst du aus und rufst FeatureManager.PostTrimSurface auf. So macht es das Hilfebeispiel „Create Trimmed Surface Feature“.
Nur lesen: SurfaceTrimFeatureData.PiecesToKeep und SurfaceTrimFeatureData.TrimTools sind nur lesbar, „Set is not implemented“. Nach SurfaceTrimFeatureData.AccessSelections rufst du deshalb SurfaceTrimFeatureData.ReleaseSelectionAccess auf. Ob sich das Feature über Feature.ModifyDefinition überhaupt ändern lässt, sagt die Hilfe nicht.
Trimmwerkzeuge: Das Hilfebeispiel gibt von jedem Eintrag in TrimTools die Eigenschaft Name aus. Welchen Typ die Einträge haben, sagt die Hilfe nicht.
Ist eine Ebene das Trimmwerkzeug, liefert SurfaceTrimFeatureData.TrimTools für sie Nothing. Prüfe die Einträge deshalb vor dem Zugriff auf Name, sonst bricht das Makro mit Laufzeitfehler 91 ab.
Eigenschaften und Methoden
Eigenschaften 2, davon 2 beschrieben
| Name | Beschreibung |
|---|---|
| PiecesToKeep | Liefert die Teile, die beim Feature „Oberfläche trimmen“ bleiben. |
| TrimTools | Liefert die Trimmwerkzeuge des Features „Oberfläche trimmen“. |
Methoden 5, davon 5 beschrieben
| Name | Beschreibung |
|---|---|
| AccessSelections | Setzt das Modell vor das Feature „Oberfläche trimmen“ zurück, damit du die Auswahlen lesen kannst, die es festlegen. |
| GetPiecesToKeepCount | Liefert die Zahl der Teile, die beim Feature „Oberfläche trimmen“ bleiben. |
| GetTrimToolsCount | Liefert die Zahl der Trimmwerkzeuge des Features „Oberfläche trimmen“. |
| GetType | Liefert die Art des Features „Oberfläche trimmen“: mit Trimmwerkzeug oder gegenseitig. |
| ReleaseSelectionAccess | Hebt den Rücksetz-Zustand nach AccessSelections wieder auf, wenn du das Feature „Oberfläche trimmen“ nicht geändert hast. |
Nicht aufgeführt sind 5 C++-Varianten (Namen mit I davor, zum Beispiel IAccessSelections). In VBA nimmst du immer den Befehl ohne I.
Siehe auch
Englisches Original: ISurfaceTrimFeatureData in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)
Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.