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 ObjectSet oRef = swMateEnt.ReferenceWert
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 SubBemerkungen
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.