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.
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
Feature.GetDefinition: bei einem Feature „Spiegeln“ mit dem TypnamenMirrorPattern
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 SubBemerkungen
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 liefertMirrorSolidFeatureDatamit 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
| Name | Beschreibung |
|---|---|
| FeatureScope | Liest oder setzt, welche Körper eines Mehrkörperteils das Feature „Spiegeln“ beeinflusst: alle oder nur angegebene. |
| FeatureScopeBodies | Liest oder setzt die Körper eines Mehrkörperteils, die das Feature „Spiegeln“ beeinflusst. |
| GeometryPattern | Liest oder setzt, ob das Feature „Spiegeln“ nur die Geometrie (Flächen und Kanten) der Features spiegelt. |
| MirrorFaceArray | Liest oder setzt die Flächen, die das Feature „Spiegeln“ spiegelt. |
| PatternFeatureArray | Liest oder setzt die Features, die das Feature „Spiegeln“ spiegelt (Ausgangsfeatures). |
| Plane | Liest oder setzt die Referenzebene oder ebene Fläche, an der das Feature „Spiegeln“ spiegelt. |
| PropagateVisualProperty | Liest oder setzt, ob Farben, Texturen und andere sichtbare Eigenschaften auf alle gespiegelten Instanzen übertragen werden. |
Methoden 6, davon 6 beschrieben
| Name | Beschreibung |
|---|---|
| AccessSelections | Setzt das Modell vor das Feature „Spiegeln“ zurück, damit du die Auswahlen lesen und ändern kannst, die es festlegen. |
| GetFeatureScopeBodiesCount | Liefert die Zahl der Körper eines Mehrkörperteils, die das Feature „Spiegeln“ beeinflusst. |
| GetMirrorFaceCount | Liefert die Zahl der Flächen, die das Feature „Spiegeln“ spiegelt. |
| GetMirrorPlaneType | Liefert, ob das Feature „Spiegeln“ an einer Fläche oder an einer Referenzebene spiegelt. |
| GetPatternFeatureCount | Liefert die Zahl der Features, die das Feature „Spiegeln“ spiegelt. |
| ReleaseSelectionAccess | Hebt 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.