SolidWorksMakroprogrammierung

Objekt · SldWorks

MateEntity2-Objekt

Steht für ein Element einer Verknüpfung: die verknüpfte Fläche, Kante oder Ebene mit ihrer Komponente, Lage und Richtung.

Deklaration Dim x As SldWorks.MateEntity2 · in der englischen .NET-Hilfe: IMateEntity2

Beschreibung

Eine Verknüpfung (Mate2) verbindet zwei oder mehr Elemente, zum Beispiel zwei Flächen bei „Deckungsgleich“ oder zwei Zylinder bei „Konzentrisch“. Für jedes dieser Elemente gibt es ein MateEntity2-Objekt. Es sagt dir, zu welcher Komponente das Element gehört, was für ein Element es ist und wo es in der Baugruppe liegt.

Alle Eigenschaften sind nur lesbar. MateEntity2.ReferenceType ist veraltet.

Zugriff

Beispiel

' Gibt für die ausgewählte Verknüpfung jedes Element mit Komponente, Art, Punkt und Richtung aus.
' Vorbedingung: Eine Baugruppe ist geöffnet, im FeatureManager ist eine Verknüpfung ausgewählt.
' Ergebnis:     Ein Block je Element im Direktfenster (Strg+G).
Option Explicit

Sub main()
    Dim swApp As SldWorks.SldWorks
    Dim swModel As SldWorks.ModelDoc2
    Dim swSelMgr As SldWorks.SelectionMgr
    Dim swFeat As SldWorks.Feature
    Dim swMate As SldWorks.Mate2
    Dim swMateEnt As SldWorks.MateEntity2
    Dim vPar As Variant
    Dim i As Long

    Set swApp = Application.SldWorks
    Set swModel = swApp.ActiveDoc
    If swModel Is Nothing Then Exit Sub
    Set swSelMgr = swModel.SelectionManager
    If swSelMgr.GetSelectedObjectType3(1, -1) <> swSelMATES Then
        swApp.SendMsgToUser2 "Bitte zuerst eine Verknüpfung auswählen.", swMbWarning, swMbOk
        Exit Sub
    End If
    Set swFeat = swSelMgr.GetSelectedObject6(1, -1)
    Set swMate = swFeat.GetSpecificFeature2

    Debug.Print swFeat.Name & ", Art " & swMate.Type
    For i = 0 To swMate.GetMateEntityCount - 1
        Set swMateEnt = swMate.MateEntity(i)
        If swMateEnt.ReferenceComponent Is Nothing Then
            Debug.Print "  Element " & i & ": ohne Komponente"
        Else
            Debug.Print "  Element " & i & ": " & swMateEnt.ReferenceComponent.Name2
        End If
        Debug.Print "    Art (swSelectType_e): " & swMateEnt.ReferenceType2

        vPar = swMateEnt.EntityParams
        Debug.Print "    Punkt in mm: " & Format(vPar(0) * 1000, "0.000") & " / " & _
            Format(vPar(1) * 1000, "0.000") & " / " & Format(vPar(2) * 1000, "0.000")
        Debug.Print "    Richtung:    " & Format(vPar(3), "0.0000") & " / " & _
            Format(vPar(4), "0.0000") & " / " & Format(vPar(5), "0.0000")
        Debug.Print "    Radien in mm: " & Format(vPar(6) * 1000, "0.000") & " / " & Format(vPar(7) * 1000, "0.000")
    Next i
End Sub

Bemerkungen

Koordinaten: Alle Werte aus MateEntity2.EntityParams gelten im Koordinatensystem der Baugruppe, in der die Verknüpfung liegt. Eine Einheit nennt die Hilfe dort nicht. Ihre Beispiele rechnen Punkt und Radien mit 1000 in Millimeter um, die Werte sind also in Metern.

Das Element: Was MateEntity2.Reference liefert, beschreibt die Hilfe widersprüchlich: auf der Seite der Eigenschaft eine Verknüpfungsreferenz (MateReference), im Beispiel „Edit Mate“ dagegen das Element selbst als Entity, das dann mit Entity.Select4 ausgewählt wird. Prüfe den Typ deshalb mit TypeOf, wie auf der Seite der Eigenschaft gezeigt.

Art des Elements: MateEntity2.ReferenceType2 liefert einen Wert aus swSelectType_e (Fläche, Kante, Ebene usw.). Die veraltete MateEntity2.ReferenceType lieferte im Beispiel der Hilfe Werte aus swMateEntity2ReferenceType_e. Die Zahlen beider Enumerationen überschneiden sich mit anderer Bedeutung. Beim Umstellen alter Makros reicht es deshalb nicht, den Namen zu tauschen.

Ändern: Über MateEntity2 änderst du nichts. Wie du eine Verknüpfung änderst, steht bei Mate2.

Nicht belegte Radien in MateEntity2.EntityParams sind 0: Bei einer Zylinderfläche ist der zweite Radius 0, bei ebenen Flächen sind es beide.

Eigenschaften und Methoden

Eigenschaften 5, davon 5 beschrieben

NameBeschreibung
EntityParamsLiefert Punkt, Richtung und Radien eines Verknüpfungselements als Array mit acht Werten, im Koordinatensystem der Baugruppe.
ReferenceLiefert das Element, das die Verknüpfung benutzt. Nach dem Text der Hilfe eine Verknüpfungsreferenz, nach dem Hilfebeispiel die Fläche, Kante usw. selbst.
ReferenceComponentLiefert die Komponente, zu der ein Verknüpfungselement gehört.
ReferenceTypeLiefert die Geometrieart eines Verknüpfungselements, etwa Ebene oder Zylinder. Veraltet, für neue Makros gibt es ReferenceType2.
ReferenceType2Liefert, welche Art Element eine Verknüpfung benutzt, als Wert aus swSelectType_e.

Methoden 1, davon 1 beschrieben

NameBeschreibung
GetEntityParamsSizeLiefert die Anzahl der Parameter eines Verknüpfungselements. In VBA meist entbehrlich, EntityParams liefert das Array direkt.

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

Siehe auch

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

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