Objekt · SldWorks
Mate2-Objekt
Steht für eine Verknüpfung in einer Baugruppe: ihre Art, Ausrichtung, Maße und die verknüpften Elemente.
Beschreibung
Jede Verknüpfung im Ordner „Verknüpfungen“ des FeatureManagers ist ein Feature, dahinter steckt ein Mate2-Objekt. Es sagt dir, welche Art von Verknüpfung es ist (Mate2.Type), wie sie ausgerichtet ist (Mate2.Alignment) und welche Elemente sie verbindet (Mate2.MateEntity).
Zugriff
Feature.GetSpecificFeature2: aus einem Unterfeature des Ordners „Verknüpfungen“ (TypnameMateGroup)Component2.GetMates: alle Verknüpfungen einer KomponenteAssemblyDoc.CreateMate,AssemblyDoc.AddDistanceMateundAssemblyDoc.AddConcentricMateWithTolerance: eine neu angelegte VerknüpfungMate2.GetLinkedMate: die zweite Verknüpfung eines Bohrungssatzes
Beispiel
' Gibt Name, Art und Komponenten aller Verknüpfungen der aktiven Baugruppe aus.
' Vorbedingung: Eine Baugruppe mit Verknüpfungen ist geöffnet.
' Ergebnis: Eine Zeile je Verknüpfung im Direktfenster (Strg+G).
Option Explicit
Sub main()
Dim swApp As SldWorks.SldWorks
Dim swModel As SldWorks.ModelDoc2
Dim swFeat As SldWorks.Feature
Dim swSubFeat As SldWorks.Feature
Dim swMate As SldWorks.Mate2
Dim swMateEnt As SldWorks.MateEntity2
Dim sZeile As String
Dim i As Long
Set swApp = Application.SldWorks
Set swModel = swApp.ActiveDoc
If swModel Is Nothing Then Exit Sub
If swModel.GetType <> swDocASSEMBLY Then Exit Sub
' Ordner "Verknüpfungen" suchen
Set swFeat = swModel.FirstFeature
Do While Not swFeat Is Nothing
If swFeat.GetTypeName2 = "MateGroup" Then Exit Do
Set swFeat = swFeat.GetNextFeature
Loop
If swFeat Is Nothing Then Exit Sub
Set swSubFeat = swFeat.GetFirstSubFeature
Do While Not swSubFeat Is Nothing
If TypeOf swSubFeat.GetSpecificFeature2 Is SldWorks.Mate2 Then
Set swMate = swSubFeat.GetSpecificFeature2
sZeile = swSubFeat.Name & ": Art " & swMate.Type
For i = 0 To swMate.GetMateEntityCount - 1
Set swMateEnt = swMate.MateEntity(i)
If Not swMateEnt.ReferenceComponent Is Nothing Then
sZeile = sZeile & ", " & swMateEnt.ReferenceComponent.Name2
End If
Next i
Debug.Print sZeile
End If
Set swSubFeat = swSubFeat.GetNextSubFeature
Loop
End SubBemerkungen
Unterfeatures: Eine Verknüpfung ist ein Unterfeature des Ordners mit dem Typnamen MateGroup. Du gehst darum mit Feature.GetFirstSubFeature und Feature.GetNextSubFeature durch den Ordner und holst das Mate2-Objekt mit Feature.GetSpecificFeature2. In dem Ordner können auch andere Objekte liegen, etwa Ordner oder InPlace-Verknüpfungen (MateInPlace), darum prüft das Beispiel mit TypeOf.
Ändern: Die meisten Eigenschaften sind nur lesbar. Ändern kannst du eine Verknüpfung heute über ihre Feature-Daten: Feature.GetDefinition holt sie (etwa als DistanceMateFeatureData), danach übernimmt Feature.ModifyDefinition die Änderung. AssemblyDoc.EditMate4 ist veraltet. Längen sind in Metern, Winkel im Bogenmaß.
Eigenschaften und Methoden
Eigenschaften 15, davon 14 beschrieben, 1 veraltet
| Name | Beschreibung |
|---|---|
| Alignment | Liefert die Ausrichtung einer Verknüpfung: gleich, entgegengesetzt oder am nächsten. |
| CanBeFlipped | Prüft, ob sich eine Abstands- oder Winkelverknüpfung umkehren lässt. |
| DisplayDimension | veraltet ersetzt durch Mate2.DisplayDimension2 |
| DisplayDimension2 | Liefert das Maß einer Verknüpfung, bei Zahnradverknüpfungen auch das zweite. |
| DistanceFirstArcCondition | Liefert bei einer Abstandsverknüpfung zwischen Zylindern, ob der Abstand am ersten Element von Mitte, Minimum oder Maximum gemessen wird. |
| DistanceSecondArcCondition | Liefert bei einer Abstandsverknüpfung zwischen Zylindern, ob der Abstand am zweiten Element von Mitte, Minimum oder Maximum gemessen wird. |
| Flipped | Liefert oder ändert, ob eine Abstands- oder Winkelverknüpfung umgekehrt ist. |
| HasLoadBearingFaces | Prüft, ob für eine Verknüpfung lasttragende Flächen festgelegt sind. |
| HasTreatInterferenceAsShrinkFit | Prüft, ob eine Überschneidung an der Verknüpfung als Schrumpf- oder Presspassung behandelt wird. |
| IsLoadBearingFacesBonded | Prüft, ob die lasttragenden Flächen einer Verknüpfung verbunden sind. |
| LockMagneticMate | Liefert oder ändert, ob eine magnetische Verknüpfung gesperrt ist. |
| MateLoadReference | Liefert die Lastreferenz einer Verknüpfung, falls es eine gibt. |
| MaximumVariation | Liefert bei einer Abstands- oder Winkelverknüpfung den Abstand der Obergrenze zum Maß. |
| MinimumVariation | Liefert bei einer Abstands- oder Winkelverknüpfung den Abstand der Untergrenze zum Maß. |
| Type | Liefert die Art einer Verknüpfung, etwa deckungsgleich, konzentrisch oder Abstand. |
Methoden 17, davon 17 beschrieben
| Name | Beschreibung |
|---|---|
| ForceMisalignment | Macht eine konzentrische Verknüpfung zu einer versetzten, die eine kleine Abweichung zulässt. |
| GetConcentricAlignmentType | Liefert, wie eine versetzte konzentrische Verknüpfung ausgerichtet wird. |
| GetCurrentMisalignedDeviation | Liefert die aktuelle Abweichung einer versetzten konzentrischen Verknüpfung. |
| GetForce | Liefert Betrag und Richtung der Kraft, die an einer Verknüpfung anliegt. |
| GetLinkedMate | Liefert die zweite konzentrische Verknüpfung eines Bohrungssatzes. |
| GetMateEntityCount | Liefert die Anzahl der Elemente, die eine Verknüpfung verbindet. |
| GetMaximumMisalignedDeviation | Liefert die größte erlaubte Abweichung einer versetzten konzentrischen Verknüpfung. |
| GetSupplementalFaces | Liefert zusätzliche Flächen einer Verknüpfung zu einer der beiden Komponenten. |
| GetTorque | Liefert den Winkel und die Achse eines Drehmoments an einer Verknüpfung. |
| GetUseMisalignedDeviationDocumentProperty | Prüft, ob eine versetzte konzentrische Verknüpfung die Grenze aus den Dokumenteigenschaften benutzt. |
| MateEntity | Liefert ein verknüpftes Element einer Verknüpfung, mit Komponente und Geometrie. |
| RemoveMisalignment | Hebt den Versatz einer versetzten konzentrischen Verknüpfung auf. |
| SetConcentricAlignmentType | Legt fest, wie eine versetzte konzentrische Verknüpfung ausgerichtet wird. |
| SetForce | Legt Betrag und Richtung einer Kraft an einer Verknüpfung fest. |
| SetMaximumMisalignedDeviation | Legt die größte erlaubte Abweichung einer versetzten konzentrischen Verknüpfung fest. |
| SetTorque | Legt Winkel und Achse eines Drehmoments an einer Verknüpfung fest. |
| SetUseMisalignedDeviationDocumentProperty | Legt fest, ob eine versetzte konzentrische Verknüpfung die Grenze aus den Dokumenteigenschaften benutzt. |
Nicht aufgeführt sind 1 C++-Varianten (Namen mit I davor, zum Beispiel IGetSupplementalFaces). In VBA nimmst du immer den Befehl ohne I.
Siehe auch
Englisches Original: IMate2 in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)
Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.