SolidWorksMakroprogrammierung

Eigenschaft · MateEntity2

Reference-Eigenschaft (MateEntity2)

Liefert das Element, das die Verknüpfung benutzt. Nach dem Text der Hilfe eine Verknüpfungsreferenz, nach dem Hilfebeispiel die Fläche, Kante usw. selbst.

Syntax

Property Reference As Object
Set oRef = swMateEnt.Reference

Wert

Die Seite der Eigenschaft nennt eine Verknüpfungsreferenz (MateReference). Das Beispiel „Edit Mate“ der Hilfe behandelt den Wert dagegen als Element (Entity), siehe Bemerkungen.

Beispiel

' Wählt die Elemente der ausgewählten Verknüpfung im Grafikbereich aus.
' Vorbedingung: Eine Baugruppe ist geöffnet, im FeatureManager ist eine Verknüpfung ausgewählt.
' Ergebnis:     Die Elemente der Verknüpfung sind ausgewählt. Im Direktfenster steht,
'               was Reference für jedes Element geliefert hat.
Option Explicit

Sub main()
    Dim swApp As SldWorks.SldWorks
    Dim swModel As SldWorks.ModelDoc2
    Dim swSelMgr As SldWorks.SelectionMgr
    Dim swSelData As SldWorks.SelectData
    Dim swFeat As SldWorks.Feature
    Dim swMate As SldWorks.Mate2
    Dim swEnt As SldWorks.Entity
    Dim oRef As Object
    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

    swModel.ClearSelection2 True
    Set swSelData = swSelMgr.CreateSelectData
    For i = 0 To swMate.GetMateEntityCount - 1
        Set oRef = swMate.MateEntity(i).Reference
        If oRef Is Nothing Then
            Debug.Print i & ": keine Referenz"
        ElseIf TypeOf oRef Is SldWorks.Entity Then
            Set swEnt = oRef
            Debug.Print i & ": Element, Art " & swEnt.GetType & " (swSelectType_e)"
            swEnt.Select4 True, swSelData
        ElseIf TypeOf oRef Is SldWorks.MateReference Then
            Debug.Print i & ": Verknüpfungsreferenz"
        Else
            Debug.Print i & ": " & TypeName(oRef)
        End If
    Next i
End Sub

Bemerkungen

Widerspruch in der Hilfe: Auf der Seite der Eigenschaft steht als Wert eine Verknüpfungsreferenz. Das sind ein oder mehrere Elemente einer Komponente, die beim automatischen Verknüpfen benutzt werden. Das Beispiel „Edit Mate“ der Hilfe weist den Wert aber einer Variable vom Typ Entity zu und wählt ihn mit Entity.Select4 aus, als wäre er die Fläche, Kante oder der Eckpunkt der Verknüpfung. Welche Lesart stimmt, sagt die Hilfe nicht. Das Beispiel oben prüft deshalb mit TypeOf und meldet, was ankommt.

Art des Elements: Die Art liefert MateEntity2.ReferenceType2. Ist der Wert ein Entity, liefert Entity.GetType sie ebenfalls, beide als Wert aus swSelectType_e.

Die Eigenschaft ist nur lesbar.

Zurück kommt das Element selbst als Entity, wie im Hilfebeispiel „Edit Mate“; du kannst es direkt mit Entity.Select4 auswählen.

Siehe auch

Verfügbarkeit

SOLIDWORKS 2004

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

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