Objekt · SldWorks
MirrorComponentFeatureData-Objekt
Die Definition des Features „Komponenten spiegeln“ in einer Baugruppe: Spiegelebene und Position, gespiegelte Kopien mit ihrer Ausrichtung und entgegengesetzte Versionen mit Namen, Ablage und Übernahme.
Beschreibung
MirrorComponentFeatureData gibt Zugriff auf ein Feature „Komponenten spiegeln“ (mirror components). Es spiegelt Komponenten einer Baugruppe an einer Referenzebene oder ebenen Fläche, auf zwei Arten:
- Gespiegelte Kopie (Instanz): Die Komponente wird noch einmal eingefügt, symmetrisch zur Ebene und in einer von vier Ausrichtungen. Bei vollständig symmetrischen Komponenten sind alle vier echte Spiegelbilder.
- Entgegengesetzte Version (opposite-hand version): ein echtes Spiegelbild einer nicht symmetrischen Komponente. Dafür entsteht eine neue Datei oder eine abgeleitete Konfiguration.
Die Befehle mit eigener Seite in der .NET-Hilfe gibt es seit SOLIDWORKS 2020. Sie ersetzen die veraltete Methode AssemblyDoc.MirrorComponents3.
Zugriff
FeatureManager.CreateDefinitionmitswFmMirrorComponent: Daten für ein neues Feature „Komponenten spiegeln“, das du mitFeatureManager.CreateFeatureanlegstFeature.GetDefinition: aus einem vorhandenen Feature „Komponenten spiegeln“ (TypnameMirrorCompFeat)
Beispiel
' Spiegelt die ausgewählten Komponenten als Kopien an der ausgewählten Ebene. Gespiegelt
' werden die Ursprünge der Komponenten, die Kopien sind an ihren Ursprüngen ausgerichtet.
' Vorbedingung: Eine Baugruppe ist offen. Zuerst ist eine Referenzebene ausgewählt,
' dazu mit Strg eine oder mehrere Komponenten.
' Ergebnis: Im FeatureManager steht ein neues Feature „Komponenten spiegeln“,
' sein Name steht im Direktfenster.
Option Explicit
Sub main()
Dim swApp As SldWorks.SldWorks
Dim swModel As SldWorks.ModelDoc2
Dim swSelMgr As SldWorks.SelectionMgr
Dim swEbene As SldWorks.Feature
Dim swDaten As SldWorks.MirrorComponentFeatureData
Dim swFeat As SldWorks.Feature
Dim aKomp() As Object
Dim vKomp As Variant
Dim i As Long, n As Long
Set swApp = Application.SldWorks
Set swModel = swApp.ActiveDoc
If swModel Is Nothing Then Exit Sub
If swModel.GetType <> swDocASSEMBLY Then Exit Sub
Set swSelMgr = swModel.SelectionManager
n = swSelMgr.GetSelectedObjectCount2(-1)
If n < 2 Then Exit Sub
If swSelMgr.GetSelectedObjectType3(1, -1) <> swSelDATUMPLANES Then Exit Sub
Set swEbene = swSelMgr.GetSelectedObject6(1, -1)
ReDim aKomp(n - 2)
For i = 2 To n
Set aKomp(i - 2) = swSelMgr.GetSelectedObjectsComponent4(i, -1)
If aKomp(i - 2) Is Nothing Then Exit Sub
Next i
vKomp = aKomp
Set swDaten = swModel.FeatureManager.CreateDefinition(swFmMirrorComponent)
swDaten.MirrorPlane = swEbene ' ohne Set wie im Hilfebeispiel
swDaten.MirrorType = swMirrorType_ComponentOrigin
swDaten.ComponentsToInstanceAlignToComponentOrigin = vKomp
Set swFeat = swModel.FeatureManager.CreateFeature(swDaten)
If swFeat Is Nothing Then
Debug.Print "Nicht gespiegelt"
Else
Debug.Print "Neues Feature: " & swFeat.Name & " (Typname " & swFeat.GetTypeName2 & ")"
End If
End SubBemerkungen
Anlegen: Du brauchst mindestens MirrorComponentFeatureData.MirrorPlane und MirrorComponentFeatureData.ComponentsToInstanceAlignToComponentOrigin. Ohne Angabe gilt für MirrorComponentFeatureData.MirrorType swMirrorType_CenterOfBoundingBox und für die Ausrichtung der Kopien swOrientation_MirroredX_MirroredY. Danach legst du das Feature mit FeatureManager.CreateFeature an. Die Elemente kannst du auch vor FeatureManager.CreateDefinition mit ModelDocExtension.SelectByID2 auswählen: die Spiegelebene mit der Markierung 1, die zu spiegelnden Komponenten mit 2 und die Ausrichtungsreferenzen mit 4. In welche der Listen die Komponenten dann kommen, sagt die Hilfe nicht.
Ändern: Rufe erst MirrorComponentFeatureData.AccessSelections auf und übernimm Änderungen mit Feature.ModifyDefinition. Ohne Änderung hebst du den Zustand mit MirrorComponentFeatureData.ReleaseSelectionAccess auf. Das Hilfebeispiel „Mirror Components II“ ändert das neue Feature dagegen ohne AccessSelections: Es holt die Daten mit Feature.GetDefinition, setzt MirrorType und die Ausrichtungen neu und ruft ModifyDefinition auf.
Elemente zuweisen: Das Hilfebeispiel weist die Spiegelebene und alle Arrays ohne Set zu. Als Spiegelebene und als Ausrichtungsreferenzen übergibt es Features von Ebenen aus AssemblyDoc.FeatureByName, obwohl die Hilfe als Werte RefPlane, Face2 und andere Elemente nennt.
Ohne eigene Seite: Zehn Eigenschaften haben in der .NET-Hilfe keine eigene Seite, darunter die vier Listen für Kopien und ihre Ausrichtungen. Die Hilfe beschreibt sie nur in der Liste der Befehle, die meisten auch in der Übersicht zum Objekt. Für einige steht mehr beim entsprechenden Parameter der veralteten Methode AssemblyDoc.MirrorComponents3.
Mehr dazu: Die Hilfe verweist auf den PropertyManager „Mirror Components“ und auf die Themen „Comparing Types of Mirror Components“ und „Mirroring Components“ in der Hilfe zur Oberfläche. Ob eine Komponente gespiegelt ist, liefert Component2.IsMirrored.
Eigenschaften und Methoden
Eigenschaften 23, davon 23 beschrieben
| Name | Beschreibung |
|---|---|
| AlignmentReferences | Liest oder setzt die Ausrichtungsreferenzen für die Kopien, die an einer Auswahl ausgerichtet gespiegelt werden. |
| BreakLinksToOriginalPart | Liest oder setzt, ob die Verbindung zwischen den entgegengesetzten Versionen und den Originalkomponenten getrennt wird. |
| ComponentOrientationsAlignToComponentOrigin | Liest oder setzt die Ausrichtung jeder Kopie, die am Ursprung der Komponente ausgerichtet gespiegelt wird. |
| ComponentOrientationsAlignToSelection | Liest oder setzt die Ausrichtung jeder Kopie, die an einer Ausrichtungsreferenz ausgerichtet gespiegelt wird. |
| ComponentsToInstanceAlignToComponentOrigin | Liest oder setzt die Komponenten, die als gespiegelte Kopie eingefügt und an ihrem Ursprung ausgerichtet werden. |
| ComponentsToInstanceAlignToSelection | Liest oder setzt die Komponenten, die als gespiegelte Kopie eingefügt und an einer Ausrichtungsreferenz ausgerichtet werden. |
| CreateDerivedConfigurations | Liest oder setzt, ob die entgegengesetzten Versionen als abgeleitete Konfigurationen entstehen statt als neue Dateien. |
| DimXpertScheme | Liest oder setzt, ob die entgegengesetzten Versionen das DimXpert-Schema der Originalkomponenten bekommen. |
| FlipDirections | Liest oder setzt je Ausrichtungsreferenz, ob die Richtung der Ausrichtung umgekehrt wird. |
| ForceUseSeedConfiguration | Liest oder setzt, ob die gespiegelten Komponenten immer dieselbe Konfiguration haben wie die gespiegelte Ausgangskomponente. |
| MirrorComponentsFolderLocation | Liest oder setzt den vorhandenen Ordner, in dem alle entgegengesetzten Versionen gespeichert werden. |
| MirroredComponentFilenames | Liest oder setzt die Dateinamen der entgegengesetzten Versionen. |
| MirrorPlane | Liest oder setzt die Ebene oder ebene Fläche, an der die Komponenten gespiegelt werden. |
| MirrorTransferOptions | Liest oder setzt, was die entgegengesetzten Versionen aus den Originalkomponenten übernehmen, etwa Körper, Ebenen oder Dateieigenschaften. |
| MirrorType | Liest oder setzt, welcher Bezugspunkt der Komponenten an der Spiegelebene gespiegelt wird: Mitte des Begrenzungsrahmens, Schwerpunkt oder Ursprung. |
| NameModifier | Liest oder setzt das Präfix oder Suffix für die Datei- oder Konfigurationsnamen der entgegengesetzten Versionen. |
| NameModifierType | Liest oder setzt, wie die Namen der entgegengesetzten Versionen entstehen: mit Präfix, mit Suffix oder mit eigenen Namen. |
| OppositeHandComponents | Liest oder setzt die Komponenten, für die entgegengesetzte Versionen entstehen. |
| PlaceFilesInOneFolder | Liest oder setzt, ob alle entgegengesetzten Versionen in einem Ordner gespeichert werden. |
| PreserveZAxis | Liest oder setzt, ob die entgegengesetzten Versionen die Ausrichtung der Z-Achse beibehalten. |
| PropagateFromOriginalPart | Liest oder setzt, ob die visuellen Eigenschaften des Ausgangsteils auf die entgegengesetzten Versionen übertragen werden. |
| ReplaceFileLocations | Liest oder setzt vorhandene Dateien, die durch die neuen entgegengesetzten Versionen ersetzt werden. |
| SyncFlexibleSubAssemblies | Liest oder setzt, ob sich gespiegelte Komponenten in flexiblen Unterbaugruppen mit den Ausgangskomponenten mitbewegen. |
Methoden 2, davon 2 beschrieben
| Name | Beschreibung |
|---|---|
| AccessSelections | Setzt das Modell vor das Feature „Komponenten spiegeln“ zurück, damit du die Auswahlen lesen und ändern kannst, die es festlegen. |
| ReleaseSelectionAccess | Hebt den Rücksetz-Zustand nach AccessSelections wieder auf, wenn du das Feature „Komponenten spiegeln“ nicht geändert hast. |
Siehe auch
Englisches Original: IMirrorComponentFeatureData in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)
Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.