SolidWorksMakroprogrammierung

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.

Deklaration Dim x As SldWorks.DerivedPartFeatureData · in der englischen .NET-Hilfe: IDerivedPartFeatureData

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

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 Sub

Bemerkungen

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:

Ä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

NameBeschreibung
ImportAbsorbedSketchesLiest oder setzt, ob das abgeleitete Teil die absorbierten Skizzen des Ausgangsteils übernimmt.
ImportAxisLiest oder setzt, ob das abgeleitete Teil die Achsen des Ausgangsteils übernimmt.
ImportCoordinateSystemsLiest oder setzt, ob das abgeleitete Teil die Koordinatensysteme des Ausgangsteils übernimmt.
ImportCThreadLiest oder setzt, ob das abgeleitete Teil die Gewindedarstellungen des Ausgangsteils übernimmt.
ImportCustomPropertiesLiest oder setzt, ob und wie das abgeleitete Teil die Dateieigenschaften des Ausgangsteils übernimmt: als Dateieigenschaften, als Eigenschaften der Zuschnittsliste oder gar nicht.
ImportCutListPropertiesLiest oder setzt, ob das abgeleitete Teil die Eigenschaften der Zuschnittsliste des Ausgangsteils übernimmt.
ImportHoleWizardDataLiest oder setzt, ob das abgeleitete Teil die Daten des Bohrungsassistenten aus dem Ausgangsteil übernimmt.
ImportMaterialLiest oder setzt, ob das abgeleitete Teil das Material des Ausgangsteils übernimmt. Gilt nur beim Einfügen.
ImportModelDimensionsLiest oder setzt, ob das abgeleitete Teil die Modellbemaßungen des Ausgangsteils übernimmt.
ImportPlaneLiest oder setzt, ob das abgeleitete Teil die Ebenen des Ausgangsteils übernimmt.
ImportSheetMetalInformationLiest oder setzt, ob und wie das abgeleitete Teil die Blechinformationen des Ausgangsteils übernimmt.
ImportSolidBodiesLiest oder setzt, ob das abgeleitete Teil die Volumenkörper des Ausgangsteils übernimmt.
ImportSurfLiest oder setzt, ob das abgeleitete Teil die Flächenkörper des Ausgangsteils übernimmt.
ImportUnAbsorbedSketchesLiest oder setzt, ob das abgeleitete Teil die nicht absorbierten Skizzen des Ausgangsteils übernimmt.
PartConfigurationLiest oder setzt die Konfiguration des Ausgangsteils, aus der das abgeleitete Teil entsteht.
PathNameLiefert Pfad und Dateinamen zum Feature des abgeleiteten Teils, vermutlich die Datei des Ausgangsteils.

Methoden 4, davon 4 beschrieben

NameBeschreibung
AccessSelectionsSetzt das Modell vor das Feature des abgeleiteten Teils zurück, damit du die Auswahlen lesen und ändern kannst, die es festlegen.
GetModelDocLiefert das Ausgangsteil, aus dem das abgeleitete Teil entstanden ist.
GetMoveFeatureLiefert das Feature zum Verschieben/Kopieren, das zum abgeleiteten Teil gehört.
ReleaseSelectionAccessHebt 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.