SolidWorksMakroprogrammierung

Methode · AssemblyDoc

CopyWithMates2-Methode (AssemblyDoc)

Kopiert Komponenten mitsamt ihren Verknüpfungen und hängt die Kopien an neue Referenzen.

Syntax

Function CopyWithMates2( _
   ByVal ComponentsToCopy As Variant, _
   ByVal Repeat As Variant, _
   ByVal NewEnityToMateTo As Variant, _
   ByVal Values As Variant, _
   ByVal FlipAlignment As Variant, _
   ByVal FlipDimension As Variant, _
   ByVal LockRotation As Variant, _
   ByVal Orientation As Variant _
) As Boolean
bErfolg = swAssy.CopyWithMates2(vKomp, vWdh, vNeu, vWerte, vFlipA, vFlipD, vSperre, vRicht)

Parameter

ComponentsToCopyVariantByVal
Array mit den zu kopierenden Komponenten.
RepeatVariantByVal
Array mit Boolean je Verknüpfungsreferenz: True übernimmt die bisherige Referenz, False nimmt die aus NewEnityToMateTo.
NewEnityToMateToVariantByVal
Array mit neuen Referenzen, passend zu Repeat.
ValuesVariantByVal
Array mit Abständen (Meter) oder Winkeln (Bogenmaß), nur für Abstands-, Winkel- und Profilmittelpunkt-Verknüpfungen.
FlipAlignmentVariantByVal
Array mit Boolean: Ausrichtung umkehren.
FlipDimensionVariantByVal
Array mit Boolean: Richtung des Abstands.
LockRotationVariantByVal
Array mit Boolean: Drehung sperren, nur für konzentrische und Profilmittelpunkt-Verknüpfungen.
OrientationVariantByVal
Array mit Ganzzahlen für die Ausrichtung, siehe Bemerkungen.

Rückgabewert

True, wenn es geklappt hat, sonst False.

Beispiel

' swAssy ist das AssemblyDoc, etwa per Set swAssy = swModel.
' swComp ist die Schraube mit einer konzentrischen Verknüpfung, swFlaeche die neue Bohrungsfläche.
Dim aKomp(0) As SldWorks.Component2, aWdh(0) As Boolean, aNeu(0) As Object, aWerte(0) As Double
Dim aFlipA(0) As Boolean, aFlipD(0) As Boolean, aSperre(0) As Boolean, aRicht(0) As Long
Dim bOk As Boolean
Set aKomp(0) = swComp                           ' typisierte Arrays wie im Hilfebeispiel
aWdh(0) = False                                 ' neue Referenz nehmen
Set aNeu(0) = swFlaeche
bOk = swAssy.CopyWithMates2(aKomp, aWdh, aNeu, aWerte, aFlipA, aFlipD, aSperre, aRicht)
If False = bOk Then Debug.Print "Nicht kopiert"

Bemerkungen

Die Arrays gehören Element für Element zu den Verknüpfungsreferenzen der kopierten Komponenten. Die Beschreibung von Orientation ist in der Hilfe abgeschnitten, sie spricht von der Anzahl „Klicks“ wie in der Oberfläche. Das Beispiel folgt mit typisierten Arrays dem Hilfebeispiel „Copy Component With Profile Center Mate“. In SOLIDWORKS 2024 nahmen andere Befehle dieses Objekts mit Array(...) gebaute Arrays aus SOLIDWORKS-Objekten nicht an. Ausgeführt ist das Beispiel nicht.

Siehe auch

Verfügbarkeit

SOLIDWORKS 2016

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

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