SolidWorksMakroprogrammierung

Objekt · SldWorks

MirrorSolidFeatureData-Objekt

Die Feature-Daten eines Features „Spiegeln“, das Körper spiegelt: gespiegelte Körper und Tragwerke, Verschmelzen, Zusammenfügen und die Transformation.

Deklaration Dim x As SldWorks.MirrorSolidFeatureData · in der englischen .NET-Hilfe: IMirrorSolidFeatureData

Beschreibung

MirrorSolidFeatureData gibt Zugriff auf ein Feature „Spiegeln“, das Körper spiegelt (mirror solid). Spiegelt das Feature Features oder Flächen, stehen seine Daten dagegen in MirrorPatternFeatureData (siehe Bemerkungen). Face, AccessSelections und ReleaseSelectionAccess gibt es seit SOLIDWORKS 2001, die Körper, Merge und KnitSurface seit SOLIDWORKS 2003, PropagateVisualProperty seit SOLIDWORKS 2006 und GetTransform seit SOLIDWORKS 2010.

Zugriff

Angelegt wird das Feature mit FeatureManager.InsertMirrorFeature2 und BMirrorBody = True.

Beispiel

' Gibt für das ausgewählte Feature „Spiegeln“, das Körper spiegelt, die Optionen
' und die gespiegelten Körper mit ihrer Art aus.
' Vorbedingung: Ein Teil ist offen, ein Feature „Spiegeln“ für Körper ist im
'               FeatureManager ausgewählt.
' 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 swSel As Object
    Dim swFeat As SldWorks.Feature
    Dim swDaten As SldWorks.MirrorSolidFeatureData
    Dim swBody As SldWorks.Body2
    Dim vKoerper As Variant
    Dim i As Long

    Set swApp = Application.SldWorks
    Set swModel = swApp.ActiveDoc
    If swModel Is Nothing Then Exit Sub
    Set swSel = swModel.SelectionManager.GetSelectedObject6(1, -1)
    If Not TypeOf swSel Is SldWorks.Feature Then Exit Sub
    Set swFeat = swSel
    If swFeat.GetTypeName2 <> "MirrorSolid" Then
        Debug.Print swFeat.Name & " spiegelt keine Körper (Typname " & swFeat.GetTypeName2 & ")."
        Exit Sub
    End If

    Set swDaten = swFeat.GetDefinition
    Debug.Print swFeat.Name & ": " & swDaten.GetPatternBodyCount & " Körper, verschmelzen: " & _
                swDaten.Merge & ", zusammenfügen: " & swDaten.KnitSurface

    If False = swDaten.AccessSelections(swModel, Nothing) Then Exit Sub
    vKoerper = swDaten.PatternBodyArray
    If IsArray(vKoerper) Then
        For i = 0 To UBound(vKoerper)
            Set swBody = vKoerper(i)
            Select Case swBody.GetType
                Case swSolidBody: Debug.Print "  " & swBody.Name & " (Volumenkörper)"
                Case swSheetBody: Debug.Print "  " & swBody.Name & " (Flächenkörper)"
                Case Else: Debug.Print "  " & swBody.Name
            End Select
        Next i
    End If
    swDaten.ReleaseSelectionAccess
End Sub

Bemerkungen

MirrorSolid oder MirrorPattern: Features, Flächen und Körper spiegelst du mit demselben Befehl FeatureManager.InsertMirrorFeature2. Welches Objekt Feature.GetDefinition danach liefert, zeigt der Typname aus Feature.GetTypeName2:

  • MirrorSolid: Das Feature spiegelt Körper (BMirrorBody = True). GetDefinition liefert MirrorSolidFeatureData.
  • MirrorPattern: Das Feature spiegelt Features oder Flächen (BMirrorBody = False). GetDefinition liefert MirrorPatternFeatureData mit der Ebene, den Features, den Flächen und den Einstellungen für Mehrkörperteile.

So steht es in der Tabelle der Typnamen bei Feature.GetTypeName2, und so arbeiten die Hilfebeispiele „Get Mirror Solid Feature Data“ und „Get Mirror Pattern Feature Data“. Für ein gespiegeltes Teil (Typname MirrorStock) gibt es MirrorPartFeatureData, für gespiegelte Komponenten einer Baugruppe (MirrorCompFeat) MirrorComponentFeatureData.

Anlegen: Bei FeatureManager.InsertMirrorFeature2 markierst du die Körper mit 256, die Tragwerke mit 134217728 und die Ebene oder ebene Fläche mit 2. Das Hilfebeispiel „Get Mirror Solid Feature Data“ spiegelt so einen Körper an der Ebene „Top“. MirrorSolidFeatureData.Merge und MirrorSolidFeatureData.KnitSurface entsprechen den Parametern BMerge und BKnit.

Ändern: Rufe erst MirrorSolidFeatureData.AccessSelections auf und übernimm Änderungen mit Feature.ModifyDefinition. Ohne Änderung hebst du den Zustand mit MirrorSolidFeatureData.ReleaseSelectionAccess auf. Für Face und PatternBodyArray verweist die Hilfe auf das Thema „Accessing Selections that Define Features“.

Tragwerke: Nach dem Anlegen änderst du mit MirrorSolidFeatureData.StructureSystemToPatternArray, welche Tragwerke gespiegelt werden.

Hilfethema: Für Einzelheiten verweist die Hilfe auf den PropertyManager „Mirror Feature“ in der Hilfe zur Oberfläche.

Eigenschaften und Methoden

Eigenschaften 6, davon 6 beschrieben

NameBeschreibung
FaceLiest oder setzt die Fläche, die die Endbedingung des Features „Spiegeln“ für Körper festlegt.
KnitSurfaceLiest oder setzt, ob beim Spiegeln von Flächenkörpern die Oberflächen zusammengefügt werden.
MergeLiest oder setzt, ob die gespiegelten Körper mit den vorhandenen Körpern des Mehrkörperteils verschmolzen werden.
PatternBodyArrayLiest oder setzt die Körper, die das Feature „Spiegeln“ spiegelt (Ausgangskörper).
PropagateVisualPropertyLiest oder setzt, ob Farben, Texturen und andere sichtbare Eigenschaften auf alle gespiegelten Instanzen übertragen werden.
StructureSystemToPatternArrayLiest oder setzt die Tragwerke, die das Feature „Spiegeln“ spiegelt.

Methoden 4, davon 4 beschrieben

NameBeschreibung
AccessSelectionsSetzt das Modell vor das Feature „Spiegeln“ zurück, damit du die Auswahlen lesen und ändern kannst, die es festlegen.
GetPatternBodyCountLiefert die Zahl der Körper, die das Feature „Spiegeln“ spiegelt.
GetTransformLiefert die Transformation des Features „Spiegeln“ für Körper.
ReleaseSelectionAccessHebt den Rücksetz-Zustand nach AccessSelections wieder auf, wenn du das Feature „Spiegeln“ nicht geändert hast.

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

Siehe auch

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

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