Objekt · SldWorks
Feature-Objekt
Steht für einen Eintrag im FeatureManager: Skizze, Extrusion, Verrundung, Ebene, Ordner und vieles mehr.
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
ModelDoc2.FirstFeatureund danachFeature.GetNextFeature: alle Features der Reihe nachPartDoc.FeatureByNameoderAssemblyDoc.FeatureByName: ein Feature über seinen NamenSelectionMgr.GetSelectedObject6: das im FeatureManager ausgewählte Feature- Befehle, die ein Feature erzeugen, etwa auf dem
FeatureManager, liefern das neue Feature zurück
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 SubBemerkungen
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
| Name | Beschreibung |
|---|---|
| CreatedBy | Liefert den Namen des Benutzers, der das Feature angelegt hat. |
| CustomPropertyManager | Liefert die Eigenschaften eines Schweißkonstruktions- oder Zuschnittslisten-Features. |
| DateCreated | Liefert das Datum, an dem das Feature angelegt wurde, als Text. |
| DateModified | Liefert das Datum der letzten Änderung des Features als Text. |
| Description | Liefert oder setzt die Beschreibung eines Features. |
| ExcludeFromCutList | Liefert oder setzt, ob ein Eintrag aus der Zuschnittsliste ausgeschlossen ist. |
| Is3DInterconnectFeature | Liefert, ob das Feature mit 3D Interconnect aus einem fremden CAD-Format übernommen ist. |
| Is3DInterconnectUpdateAvailable | Liefert, ob für ein 3D-Interconnect-Feature eine neuere Version der Originaldatei vorliegt. |
| Name | Liest oder ändert den Namen eines Features, so wie er im FeatureManager steht. |
| Visible | Liefert, ob ein Feature ein- oder ausgeblendet ist. |
Methoden 85, davon 71 beschrieben, 14 veraltet
| Name | Beschreibung |
|---|---|
| AddComment | Fügt einem Feature einen Kommentar hinzu. |
| AddPropertyExtension | Hängt einen eigenen Wert an ein Feature. Die Hilfe empfiehlt stattdessen Attribute. |
| BreakLink | Trennt ein 3D-Interconnect-Feature von seiner Originaldatei aus einem fremden CAD-Format. |
| DeSelect | Hebt die Auswahl eines Features auf. |
| EnumDisplayDimensions | Liefert alle Bemaßungen eines Features als Aufzählung. |
| GetAffectedFaceCount | Liefert die Anzahl der Flächen, die ein Feature verändert, etwa eine Formschräge. |
| GetAffectedFaces | Liefert die Flächen, die ein Feature verändert, etwa eine Formschräge. |
| GetBody | veraltet ersetzt durch Feature.GetFaces und Face2.GetBody |
| GetBox | Liefert einen Quader, der das Feature ungefähr umschließt. |
| GetChildren | Liefert die Features, die direkt von diesem Feature abhängen. |
| GetCreatedVersion | Liefert die SOLIDWORKS-Version, in der das Feature angelegt wurde, als Versionsnummer. |
| GetDefinition | Liefert das Datenobjekt mit den Einstellungen eines Features, etwa Tiefe und Richtung einer Extrusion. |
| GetDisplayDimension | Liefert bei einem Muster die Bemaßung für Abstand oder Anzahl. |
| GetEditStatus | Liefert, ob ein Feature gerade bearbeitet werden kann. |
| GetErrorCode | veraltet ersetzt durch Feature.GetErrorCode2 |
| GetErrorCode2 | Liefert den Fehler eines Features, wie ihn das Fehlersymbol im FeatureManager anzeigt. |
| GetFaceCount | Liefert die Anzahl der Flächen, die zu einem Feature gehören. |
| GetFaces | Liefert die Flächen, die zu einem Feature gehören. |
| GetFirstDisplayDimension | Liefert die erste Bemaßung eines Features, oder Nothing, wenn es keine hat. Zusammen mit GetNextDisplayDimension geht ein Makro alle Bemaßungen durch. |
| GetFirstSubFeature | Liefert das erste Unter-Feature eines Features, zum Beispiel die Skizze unter einer Extrusion, oder Nothing, wenn es keine gibt. |
| GetID | Liefert die Kennung eines Features. Sie bleibt gleich, auch wenn das Feature umbenannt wird. |
| GetImportedFeatureParameters | Liefert die Import-Einstellungen eines 3D-Interconnect-Features. |
| GetImportedFileName | Liefert den Dateinamen, aus dem ein importiertes Feature stammt. |
| GetMaterialIdName | Liefert den internen Materialnamen eines Features. |
| GetMaterialPropertyValues | veraltet ersetzt durch Feature.GetMaterialPropertyValues2 |
| GetMaterialPropertyValues2 | Liefert Farbe und Darstellungswerte eines Features in einer oder mehreren Konfigurationen. |
| GetMaterialUserName | Liefert den Materialnamen eines Features, wie ihn der Benutzer sieht. |
| GetModifiedVersion | Liefert die SOLIDWORKS-Version, in der das Feature zuletzt geändert wurde, als Versionsnummer. |
| GetNameForSelection | Liefert Name und Typ eines Features so, wie SelectByID2 sie erwartet. |
| GetNextDisplayDimension | Liefert die nächste Bemaßung eines Features nach der übergebenen, oder Nothing nach der letzten. |
| GetNextFeature | Liefert das nächste Feature im Dokument, oder Nothing nach dem letzten. Damit geht ein Makro alle Features der Reihe nach durch. |
| GetNextSubFeature | Liefert das nächste Unter-Feature desselben Features, oder Nothing nach dem letzten. |
| GetOwnerFeature | Liefert das Feature, dem dieses Feature gehört. |
| GetParents | Liefert die Features, von denen dieses Feature direkt abhängt. |
| GetPropertyExtension | Liefert den eigenen Wert, der mit AddPropertyExtension an ein Feature gehängt wurde. |
| GetSpecificFeature | veraltet ersetzt durch Feature.GetSpecificFeature2 |
| GetSpecificFeature2 | Liefert das spezielle Objekt hinter einem Feature, etwa die Skizze, die Ebene oder die Verknüpfung. |
| GetTexture | Liefert die Textur eines Features in einer Konfiguration. |
| GetTypeName | Liefert die Art eines Features als Text. Bei Instant3D-Features den eigentlichen Typ, sonst nimm GetTypeName2. |
| GetTypeName2 | Liefert die Art eines Features als festen englischen Text, zum Beispiel "Extrusion", "Fillet" oder "ProfileFeature" für eine Skizze. |
| GetUIState | Liefert einen Anzeigezustand des Features im FeatureManager, etwa ob es dort ausgeblendet ist. |
| GetUpdateStamp | Liefert einen Zähler, der steigt, wenn sich das Feature oder etwas, wovon es abhängt, ändert. |
| HasFrozenUpdatePending | Liefert, ob für ein eingefrorenes Feature eine Aktualisierung aussteht. |
| HasMaterialPropertyValues | Liefert, ob ein Feature ein eigenes Erscheinungsbild hat, etwa eine eigene Farbe. |
| IsBase | veraltet ersetzt durch Feature.IsBase2 |
| IsBase2 | Liefert, ob das Feature einen Körper erzeugt, also ein Basis-Feature ist. |
| IsDimXpertAnnotation | Liefert, ob das Feature eine DimXpert-Beschriftung ist. |
| IsDimXpertFeature | Liefert, ob das Feature ein DimXpert-Feature ist. |
| IsFrozen | Liefert, ob ein Feature eingefroren ist, also oberhalb der Einfrieren-Leiste liegt. |
| IsHiddenLock | Liefert, ob dieses Feature die Einfrieren-Leiste im FeatureManager ist. |
| IsRolledBack | Liefert, ob ein Feature unter dem Rückstell-Balken liegt, also zurückgerollt ist. |
| IsSuppressed | veraltet ersetzt durch Feature.IsSuppressed2 |
| IsSuppressed2 | Liefert, ob ein Feature in einer oder mehreren Konfigurationen unterdrückt ist. |
| ListExternalFileReferences | veraltet ersetzt durch Feature.ListExternalFileReferences2 |
| ListExternalFileReferences2 | Liefert die externen Referenzen eines Features mit Pfad, Art und Zustand. |
| ListExternalFileReferencesCount | Liefert die Anzahl der externen Referenzen eines Features. |
| MakeSubFeature | Macht ein Feature zum Unter-Feature eines Makro-Features. |
| ModifyDefinition | Übernimmt die geänderten Einstellungen aus einem Datenobjekt in das Feature. |
| MoveFreezeBarTo | veraltet ersetzt durch Feature.MoveFreezeBarTo2 |
| MoveFreezeBarTo2 | Verschiebt die Einfrieren-Leiste im FeatureManager vor oder hinter dieses Feature. |
| Parameter | Liefert eine Bemaßung eines Features über ihren kurzen Namen, zum Beispiel "D1". |
| RemoveMaterialProperty | veraltet ersetzt durch Feature.RemoveMaterialProperty2 |
| RemoveMaterialProperty2 | Entfernt die eigene Farbe und Darstellung eines Features in einer oder mehreren Konfigurationen. |
| RemoveTexture | Entfernt die Textur eines Features, in allen oder einer Konfiguration. |
| RemoveTextureByDisplayState | Entfernt die Textur eines Features in einem Anzeigezustand. |
| ResetPropertyExtension | Löscht den eigenen Wert, der mit AddPropertyExtension an ein Feature gehängt wurde. |
| Select | veraltet ersetzt durch Feature.Select2 |
| Select2 | Wählt ein Feature aus, wahlweise zusätzlich zur bisherigen Auswahl und mit Markierung. |
| SelectByMark | veraltet ersetzt durch Feature.Select2 |
| SetBodiesToKeep | Legt fest, welche Körper ein Feature behält, das mehrere Körper erzeugt, etwa ein Schnitt. |
| SetBody | veraltet ersetzt durch Feature.SetBody2 |
| SetBody2 | Ersetzt den Körper eines importierten Basis-Features durch einen anderen Körper. |
| SetImportedFeatureParameters | Setzt die Import-Einstellungen eines 3D-Interconnect-Features. |
| SetImportedFileName | Ändert den Dateinamen, aus dem ein importiertes Feature stammt. |
| SetMaterialIdName | Setzt den internen Materialnamen eines Features. |
| SetMaterialPropertyValues | veraltet ersetzt durch Feature.SetMaterialPropertyValues2 |
| SetMaterialPropertyValues2 | Setzt Farbe und Darstellungswerte eines Features in einer oder mehreren Konfigurationen. |
| SetMaterialUserName | Setzt den Materialnamen eines Features, wie ihn der Benutzer sieht. |
| SetSuppression | veraltet ersetzt durch Feature.SetSuppression2 |
| SetSuppression2 | Unterdrückt ein Feature oder hebt die Unterdrückung auf, in einer oder mehreren Konfigurationen. |
| SetTexture | Bringt eine Textur auf ein Feature auf, in allen oder einer Konfiguration. |
| SetTextureByDisplayState | Bringt eine Textur in einem Anzeigezustand auf ein Feature auf. |
| SetUIState | Setzt einen Anzeigezustand des Features im FeatureManager, etwa um es dort auszublenden. |
| Update3DInterconnectModel | Aktualisiert ein 3D-Interconnect-Feature aus der geänderten Originaldatei. |
| UpdateExternalFileReferences | Aktualisiert, 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.