SolidWorksMakroprogrammierung

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.

Deklaration Dim x As SldWorks.MirrorComponentFeatureData · in der englischen .NET-Hilfe: IMirrorComponentFeatureData

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

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 Sub

Bemerkungen

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

NameBeschreibung
AlignmentReferencesLiest oder setzt die Ausrichtungsreferenzen für die Kopien, die an einer Auswahl ausgerichtet gespiegelt werden.
BreakLinksToOriginalPartLiest oder setzt, ob die Verbindung zwischen den entgegengesetzten Versionen und den Originalkomponenten getrennt wird.
ComponentOrientationsAlignToComponentOriginLiest oder setzt die Ausrichtung jeder Kopie, die am Ursprung der Komponente ausgerichtet gespiegelt wird.
ComponentOrientationsAlignToSelectionLiest oder setzt die Ausrichtung jeder Kopie, die an einer Ausrichtungsreferenz ausgerichtet gespiegelt wird.
ComponentsToInstanceAlignToComponentOriginLiest oder setzt die Komponenten, die als gespiegelte Kopie eingefügt und an ihrem Ursprung ausgerichtet werden.
ComponentsToInstanceAlignToSelectionLiest oder setzt die Komponenten, die als gespiegelte Kopie eingefügt und an einer Ausrichtungsreferenz ausgerichtet werden.
CreateDerivedConfigurationsLiest oder setzt, ob die entgegengesetzten Versionen als abgeleitete Konfigurationen entstehen statt als neue Dateien.
DimXpertSchemeLiest oder setzt, ob die entgegengesetzten Versionen das DimXpert-Schema der Originalkomponenten bekommen.
FlipDirectionsLiest oder setzt je Ausrichtungsreferenz, ob die Richtung der Ausrichtung umgekehrt wird.
ForceUseSeedConfigurationLiest oder setzt, ob die gespiegelten Komponenten immer dieselbe Konfiguration haben wie die gespiegelte Ausgangskomponente.
MirrorComponentsFolderLocationLiest oder setzt den vorhandenen Ordner, in dem alle entgegengesetzten Versionen gespeichert werden.
MirroredComponentFilenamesLiest oder setzt die Dateinamen der entgegengesetzten Versionen.
MirrorPlaneLiest oder setzt die Ebene oder ebene Fläche, an der die Komponenten gespiegelt werden.
MirrorTransferOptionsLiest oder setzt, was die entgegengesetzten Versionen aus den Originalkomponenten übernehmen, etwa Körper, Ebenen oder Dateieigenschaften.
MirrorTypeLiest oder setzt, welcher Bezugspunkt der Komponenten an der Spiegelebene gespiegelt wird: Mitte des Begrenzungsrahmens, Schwerpunkt oder Ursprung.
NameModifierLiest oder setzt das Präfix oder Suffix für die Datei- oder Konfigurationsnamen der entgegengesetzten Versionen.
NameModifierTypeLiest oder setzt, wie die Namen der entgegengesetzten Versionen entstehen: mit Präfix, mit Suffix oder mit eigenen Namen.
OppositeHandComponentsLiest oder setzt die Komponenten, für die entgegengesetzte Versionen entstehen.
PlaceFilesInOneFolderLiest oder setzt, ob alle entgegengesetzten Versionen in einem Ordner gespeichert werden.
PreserveZAxisLiest oder setzt, ob die entgegengesetzten Versionen die Ausrichtung der Z-Achse beibehalten.
PropagateFromOriginalPartLiest oder setzt, ob die visuellen Eigenschaften des Ausgangsteils auf die entgegengesetzten Versionen übertragen werden.
ReplaceFileLocationsLiest oder setzt vorhandene Dateien, die durch die neuen entgegengesetzten Versionen ersetzt werden.
SyncFlexibleSubAssembliesLiest oder setzt, ob sich gespiegelte Komponenten in flexiblen Unterbaugruppen mit den Ausgangskomponenten mitbewegen.

Methoden 2, davon 2 beschrieben

NameBeschreibung
AccessSelectionsSetzt das Modell vor das Feature „Komponenten spiegeln“ zurück, damit du die Auswahlen lesen und ändern kannst, die es festlegen.
ReleaseSelectionAccessHebt 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.