SolidWorksMakroprogrammierung

Methode · Feature

GetNextFeature-Methode (Feature)

Liefert das nächste Feature im Dokument, oder Nothing nach dem letzten. Damit geht ein Makro alle Features der Reihe nach durch.

Syntax

Function GetNextFeature() As Object
Set swFeat = swFeat.GetNextFeature

Rückgabewert

Das nächste Feature, oder Nothing, wenn dies das letzte war.

Beispiel

' Schreibt die Namen aller extrudierten Aufsätze und Schnitte 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

    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
        Select Case swFeat.GetTypeName2
            Case "Extrusion": Debug.Print "Aufsatz: " & swFeat.Name
            Case "Cut":       Debug.Print "Schnitt: " & swFeat.Name
        End Select
        Set swFeat = swFeat.GetNextFeature
    Loop
End Sub

Bemerkungen

Die Schleife Do While Not swFeat Is Nothing … Set swFeat = swFeat.GetNextFeature … Loop ist das Grundmuster für jeden Durchlauf durch den FeatureManager. Vergiss die Zeile mit GetNextFeature nicht, sonst läuft die Schleife endlos und SOLIDWORKS reagiert nicht mehr.

GetNextFeature liefert auch unterdrückte Features. Die Reihenfolge ist die innere Reihenfolge des Modells und kann von der Anzeige im FeatureManager abweichen. Ändert der Benutzer das Modell, ändert sich auch die Reihenfolge. Verlass dich deshalb nicht darauf, dass ein Feature an einer bestimmten Stelle steht.

GetNextFeature geht nur durch die oberste Ebene. Was unter einem Feature hängt, liefern Feature.GetFirstSubFeature und Feature.GetNextSubFeature.

Eine Schnitt-Extrusion kann den Typnamen „ICE“ statt „Cut“ liefern und fällt dann durch eine Abfrage auf „Cut“. Den zugrunde liegenden Typ liefert Feature.GetTypeName.

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::GetNextFeature in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)

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