SolidWorksMakroprogrammierung

Objekt · SldWorks

Mate2-Objekt

Steht für eine Verknüpfung in einer Baugruppe: ihre Art, Ausrichtung, Maße und die verknüpften Elemente.

Deklaration Dim x As SldWorks.Mate2 · in der englischen .NET-Hilfe: IMate2

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

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 Sub

Bemerkungen

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

NameBeschreibung
AlignmentLiefert die Ausrichtung einer Verknüpfung: gleich, entgegengesetzt oder am nächsten.
CanBeFlippedPrüft, ob sich eine Abstands- oder Winkelverknüpfung umkehren lässt.
DisplayDimensionveraltet ersetzt durch Mate2.DisplayDimension2
DisplayDimension2Liefert das Maß einer Verknüpfung, bei Zahnradverknüpfungen auch das zweite.
DistanceFirstArcConditionLiefert bei einer Abstandsverknüpfung zwischen Zylindern, ob der Abstand am ersten Element von Mitte, Minimum oder Maximum gemessen wird.
DistanceSecondArcConditionLiefert bei einer Abstandsverknüpfung zwischen Zylindern, ob der Abstand am zweiten Element von Mitte, Minimum oder Maximum gemessen wird.
FlippedLiefert oder ändert, ob eine Abstands- oder Winkelverknüpfung umgekehrt ist.
HasLoadBearingFacesPrüft, ob für eine Verknüpfung lasttragende Flächen festgelegt sind.
HasTreatInterferenceAsShrinkFitPrüft, ob eine Überschneidung an der Verknüpfung als Schrumpf- oder Presspassung behandelt wird.
IsLoadBearingFacesBondedPrüft, ob die lasttragenden Flächen einer Verknüpfung verbunden sind.
LockMagneticMateLiefert oder ändert, ob eine magnetische Verknüpfung gesperrt ist.
MateLoadReferenceLiefert die Lastreferenz einer Verknüpfung, falls es eine gibt.
MaximumVariationLiefert bei einer Abstands- oder Winkelverknüpfung den Abstand der Obergrenze zum Maß.
MinimumVariationLiefert bei einer Abstands- oder Winkelverknüpfung den Abstand der Untergrenze zum Maß.
TypeLiefert die Art einer Verknüpfung, etwa deckungsgleich, konzentrisch oder Abstand.

Methoden 17, davon 17 beschrieben

NameBeschreibung
ForceMisalignmentMacht eine konzentrische Verknüpfung zu einer versetzten, die eine kleine Abweichung zulässt.
GetConcentricAlignmentTypeLiefert, wie eine versetzte konzentrische Verknüpfung ausgerichtet wird.
GetCurrentMisalignedDeviationLiefert die aktuelle Abweichung einer versetzten konzentrischen Verknüpfung.
GetForceLiefert Betrag und Richtung der Kraft, die an einer Verknüpfung anliegt.
GetLinkedMateLiefert die zweite konzentrische Verknüpfung eines Bohrungssatzes.
GetMateEntityCountLiefert die Anzahl der Elemente, die eine Verknüpfung verbindet.
GetMaximumMisalignedDeviationLiefert die größte erlaubte Abweichung einer versetzten konzentrischen Verknüpfung.
GetSupplementalFacesLiefert zusätzliche Flächen einer Verknüpfung zu einer der beiden Komponenten.
GetTorqueLiefert den Winkel und die Achse eines Drehmoments an einer Verknüpfung.
GetUseMisalignedDeviationDocumentPropertyPrüft, ob eine versetzte konzentrische Verknüpfung die Grenze aus den Dokumenteigenschaften benutzt.
MateEntityLiefert ein verknüpftes Element einer Verknüpfung, mit Komponente und Geometrie.
RemoveMisalignmentHebt den Versatz einer versetzten konzentrischen Verknüpfung auf.
SetConcentricAlignmentTypeLegt fest, wie eine versetzte konzentrische Verknüpfung ausgerichtet wird.
SetForceLegt Betrag und Richtung einer Kraft an einer Verknüpfung fest.
SetMaximumMisalignedDeviationLegt die größte erlaubte Abweichung einer versetzten konzentrischen Verknüpfung fest.
SetTorqueLegt Winkel und Achse eines Drehmoments an einer Verknüpfung fest.
SetUseMisalignedDeviationDocumentPropertyLegt 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.