SolidWorksMakroprogrammierung

Objekt · SldWorks

SurfaceTrimFeatureData-Objekt

Die Definition des Features „Oberfläche trimmen“: Art des Trimmens, Trimmwerkzeuge und die Teile, die bleiben.

Deklaration Dim x As SldWorks.SurfaceTrimFeatureData · in der englischen .NET-Hilfe: ISurfaceTrimFeatureData

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

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 Sub

Bemerkungen

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

NameBeschreibung
PiecesToKeepLiefert die Teile, die beim Feature „Oberfläche trimmen“ bleiben.
TrimToolsLiefert die Trimmwerkzeuge des Features „Oberfläche trimmen“.

Methoden 5, davon 5 beschrieben

NameBeschreibung
AccessSelectionsSetzt das Modell vor das Feature „Oberfläche trimmen“ zurück, damit du die Auswahlen lesen kannst, die es festlegen.
GetPiecesToKeepCountLiefert die Zahl der Teile, die beim Feature „Oberfläche trimmen“ bleiben.
GetTrimToolsCountLiefert die Zahl der Trimmwerkzeuge des Features „Oberfläche trimmen“.
GetTypeLiefert die Art des Features „Oberfläche trimmen“: mit Trimmwerkzeug oder gegenseitig.
ReleaseSelectionAccessHebt 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.