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.
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
Mate2.MateEntity: ein Element einer Verknüpfung, die Anzahl liefertMate2.GetMateEntityCount
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 SubBemerkungen
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
| Name | Beschreibung |
|---|---|
| EntityParams | Liefert Punkt, Richtung und Radien eines Verknüpfungselements als Array mit acht Werten, im Koordinatensystem der Baugruppe. |
| Reference | 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. |
| ReferenceComponent | Liefert die Komponente, zu der ein Verknüpfungselement gehört. |
| ReferenceType | Liefert die Geometrieart eines Verknüpfungselements, etwa Ebene oder Zylinder. Veraltet, für neue Makros gibt es ReferenceType2. |
| ReferenceType2 | Liefert, welche Art Element eine Verknüpfung benutzt, als Wert aus swSelectType_e. |
Methoden 1, davon 1 beschrieben
| Name | Beschreibung |
|---|---|
| GetEntityParamsSize | Liefert 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.