Objekt · SldWorks
MateEntity-Objekt
Veraltetes Objekt für ein Element einer Verknüpfung: Komponente, Geometrieart und Lage. MateEntity2 tritt an seine Stelle.
Beschreibung
MateEntity ist mit allen Befehlen veraltet und durch MateEntity2 ersetzt. Das Objekt stand für ein Element einer Verknüpfung: die Komponente, zu der es gehört, seine Geometrieart und seine Lage in der Baugruppe. Seit wann es veraltet ist, sagt die Hilfe nicht.
Zugriff
Die alte Hilfe beschreibt, dass Mate.GetMateEntities die beiden Elemente einer Verknüpfung als MateEntity-Objekte lieferte. Heute holst du jedes Element mit Mate2.MateEntity als MateEntity2, die Anzahl liefert Mate2.GetMateEntityCount.
Beispiel
' Gibt für die ausgewählte Verknüpfung je Element Komponente, Art und Punkt aus.
' Vorbedingung: Eine Baugruppe ist offen, im FeatureManager ist eine Verknüpfung ausgewählt.
' Ergebnis: Die Werte stehen im Direktfenster, die Baugruppe bleibt unverändert.
Option Explicit
Sub main()
Dim swApp As SldWorks.SldWorks
Dim swModel As SldWorks.ModelDoc2
Dim swSel As Object
Dim swFeat As SldWorks.Feature
Dim swSpez As Object
Dim swMate As SldWorks.Mate2
Dim swElement As SldWorks.MateEntity2 ' statt MateEntity
Dim vPar As Variant
Dim sKomp As String
Dim i As Long
Set swApp = Application.SldWorks
Set swModel = swApp.ActiveDoc
If swModel Is Nothing Then Exit Sub
Set swSel = swModel.SelectionManager.GetSelectedObject6(1, -1)
If Not TypeOf swSel Is SldWorks.Feature Then Exit Sub
Set swFeat = swSel
Set swSpez = swFeat.GetSpecificFeature2
If Not TypeOf swSpez Is SldWorks.Mate2 Then Exit Sub
Set swMate = swSpez
For i = 0 To swMate.GetMateEntityCount - 1
Set swElement = swMate.MateEntity(i)
If swElement.ReferenceComponent Is Nothing Then ' früher GetComponent und GetComponentName
sKomp = "ohne Komponente"
Else
sKomp = swElement.ReferenceComponent.Name2
End If
vPar = swElement.EntityParams ' früher GetEntityParams
Debug.Print i & ": " & sKomp & ", Art " & swElement.ReferenceType2 & " (swSelectType_e)"
Debug.Print " Punkt in mm: " & Format(vPar(0) * 1000, "0.00") & " / " & _
Format(vPar(1) * 1000, "0.00") & " / " & Format(vPar(2) * 1000, "0.00")
Next i
End SubBemerkungen
Ersatz: MateEntity2.ReferenceComponent ersetzt gleich drei Befehle: GetComponent, GetMember und GetComponentName. Für GetEntityParams gibt es MateEntity2.EntityParams, für GetEntityType MateEntity2.ReferenceType2. Die alte Hilfe nannte noch andere Nachfolger: für GetComponent die Befehle GetComponentName und IGetComponent2, für GetComponentName ein MateEntity2::ComponentName, das es nicht gibt.
Andere Werte bei der Art: MateEntity.GetEntityType lieferte einen Wert aus swMateEntityTypes_e, also Punkt, Gerade, Ebene, Zylinder oder Kegel. Der Nachfolger MateEntity2.ReferenceType2 liefert einen Wert aus swSelectType_e, etwa Fläche oder Kante. Beim Umstellen alter Makros reicht es deshalb nicht, den Namen zu tauschen.
Aus der alten Hilfe: MateEntity.GetComponentName lieferte den Namen relativ zur Baugruppe, in der die Verknüpfung liegt, mit dem Pfad durch Unterbaugruppen, etwa /Part1-1 oder /Assem2-1/Part1-1. Lag das Element in einem Feature dieser Baugruppe selbst, kam ein leerer Text. MateEntity.GetEntityParams lieferte acht Zahlen im Koordinatensystem der Baugruppe: Punkt, Richtung und zwei Radien. Je nach Geometrieart galt nur ein Teil davon. Genauso beschreibt die Hilfe heute MateEntity2.EntityParams.
Neu im Nachfolger: MateEntity2 liefert außerdem das Element selbst (MateEntity2.Reference) und die Zahl der Werte aus EntityParams (MateEntity2.GetEntityParamsSize).
Eigenschaften und Methoden
Methoden 5, davon 0 beschrieben, 5 veraltet
| Name | Beschreibung |
|---|---|
| GetComponent | veraltet ersetzt durch MateEntity2.ReferenceComponent |
| GetComponentName | veraltet ersetzt durch MateEntity2.ReferenceComponent |
| GetEntityParams | veraltet ersetzt durch MateEntity2.EntityParams |
| GetEntityType | veraltet ersetzt durch MateEntity2.ReferenceType2 |
| GetMember | veraltet ersetzt durch MateEntity2.ReferenceComponent |
Nicht aufgeführt sind 4 C++-Varianten (Namen mit I davor, zum Beispiel IGetComponent). In VBA nimmst du immer den Befehl ohne I.
Siehe auch
Englisches Original: IMateEntity in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)
Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.