SolidWorksMakroprogrammierung

Objekt · SldWorks

Mate-Objekt

Veraltetes Objekt für eine Verknüpfung in einer Baugruppe: Elemente, Art, Ausrichtung und Maß. Mate2 tritt an seine Stelle.

Deklaration Dim x As SldWorks.Mate · in der englischen .NET-Hilfe: IMate

Beschreibung

Mate ist mit allen Befehlen veraltet und durch Mate2 ersetzt. Das Objekt stand für eine Verknüpfung in einer Baugruppe: ihre beiden Elemente, ihre Art und Ausrichtung und ihr Maß. Seit wann es veraltet ist, sagt die Hilfe nicht.

Zugriff

Die alte Hilfe beschreibt, wie du das Objekt mit Feature.GetSpecificFeature2 aus einem Unterfeature des Ordners mit dem Typnamen MateGroup holtest. Denselben Weg beschreibt die Hilfe heute für Mate2.

Beispiel

' Gibt Name, Art, Ausrichtung, Zahl der Elemente und Maß aller Verknüpfungen der aktiven Baugruppe aus.
' Vorbedingung: Eine Baugruppe mit Verknüpfungen ist offen.
' Ergebnis:     Eine Zeile je Verknüpfung im Direktfenster, die Baugruppe bleibt unverändert.
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 swSpez As Object
    Dim swMate As SldWorks.Mate2                               ' statt Mate
    Dim swDispDim As SldWorks.DisplayDimension
    Dim vWerte As Variant
    Dim sZeile As String

    Set swApp = Application.SldWorks
    Set swModel = swApp.ActiveDoc
    If swModel Is Nothing Then Exit Sub
    If swModel.GetType <> swDocASSEMBLY Then Exit Sub

    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
        Set swSpez = swSubFeat.GetSpecificFeature2
        If TypeOf swSpez Is SldWorks.Mate2 Then
            Set swMate = swSpez
            sZeile = swSubFeat.Name & ": Art " & swMate.Type & _
                     ", Ausrichtung " & swMate.Alignment               ' früher GetMateParams
            sZeile = sZeile & ", " & swMate.GetMateEntityCount & " Elemente"   ' früher GetMateEntities
            Set swDispDim = swMate.DisplayDimension2(0)                ' früher GetMateDimensionValue
            If Not swDispDim Is Nothing Then
                vWerte = swDispDim.GetDimension2(0).GetSystemValue3(swThisConfiguration, Empty)
                sZeile = sZeile & ", Maß " & vWerte(0) & " (m oder rad)"
            End If
            Debug.Print sZeile
        End If
        Set swSubFeat = swSubFeat.GetNextSubFeature
    Loop
End Sub

Bemerkungen

Ersatz: Mate2.MateEntity ersetzt den Befehl GetEntity und Mate2.DisplayDimension2 den Befehl GetMateDimensionValue. GetMateEntities und GetMateParams haben keinen Nachfolger. An Mate2 liest du die Elemente einzeln mit Mate2.MateEntity, ihre Anzahl mit Mate2.GetMateEntityCount. Art, Ausrichtung und Umkehrbarkeit liefern Mate2.Type, Mate2.Alignment und Mate2.CanBeFlipped.

Element statt Fläche: Mate.GetEntity lieferte die Fläche, Kante usw. selbst. Der Nachfolger Mate2.MateEntity liefert dagegen ein MateEntity2, das Element selbst holst du dort mit MateEntity2.Reference.

Andere Zahlen: Mate.GetMateParams lieferte ein Array mit drei Zahlen: die Art, die Ausrichtung mit 1 für gleich und 2 für entgegengesetzt ausgerichtet und die Umkehrbarkeit mit 2 für umkehrbar, sonst 1. Welche Werte die Art hatte, sagt die alte Hilfe nicht. Mate2.Alignment liefert dagegen einen Wert aus swMateAlign_e mit 0 für gleich und 1 für entgegengesetzt, Mate2.CanBeFlipped ein Boolean und Mate2.Type einen Wert aus swMateType_e.

Aus der alten Hilfe: Mate.GetMateDimensionValue lieferte ein Array mit einer Zahl: einen Abstand in Metern oder einen Winkel im Bogenmaß, je nach Art, und 0, wenn die Verknüpfung kein Maß hat. Das Element aus Mate.GetEntity galt nur in der Baugruppe, zu der die Verknüpfung gehört. Beim Ursprung einer Komponente war es Nothing, bei Komponenten, die reduziert (Lightweight) geladen sind, lieferte der Befehl kein Element.

Eigenschaften und Methoden

Methoden 4, davon 0 beschrieben, 4 veraltet

NameBeschreibung
GetEntityveraltet ersetzt durch Mate2.MateEntity
GetMateDimensionValueveraltet ersetzt durch Mate2.DisplayDimension2
GetMateEntitiesveraltet
GetMateParamsveraltet

Nicht aufgeführt sind 4 C++-Varianten (Namen mit I davor, zum Beispiel IGetEntity). In VBA nimmst du immer den Befehl ohne I.

Siehe auch

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

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