SolidWorksMakroprogrammierung

Objekt · SldWorks

MirrorPatternFeatureData-Objekt

Die Feature-Daten eines Features „Spiegeln“, das Features oder Flächen spiegelt: Ebene, gespiegelte Features und Flächen, Geometriemuster und beeinflusste Körper.

Deklaration Dim x As SldWorks.MirrorPatternFeatureData · in der englischen .NET-Hilfe: IMirrorPatternFeatureData

Beschreibung

MirrorPatternFeatureData gibt Zugriff auf ein Feature „Spiegeln“ (mirror pattern). Es spiegelt Features oder Flächen eines Teils an einer Referenzebene oder ebenen Fläche. Spiegelt das Feature Körper, liefert Feature.GetDefinition ein anderes Objekt, MirrorSolidFeatureData (siehe Bemerkungen). Die ersten Befehle gibt es seit SOLIDWORKS 2000 SP02, die Einstellungen für Mehrkörperteile seit SOLIDWORKS 2008.

Zugriff

Angelegt wird das Feature mit FeatureManager.InsertMirrorFeature2 und BMirrorBody = False. FeatureManager.CreateDefinition kennt beim Spiegeln nur gespiegelte Komponenten in Baugruppen.

Beispiel

' Gibt für das ausgewählte Feature „Spiegeln“ die Ebene, die gespiegelten Features
' und die Zahl der gespiegelten Flächen aus.
' Vorbedingung: Ein Teil ist offen, ein Feature „Spiegeln“ 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.MirrorPatternFeatureData
    Dim swEbene As SldWorks.Feature
    Dim swAusgang As SldWorks.Feature
    Dim vFeatures 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 Körper, die Daten stehen in MirrorSolidFeatureData."
        Exit Sub
    End If
    If swFeat.GetTypeName2 <> "MirrorPattern" Then Exit Sub

    Set swDaten = swFeat.GetDefinition
    Debug.Print swFeat.Name & ": " & swDaten.GetPatternFeatureCount & " Feature(s), " & _
                swDaten.GetMirrorFaceCount & " Fläche(n), nur Geometrie: " & swDaten.GeometryPattern

    If False = swDaten.AccessSelections(swModel, Nothing) Then Exit Sub
    If swDaten.GetMirrorPlaneType = 1 Then                     ' 1 = Referenzebene, 0 = Fläche
        Set swEbene = swDaten.Plane
        Debug.Print "Gespiegelt an " & swEbene.Name
    Else
        Debug.Print "Gespiegelt an einer ebenen Fläche"
    End If
    vFeatures = swDaten.PatternFeatureArray
    If IsArray(vFeatures) Then
        For i = 0 To UBound(vFeatures)
            Set swAusgang = vFeatures(i)
            Debug.Print "  " & swAusgang.Name
        Next i
    End If
    swDaten.ReleaseSelectionAccess
End Sub

Bemerkungen

MirrorPattern oder MirrorSolid: 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:

  • MirrorPattern: Das Feature spiegelt Features oder Flächen (BMirrorBody = False). GetDefinition liefert MirrorPatternFeatureData.
  • MirrorSolid: Das Feature spiegelt Körper (BMirrorBody = True). GetDefinition liefert MirrorSolidFeatureData mit den gespiegelten Körpern und den Optionen zum Verschmelzen und Zusammenfügen.

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

Anlegen: Bei FeatureManager.InsertMirrorFeature2 markierst du die Features mit 1, die Flächen mit 128 und die Ebene oder ebene Fläche mit 2. Das Hilfebeispiel „Get Mirror Pattern Feature Data“ spiegelt so zwei Features an einer Fläche des Teils.

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

Mehrkörperteile: MirrorPatternFeatureData.FeatureScope und MirrorPatternFeatureData.FeatureScopeBodies gelten nur, wenn MirrorPatternFeatureData.GeometryPattern True ist. Für Einzelheiten verweist die Hilfe auf den PropertyManager „Mirror Feature“ in der Hilfe zur Oberfläche.

Eigenschaften und Methoden

Eigenschaften 7, davon 7 beschrieben

NameBeschreibung
FeatureScopeLiest oder setzt, welche Körper eines Mehrkörperteils das Feature „Spiegeln“ beeinflusst: alle oder nur angegebene.
FeatureScopeBodiesLiest oder setzt die Körper eines Mehrkörperteils, die das Feature „Spiegeln“ beeinflusst.
GeometryPatternLiest oder setzt, ob das Feature „Spiegeln“ nur die Geometrie (Flächen und Kanten) der Features spiegelt.
MirrorFaceArrayLiest oder setzt die Flächen, die das Feature „Spiegeln“ spiegelt.
PatternFeatureArrayLiest oder setzt die Features, die das Feature „Spiegeln“ spiegelt (Ausgangsfeatures).
PlaneLiest oder setzt die Referenzebene oder ebene Fläche, an der das Feature „Spiegeln“ spiegelt.
PropagateVisualPropertyLiest oder setzt, ob Farben, Texturen und andere sichtbare Eigenschaften auf alle gespiegelten Instanzen übertragen werden.

Methoden 6, davon 6 beschrieben

NameBeschreibung
AccessSelectionsSetzt das Modell vor das Feature „Spiegeln“ zurück, damit du die Auswahlen lesen und ändern kannst, die es festlegen.
GetFeatureScopeBodiesCountLiefert die Zahl der Körper eines Mehrkörperteils, die das Feature „Spiegeln“ beeinflusst.
GetMirrorFaceCountLiefert die Zahl der Flächen, die das Feature „Spiegeln“ spiegelt.
GetMirrorPlaneTypeLiefert, ob das Feature „Spiegeln“ an einer Fläche oder an einer Referenzebene spiegelt.
GetPatternFeatureCountLiefert die Zahl der Features, die das Feature „Spiegeln“ spiegelt.
ReleaseSelectionAccessHebt den Rücksetz-Zustand nach AccessSelections wieder auf, wenn du das Feature „Spiegeln“ nicht geändert hast.

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

Siehe auch

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

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