Objekt · SldWorks
DerivedPartFeatureData-Objekt
Die Definition eines abgeleiteten Teils („Teil einfügen“): Ausgangsteil, Konfiguration und was aus dem Ausgangsteil übernommen wird, etwa Körper, Ebenen, Skizzen, Dateieigenschaften oder Blechinformationen.
Beschreibung
DerivedPartFeatureData gibt Zugriff auf das Feature eines abgeleiteten Teils (derived part). PartDoc.InsertPart3 fügt ein anderes Teil, das Ausgangsteil, als abgeleitetes Teil in ein Teil ein (in der Oberfläche „Teil einfügen“). Das Feature steht im aufnehmenden Teil. Du liest damit, aus welcher Datei und Konfiguration es stammt und was übernommen wird, und änderst diese Auswahl. Die meisten Befehle gibt es seit SOLIDWORKS 2008, die Einstellungen für Volumenkörper, Koordinatensysteme, Material, Bemaßungen, Bohrungsassistent, Eigenschaften, Blech und die Konfiguration seit SOLIDWORKS 2020.
Zugriff
Feature.GetDefinition: aus dem Feature des abgeleiteten Teils (TypnameStock), etwa ausPartDoc.InsertPart3
Die Liste der Typnamen in der Hilfe zu Feature.GetTypeName2 nennt DerivedPartFeatureData außerdem beim Typnamen XformStock, dort unter den Features für Formwerkzeuge.
Beispiel
' Sucht im aktiven Teil die Features abgeleiteter Teile und gibt aus, woher sie stammen
' und was aus dem Ausgangsteil übernommen wird.
' Vorbedingung: Ein Teil ist offen, in das mit „Teil einfügen“ ein anderes Teil eingefügt ist.
' Ergebnis: Die Werte stehen im Direktfenster, das Teil bleibt unverändert.
Option Explicit
Sub main()
Dim swApp As SldWorks.SldWorks
Dim swModel As SldWorks.ModelDoc2
Dim swFeat As SldWorks.Feature
Dim swDaten As SldWorks.DerivedPartFeatureData
Dim swAusgang As SldWorks.ModelDoc2
Set swApp = Application.SldWorks
Set swModel = swApp.ActiveDoc
If swModel Is Nothing Then Exit Sub
If swModel.GetType <> swDocPART Then Exit Sub
Set swFeat = swModel.FirstFeature
Do While Not swFeat Is Nothing
If swFeat.GetTypeName2 = "Stock" Then
Set swDaten = swFeat.GetDefinition
If swDaten.AccessSelections(swModel, Nothing) Then
Debug.Print swFeat.Name & ": " & swDaten.PathName & ", Konfiguration " & swDaten.PartConfiguration
Set swAusgang = swDaten.GetModelDoc
If Not swAusgang Is Nothing Then Debug.Print " Ausgangsteil: " & swAusgang.GetTitle
Debug.Print " Volumenkörper: " & swDaten.ImportSolidBodies & ", Flächenkörper: " & swDaten.ImportSurf
Debug.Print " Ebenen: " & swDaten.ImportPlane & ", Achsen: " & swDaten.ImportAxis & _
", Koordinatensysteme: " & swDaten.ImportCoordinateSystems
Debug.Print " Absorbierte Skizzen: " & swDaten.ImportAbsorbedSketches & _
", nicht absorbierte Skizzen: " & swDaten.ImportUnAbsorbedSketches
Debug.Print " Dateieigenschaften: " & swDaten.ImportCustomProperties & _
", Zuschnittsliste: " & swDaten.ImportCutListProperties
swDaten.ReleaseSelectionAccess
End If
End If
Set swFeat = swFeat.GetNextFeature
Loop
End SubBemerkungen
Hilfebeispiel: „Modify Derived Part“ öffnet holecube.sldprt, fügt mit PartDoc.InsertPart3 und swInsertPartImportSolids das Teil box.sldprt ein und wählt das neue Feature mit ModelDocExtension.SelectByID2 und dem Typ BODYFEATURE aus. Dann schaltet es nacheinander DerivedPartFeatureData.ImportPlane, DerivedPartFeatureData.ImportAbsorbedSketches und DerivedPartFeatureData.ImportUnAbsorbedSketches ein und übernimmt jede Änderung mit Feature.ModifyDefinition. DerivedPartFeatureData.AccessSelections ruft es dabei nicht auf. Am Ende gibt es DerivedPartFeatureData.PathName aus.
Übernahme: Dem Namen nach entspricht jede Eigenschaft für die Übernahme einem Wert aus swInsertPartOptions_e, etwa DerivedPartFeatureData.ImportPlane dem Wert swInsertPartImportPlanes. Unter anderem für Punkte, Grafikkörper, DimXpert-Beschriftungen und die visuellen Eigenschaften gibt es hier keine Eigenschaft. DerivedPartFeatureData.ImportCustomProperties und DerivedPartFeatureData.ImportSheetMetalInformation nehmen keine Wahrheitswerte, sondern Werte aus swImportPartCustomPropertiesToOptions_e und swImportSheetMetalInformation_e.
Bedingungen: Mehrere Einstellungen gelten nur unter Bedingungen:
DerivedPartFeatureData.ImportCustomProperties,DerivedPartFeatureData.ImportHoleWizardDataundDerivedPartFeatureData.ImportModelDimensionsnur, wennDerivedPartFeatureData.ImportSolidBodieseingeschaltet istDerivedPartFeatureData.ImportSheetMetalInformationnur bei einem Blechteil und nicht zusammen mitDerivedPartFeatureData.ImportCutListPropertiesDerivedPartFeatureData.ImportMaterialnur beim Einfügen, nicht beim Bearbeiten
Ändern: Du rufst erst DerivedPartFeatureData.AccessSelections auf und übernimmst Änderungen mit Feature.ModifyDefinition. Ohne Änderung hebst du den Zustand mit DerivedPartFeatureData.ReleaseSelectionAccess auf.
Verwandt: Ein gespiegeltes Teil aus PartDoc.MirrorPart2 beschreibt MirrorPartFeatureData mit ähnlichen Eigenschaften für die Übernahme.
Eigenschaften und Methoden
Eigenschaften 16, davon 16 beschrieben
| Name | Beschreibung |
|---|---|
| ImportAbsorbedSketches | Liest oder setzt, ob das abgeleitete Teil die absorbierten Skizzen des Ausgangsteils übernimmt. |
| ImportAxis | Liest oder setzt, ob das abgeleitete Teil die Achsen des Ausgangsteils übernimmt. |
| ImportCoordinateSystems | Liest oder setzt, ob das abgeleitete Teil die Koordinatensysteme des Ausgangsteils übernimmt. |
| ImportCThread | Liest oder setzt, ob das abgeleitete Teil die Gewindedarstellungen des Ausgangsteils übernimmt. |
| ImportCustomProperties | Liest oder setzt, ob und wie das abgeleitete Teil die Dateieigenschaften des Ausgangsteils übernimmt: als Dateieigenschaften, als Eigenschaften der Zuschnittsliste oder gar nicht. |
| ImportCutListProperties | Liest oder setzt, ob das abgeleitete Teil die Eigenschaften der Zuschnittsliste des Ausgangsteils übernimmt. |
| ImportHoleWizardData | Liest oder setzt, ob das abgeleitete Teil die Daten des Bohrungsassistenten aus dem Ausgangsteil übernimmt. |
| ImportMaterial | Liest oder setzt, ob das abgeleitete Teil das Material des Ausgangsteils übernimmt. Gilt nur beim Einfügen. |
| ImportModelDimensions | Liest oder setzt, ob das abgeleitete Teil die Modellbemaßungen des Ausgangsteils übernimmt. |
| ImportPlane | Liest oder setzt, ob das abgeleitete Teil die Ebenen des Ausgangsteils übernimmt. |
| ImportSheetMetalInformation | Liest oder setzt, ob und wie das abgeleitete Teil die Blechinformationen des Ausgangsteils übernimmt. |
| ImportSolidBodies | Liest oder setzt, ob das abgeleitete Teil die Volumenkörper des Ausgangsteils übernimmt. |
| ImportSurf | Liest oder setzt, ob das abgeleitete Teil die Flächenkörper des Ausgangsteils übernimmt. |
| ImportUnAbsorbedSketches | Liest oder setzt, ob das abgeleitete Teil die nicht absorbierten Skizzen des Ausgangsteils übernimmt. |
| PartConfiguration | Liest oder setzt die Konfiguration des Ausgangsteils, aus der das abgeleitete Teil entsteht. |
| PathName | Liefert Pfad und Dateinamen zum Feature des abgeleiteten Teils, vermutlich die Datei des Ausgangsteils. |
Methoden 4, davon 4 beschrieben
| Name | Beschreibung |
|---|---|
| AccessSelections | Setzt das Modell vor das Feature des abgeleiteten Teils zurück, damit du die Auswahlen lesen und ändern kannst, die es festlegen. |
| GetModelDoc | Liefert das Ausgangsteil, aus dem das abgeleitete Teil entstanden ist. |
| GetMoveFeature | Liefert das Feature zum Verschieben/Kopieren, das zum abgeleiteten Teil gehört. |
| ReleaseSelectionAccess | Hebt den Rücksetz-Zustand nach AccessSelections wieder auf, wenn du das Feature des abgeleiteten Teils nicht geändert hast. |
Nicht aufgeführt sind 1 C++-Varianten (Namen mit I davor, zum Beispiel IAccessSelections). In VBA nimmst du immer den Befehl ohne I.
Siehe auch
Englisches Original: IDerivedPartFeatureData in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)
Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.