SolidWorksMakroprogrammierung

Objekt · SldWorks

Feature-Objekt

Steht für einen Eintrag im FeatureManager: Skizze, Extrusion, Verrundung, Ebene, Ordner und vieles mehr.

Deklaration Dim x As SldWorks.Feature · in der englischen .NET-Hilfe: IFeature

Beschreibung

Fast alles, was im FeatureManager steht, ist für die API ein Feature: Skizzen, Extrusionen, Schnitte, Verrundungen, Ebenen, der Ursprung, aber auch Ordner wie „Kommentare“. Das Feature-Objekt liefert, was alle diese Einträge gemeinsam haben: Name, Typ, Bemaßungen, Unterdrücken, Nachbarn im Baum.

Die Einzelheiten eines Features, etwa die Tiefe einer Extrusion, stehen nicht im Feature selbst, sondern in seiner Definition (Feature.GetDefinition) oder in einem spezielleren Objekt (Feature.GetSpecificFeature2).

Zugriff

Beispiel

' Unterdrückt das Feature "Verrundung1" in der aktiven Konfiguration.
' Vorbedingung: Ein Teil mit einem Feature "Verrundung1" ist geöffnet.
'               Namen vor dem Start anpassen.
' Ergebnis:     Das Feature ist unterdrückt (im FeatureManager grau).
Option Explicit

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

    Set swApp = Application.SldWorks
    Set swModel = swApp.ActiveDoc
    If swModel Is Nothing Then Exit Sub
    If swModel.GetType <> swDocPART Then Exit Sub
    Set swPart = swModel

    Set swFeat = swPart.FeatureByName("Verrundung1")
    If swFeat Is Nothing Then
        swApp.SendMsgToUser2 "Feature nicht gefunden.", swMbWarning, swMbOk
        Exit Sub
    End If

    swFeat.SetSuppression2 swSuppressFeature, swThisConfiguration, Empty
    swModel.EditRebuild3
End Sub

Bemerkungen

Namen von Features hängen von der Sprache der Vorlage ab und lassen sich umbenennen. Für ein Makro, das auf vielen Teilen laufen soll, ist der Typ von Feature.GetTypeName2 verlässlicher als der Name.

Die Reihenfolge von Feature.GetNextFeature folgt der inneren Reihenfolge des Modells. Sie kann von der Anzeige im FeatureManager abweichen.

Eigenschaften und Methoden

Eigenschaften 10, davon 10 beschrieben

NameBeschreibung
CreatedByLiefert den Namen des Benutzers, der das Feature angelegt hat.
CustomPropertyManagerLiefert die Eigenschaften eines Schweißkonstruktions- oder Zuschnittslisten-Features.
DateCreatedLiefert das Datum, an dem das Feature angelegt wurde, als Text.
DateModifiedLiefert das Datum der letzten Änderung des Features als Text.
DescriptionLiefert oder setzt die Beschreibung eines Features.
ExcludeFromCutListLiefert oder setzt, ob ein Eintrag aus der Zuschnittsliste ausgeschlossen ist.
Is3DInterconnectFeatureLiefert, ob das Feature mit 3D Interconnect aus einem fremden CAD-Format übernommen ist.
Is3DInterconnectUpdateAvailableLiefert, ob für ein 3D-Interconnect-Feature eine neuere Version der Originaldatei vorliegt.
NameLiest oder ändert den Namen eines Features, so wie er im FeatureManager steht.
VisibleLiefert, ob ein Feature ein- oder ausgeblendet ist.

Methoden 85, davon 71 beschrieben, 14 veraltet

NameBeschreibung
AddCommentFügt einem Feature einen Kommentar hinzu.
AddPropertyExtensionHängt einen eigenen Wert an ein Feature. Die Hilfe empfiehlt stattdessen Attribute.
BreakLinkTrennt ein 3D-Interconnect-Feature von seiner Originaldatei aus einem fremden CAD-Format.
DeSelectHebt die Auswahl eines Features auf.
EnumDisplayDimensionsLiefert alle Bemaßungen eines Features als Aufzählung.
GetAffectedFaceCountLiefert die Anzahl der Flächen, die ein Feature verändert, etwa eine Formschräge.
GetAffectedFacesLiefert die Flächen, die ein Feature verändert, etwa eine Formschräge.
GetBodyveraltet ersetzt durch Feature.GetFaces und Face2.GetBody
GetBoxLiefert einen Quader, der das Feature ungefähr umschließt.
GetChildrenLiefert die Features, die direkt von diesem Feature abhängen.
GetCreatedVersionLiefert die SOLIDWORKS-Version, in der das Feature angelegt wurde, als Versionsnummer.
GetDefinitionLiefert das Datenobjekt mit den Einstellungen eines Features, etwa Tiefe und Richtung einer Extrusion.
GetDisplayDimensionLiefert bei einem Muster die Bemaßung für Abstand oder Anzahl.
GetEditStatusLiefert, ob ein Feature gerade bearbeitet werden kann.
GetErrorCodeveraltet ersetzt durch Feature.GetErrorCode2
GetErrorCode2Liefert den Fehler eines Features, wie ihn das Fehlersymbol im FeatureManager anzeigt.
GetFaceCountLiefert die Anzahl der Flächen, die zu einem Feature gehören.
GetFacesLiefert die Flächen, die zu einem Feature gehören.
GetFirstDisplayDimensionLiefert die erste Bemaßung eines Features, oder Nothing, wenn es keine hat. Zusammen mit GetNextDisplayDimension geht ein Makro alle Bemaßungen durch.
GetFirstSubFeatureLiefert das erste Unter-Feature eines Features, zum Beispiel die Skizze unter einer Extrusion, oder Nothing, wenn es keine gibt.
GetIDLiefert die Kennung eines Features. Sie bleibt gleich, auch wenn das Feature umbenannt wird.
GetImportedFeatureParametersLiefert die Import-Einstellungen eines 3D-Interconnect-Features.
GetImportedFileNameLiefert den Dateinamen, aus dem ein importiertes Feature stammt.
GetMaterialIdNameLiefert den internen Materialnamen eines Features.
GetMaterialPropertyValuesveraltet ersetzt durch Feature.GetMaterialPropertyValues2
GetMaterialPropertyValues2Liefert Farbe und Darstellungswerte eines Features in einer oder mehreren Konfigurationen.
GetMaterialUserNameLiefert den Materialnamen eines Features, wie ihn der Benutzer sieht.
GetModifiedVersionLiefert die SOLIDWORKS-Version, in der das Feature zuletzt geändert wurde, als Versionsnummer.
GetNameForSelectionLiefert Name und Typ eines Features so, wie SelectByID2 sie erwartet.
GetNextDisplayDimensionLiefert die nächste Bemaßung eines Features nach der übergebenen, oder Nothing nach der letzten.
GetNextFeatureLiefert das nächste Feature im Dokument, oder Nothing nach dem letzten. Damit geht ein Makro alle Features der Reihe nach durch.
GetNextSubFeatureLiefert das nächste Unter-Feature desselben Features, oder Nothing nach dem letzten.
GetOwnerFeatureLiefert das Feature, dem dieses Feature gehört.
GetParentsLiefert die Features, von denen dieses Feature direkt abhängt.
GetPropertyExtensionLiefert den eigenen Wert, der mit AddPropertyExtension an ein Feature gehängt wurde.
GetSpecificFeatureveraltet ersetzt durch Feature.GetSpecificFeature2
GetSpecificFeature2Liefert das spezielle Objekt hinter einem Feature, etwa die Skizze, die Ebene oder die Verknüpfung.
GetTextureLiefert die Textur eines Features in einer Konfiguration.
GetTypeNameLiefert die Art eines Features als Text. Bei Instant3D-Features den eigentlichen Typ, sonst nimm GetTypeName2.
GetTypeName2Liefert die Art eines Features als festen englischen Text, zum Beispiel "Extrusion", "Fillet" oder "ProfileFeature" für eine Skizze.
GetUIStateLiefert einen Anzeigezustand des Features im FeatureManager, etwa ob es dort ausgeblendet ist.
GetUpdateStampLiefert einen Zähler, der steigt, wenn sich das Feature oder etwas, wovon es abhängt, ändert.
HasFrozenUpdatePendingLiefert, ob für ein eingefrorenes Feature eine Aktualisierung aussteht.
HasMaterialPropertyValuesLiefert, ob ein Feature ein eigenes Erscheinungsbild hat, etwa eine eigene Farbe.
IsBaseveraltet ersetzt durch Feature.IsBase2
IsBase2Liefert, ob das Feature einen Körper erzeugt, also ein Basis-Feature ist.
IsDimXpertAnnotationLiefert, ob das Feature eine DimXpert-Beschriftung ist.
IsDimXpertFeatureLiefert, ob das Feature ein DimXpert-Feature ist.
IsFrozenLiefert, ob ein Feature eingefroren ist, also oberhalb der Einfrieren-Leiste liegt.
IsHiddenLockLiefert, ob dieses Feature die Einfrieren-Leiste im FeatureManager ist.
IsRolledBackLiefert, ob ein Feature unter dem Rückstell-Balken liegt, also zurückgerollt ist.
IsSuppressedveraltet ersetzt durch Feature.IsSuppressed2
IsSuppressed2Liefert, ob ein Feature in einer oder mehreren Konfigurationen unterdrückt ist.
ListExternalFileReferencesveraltet ersetzt durch Feature.ListExternalFileReferences2
ListExternalFileReferences2Liefert die externen Referenzen eines Features mit Pfad, Art und Zustand.
ListExternalFileReferencesCountLiefert die Anzahl der externen Referenzen eines Features.
MakeSubFeatureMacht ein Feature zum Unter-Feature eines Makro-Features.
ModifyDefinitionÜbernimmt die geänderten Einstellungen aus einem Datenobjekt in das Feature.
MoveFreezeBarToveraltet ersetzt durch Feature.MoveFreezeBarTo2
MoveFreezeBarTo2Verschiebt die Einfrieren-Leiste im FeatureManager vor oder hinter dieses Feature.
ParameterLiefert eine Bemaßung eines Features über ihren kurzen Namen, zum Beispiel "D1".
RemoveMaterialPropertyveraltet ersetzt durch Feature.RemoveMaterialProperty2
RemoveMaterialProperty2Entfernt die eigene Farbe und Darstellung eines Features in einer oder mehreren Konfigurationen.
RemoveTextureEntfernt die Textur eines Features, in allen oder einer Konfiguration.
RemoveTextureByDisplayStateEntfernt die Textur eines Features in einem Anzeigezustand.
ResetPropertyExtensionLöscht den eigenen Wert, der mit AddPropertyExtension an ein Feature gehängt wurde.
Selectveraltet ersetzt durch Feature.Select2
Select2Wählt ein Feature aus, wahlweise zusätzlich zur bisherigen Auswahl und mit Markierung.
SelectByMarkveraltet ersetzt durch Feature.Select2
SetBodiesToKeepLegt fest, welche Körper ein Feature behält, das mehrere Körper erzeugt, etwa ein Schnitt.
SetBodyveraltet ersetzt durch Feature.SetBody2
SetBody2Ersetzt den Körper eines importierten Basis-Features durch einen anderen Körper.
SetImportedFeatureParametersSetzt die Import-Einstellungen eines 3D-Interconnect-Features.
SetImportedFileNameÄndert den Dateinamen, aus dem ein importiertes Feature stammt.
SetMaterialIdNameSetzt den internen Materialnamen eines Features.
SetMaterialPropertyValuesveraltet ersetzt durch Feature.SetMaterialPropertyValues2
SetMaterialPropertyValues2Setzt Farbe und Darstellungswerte eines Features in einer oder mehreren Konfigurationen.
SetMaterialUserNameSetzt den Materialnamen eines Features, wie ihn der Benutzer sieht.
SetSuppressionveraltet ersetzt durch Feature.SetSuppression2
SetSuppression2Unterdrückt ein Feature oder hebt die Unterdrückung auf, in einer oder mehreren Konfigurationen.
SetTextureBringt eine Textur auf ein Feature auf, in allen oder einer Konfiguration.
SetTextureByDisplayStateBringt eine Textur in einem Anzeigezustand auf ein Feature auf.
SetUIStateSetzt einen Anzeigezustand des Features im FeatureManager, etwa um es dort auszublenden.
Update3DInterconnectModelAktualisiert ein 3D-Interconnect-Feature aus der geänderten Originaldatei.
UpdateExternalFileReferencesAktualisiert, sperrt oder löst die externen Referenzen eines Features.

Nicht aufgeführt sind 30 C++-Varianten (Namen mit I davor, zum Beispiel IGetAffectedFaces). In VBA nimmst du immer den Befehl ohne I.

Siehe auch

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

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