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.
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
Feature.GetDefinition: bei einem Feature „Spiegeln“ mit dem TypnamenMirrorSolid
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 SubBemerkungen
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 liefertMirrorPatternFeatureDatamit 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
| Name | Beschreibung |
|---|---|
| Face | Liest oder setzt die Fläche, die die Endbedingung des Features „Spiegeln“ für Körper festlegt. |
| KnitSurface | Liest oder setzt, ob beim Spiegeln von Flächenkörpern die Oberflächen zusammengefügt werden. |
| Merge | Liest oder setzt, ob die gespiegelten Körper mit den vorhandenen Körpern des Mehrkörperteils verschmolzen werden. |
| PatternBodyArray | Liest oder setzt die Körper, die das Feature „Spiegeln“ spiegelt (Ausgangskörper). |
| PropagateVisualProperty | Liest oder setzt, ob Farben, Texturen und andere sichtbare Eigenschaften auf alle gespiegelten Instanzen übertragen werden. |
| StructureSystemToPatternArray | Liest oder setzt die Tragwerke, die das Feature „Spiegeln“ spiegelt. |
Methoden 4, davon 4 beschrieben
| Name | Beschreibung |
|---|---|
| AccessSelections | Setzt das Modell vor das Feature „Spiegeln“ zurück, damit du die Auswahlen lesen und ändern kannst, die es festlegen. |
| GetPatternBodyCount | Liefert die Zahl der Körper, die das Feature „Spiegeln“ spiegelt. |
| GetTransform | Liefert die Transformation des Features „Spiegeln“ für Körper. |
| ReleaseSelectionAccess | Hebt 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.