SolidWorksMakroprogrammierung

Methode · Feature

GetFirstSubFeature-Methode (Feature)

Liefert das erste Unter-Feature eines Features, zum Beispiel die Skizze unter einer Extrusion, oder Nothing, wenn es keine gibt.

Syntax

Function GetFirstSubFeature() As Object
Set swSubFeat = swFeat.GetFirstSubFeature

Rückgabewert

Das erste Unter-Feature, oder Nothing, wenn das Feature keine Unter-Features hat.

Beispiel

' Schreibt alle Features und darunter eingerückt ihre Unter-Features ins Direktfenster.
' Vorbedingung: Ein Teil ist geöffnet.
' Ergebnis:     Liste im Direktfenster (Strg+G im VBA-Editor).
Option Explicit

Sub main()
    Dim swApp As SldWorks.SldWorks
    Dim swModel As SldWorks.ModelDoc2
    Dim swFeat As SldWorks.Feature
    Dim swSubFeat As SldWorks.Feature

    Set swApp = Application.SldWorks
    Set swModel = swApp.ActiveDoc
    If swModel Is Nothing Then Exit Sub

    Set swFeat = swModel.FirstFeature
    Do While Not swFeat Is Nothing
        Debug.Print swFeat.Name
        Set swSubFeat = swFeat.GetFirstSubFeature
        Do While Not swSubFeat Is Nothing
            Debug.Print "    " & swSubFeat.Name & "  (" & swSubFeat.GetTypeName2 & ")"
            Set swSubFeat = swSubFeat.GetNextSubFeature
        Loop
        Set swFeat = swFeat.GetNextFeature
    Loop
End Sub

Bemerkungen

Unter-Features sind die Einträge, die im FeatureManager unter einem Feature hängen, wenn du es aufklappst: die Skizze unter einer Extrusion, die Skizzen einer Bohrung aus dem Bohrungsassistenten, die Features in einem Ordner.

Das Muster ist dasselbe wie bei der obersten Ebene: erst GetFirstSubFeature, dann in einer Schleife Feature.GetNextSubFeature, bis Nothing kommt. Unter-Features können selbst wieder Unter-Features haben. Für beliebig tiefe Bäume ruft sich ein Unterprogramm dann selbst auf (Rekursion).

Siehe auch

In den Videos

Verfügbarkeit

In allen aktuellen Versionen vorhanden. Seit wann es den Befehl gibt, nennt die Hilfe nicht.

Englisches Original: IFeature::GetFirstSubFeature in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)

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