SolidWorksMakroprogrammierung

Objekt · SldWorks

MirrorPartFeatureData-Objekt

Die Definition eines gespiegelten Teils („Teil spiegeln“): Spiegelebene, Ausgangsteil und was aus dem Ausgangsteil übernommen wird, etwa Körper, Ebenen, Dateieigenschaften oder Blechdaten.

Deklaration Dim x As SldWorks.MirrorPartFeatureData · in der englischen .NET-Hilfe: IMirrorPartFeatureData

Beschreibung

MirrorPartFeatureData gibt Zugriff auf das Feature eines gespiegelten Teils. PartDoc.MirrorPart2 legt ein neues Teil an, das ein Teil an einer Referenzebene oder ebenen Fläche spiegelt (in der Oberfläche „Teil spiegeln“). Das Feature steht im neuen Teil, die Hilfe nennt es abgeleitet (derived mirror part feature). Du liest damit, woran gespiegelt wurde und was aus dem Ausgangsteil übernommen wird, und änderst diese Auswahl. Die meisten Befehle gibt es seit SOLIDWORKS 2014, die beiden Blech-Einstellungen seit 2015 und DimXpertAnnotations seit 2018.

Zugriff

Beispiel

' Sucht im aktiven Teil das Feature des gespiegelten Teils und gibt aus, woher es stammt,
' woran gespiegelt wurde und was aus dem Ausgangsteil übernommen wird.
' Vorbedingung: Ein gespiegeltes Teil ist offen, etwa aus PartDoc.MirrorPart2.
' 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.MirrorPartFeatureData
    Dim swOriginal 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 = "MirrorStock" Then Exit Do
        Set swFeat = swFeat.GetNextFeature
    Loop
    If swFeat Is Nothing Then
        Debug.Print "Kein gespiegeltes Teil"
        Exit Sub
    End If

    Set swDaten = swFeat.GetDefinition
    If False = swDaten.AccessSelections(swModel, Nothing) Then Exit Sub
    Debug.Print swFeat.Name & ": " & swDaten.PathName
    Set swOriginal = swDaten.GetModelDoc
    If Not swOriginal Is Nothing Then Debug.Print "Ausgangsteil: " & swOriginal.GetTitle
    If swDaten.GetMirrorPlaneType = swMirrorPlaneType_Plane Then
        Debug.Print "Gespiegelt an einer Referenzebene"
    Else
        Debug.Print "Gespiegelt an einer ebenen Fläche"
    End If
    Debug.Print "Volumenkörper: " & swDaten.SolidBodies & ", Flächenkörper: " & swDaten.SurfaceBodies
    Debug.Print "Ebenen: " & swDaten.Planes & ", Achsen: " & swDaten.Axes & _
                ", Koordinatensysteme: " & swDaten.CoordinateSystems
    Debug.Print "Dateieigenschaften: " & swDaten.CustomProperties & _
                ", Zuschnittsliste: " & swDaten.CutListProperties
    Debug.Print "Blechdaten: " & swDaten.SheetMetalInformation & _
                ", Blechdefinition bearbeitbar: " & swDaten.UnlockedProperties
    swDaten.ReleaseSelectionAccess
End Sub

Bemerkungen

Anlegen: PartDoc.MirrorPart2 legt ein neues Teil an, das das Teil an einer vorher ausgewählten Referenzebene oder ebenen Fläche spiegelt, und liefert das Feature im neuen Teil. Was übernommen wird, gibst du dort mit Werten aus swMirrorPartOptions_e an. Die Hilfebeispiele „Get Mirror Part Information“ und „Mirror Sheet-metal Part“ holen danach mit ActiveDoc das neue Teil, wählen das Feature aus und lesen mit Feature.GetDefinition seine Daten.

Übernahme: Dem Namen nach entspricht jede Eigenschaft für die Übernahme einem Wert aus swMirrorPartOptions_e, etwa MirrorPartFeatureData.Planes dem Wert swMirrorPartOptions_ImportPlanes und MirrorPartFeatureData.UnlockedProperties dem Wert swMirrorPartOptions_ImportIndProps. Für das Material der Körper und des Teils (swMirrorPartOptions_ImportBodyMaterial, swMirrorPartOptions_ImportPartMaterial) gibt es hier keine Eigenschaft.

Ändern: Rufe erst MirrorPartFeatureData.AccessSelections auf und übernimm Änderungen mit Feature.ModifyDefinition. Ohne Änderung hebst du den Zustand mit MirrorPartFeatureData.ReleaseSelectionAccess auf. Die Hilfebeispiele lesen die Daten nur, ein Beispiel zum Ändern gibt es nicht.

Verwandte Befehle: ModelDoc2.GetExternalReferenceName liefert den Pfad des Dokuments, auf das ein gespiegeltes Teil verweist. Ob ein Teil gespiegelt ist, liefert PartDoc.IsMirrored. Gespiegelte Körper innerhalb eines Teils (mirror solid) beschreibt MirrorSolidFeatureData, auf das die Hilfe hier ebenfalls verweist.

Eigenschaften und Methoden

Eigenschaften 16, davon 16 beschrieben

NameBeschreibung
AbsorbedSketchesLiest oder setzt, ob das gespiegelte Teil die absorbierten Skizzen des Ausgangsteils übernimmt.
AxesLiest oder setzt, ob das gespiegelte Teil die Achsen des Ausgangsteils übernimmt.
CoordinateSystemsLiest oder setzt, ob das gespiegelte Teil die Koordinatensysteme des Ausgangsteils übernimmt.
CosmeticThreadsLiest oder setzt, ob das gespiegelte Teil die Gewindedarstellungen des Ausgangsteils übernimmt.
CustomPropertiesLiest oder setzt, ob das gespiegelte Teil die Dateieigenschaften des Ausgangsteils übernimmt.
CutListPropertiesLiest oder setzt, ob das gespiegelte Teil die Eigenschaften der Zuschnittsliste des Ausgangsteils übernimmt.
DimXpertAnnotationsLiest oder setzt, ob das gespiegelte Teil die DimXpert-Beschriftungen des Ausgangsteils übernimmt.
HoleWizardDataLiest oder setzt, ob das gespiegelte Teil die Daten des Bohrungsassistenten aus dem Ausgangsteil übernimmt.
ModelDimensionsLiest oder setzt, ob das gespiegelte Teil die Modellbemaßungen des Ausgangsteils übernimmt.
PathNameLiefert Pfad und Dateinamen zum Feature des gespiegelten Teils, vermutlich die Datei des Ausgangsteils.
PlanesLiest oder setzt, ob das gespiegelte Teil die Ebenen des Ausgangsteils übernimmt.
SheetMetalInformationLiest oder setzt, ob die Blech- und Abwicklungsdaten des Ausgangsteils ins gespiegelte Teil übertragen werden.
SolidBodiesLiest oder setzt, ob das gespiegelte Teil die Volumenkörper des Ausgangsteils übernimmt.
SurfaceBodiesLiest oder setzt, ob das gespiegelte Teil die Flächenkörper des Ausgangsteils übernimmt.
UnabsorbedSketchesLiest oder setzt, ob das gespiegelte Teil die nicht absorbierten Skizzen des Ausgangsteils übernimmt.
UnlockedPropertiesLiest oder setzt, ob du die Blechdefinition im gespiegelten Blechteil bearbeiten kannst.

Methoden 6, davon 6 beschrieben

NameBeschreibung
AccessSelectionsSetzt das Modell vor das Feature des gespiegelten Teils zurück, damit du die Auswahlen lesen und ändern kannst, die es festlegen.
GetMirrorPlaneLiefert die Referenzebene oder ebene Fläche, an der das Teil gespiegelt ist.
GetMirrorPlaneTypeLiefert, ob das Teil an einer Referenzebene oder an einer ebenen Fläche gespiegelt ist.
GetModelDocLiefert das Basisdokument des gespiegelten Teils, vermutlich das Ausgangsteil.
GetTransformLiefert die Transformation des Features eines gespiegelten Teils.
ReleaseSelectionAccessHebt den Rücksetz-Zustand nach AccessSelections wieder auf, wenn du das Feature des gespiegelten Teils nicht geändert hast.

Siehe auch

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

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