Objekt · SldWorks
Mate-Objekt
Veraltetes Objekt für eine Verknüpfung in einer Baugruppe: Elemente, Art, Ausrichtung und Maß. Mate2 tritt an seine Stelle.
Beschreibung
Mate ist mit allen Befehlen veraltet und durch Mate2 ersetzt. Das Objekt stand für eine Verknüpfung in einer Baugruppe: ihre beiden Elemente, ihre Art und Ausrichtung und ihr Maß. Seit wann es veraltet ist, sagt die Hilfe nicht.
Zugriff
Die alte Hilfe beschreibt, wie du das Objekt mit Feature.GetSpecificFeature2 aus einem Unterfeature des Ordners mit dem Typnamen MateGroup holtest. Denselben Weg beschreibt die Hilfe heute für Mate2.
Beispiel
' Gibt Name, Art, Ausrichtung, Zahl der Elemente und Maß aller Verknüpfungen der aktiven Baugruppe aus.
' Vorbedingung: Eine Baugruppe mit Verknüpfungen ist offen.
' Ergebnis: Eine Zeile je Verknüpfung im Direktfenster, die Baugruppe bleibt unverändert.
Option Explicit
Sub main()
Dim swApp As SldWorks.SldWorks
Dim swModel As SldWorks.ModelDoc2
Dim swFeat As SldWorks.Feature
Dim swSubFeat As SldWorks.Feature
Dim swSpez As Object
Dim swMate As SldWorks.Mate2 ' statt Mate
Dim swDispDim As SldWorks.DisplayDimension
Dim vWerte As Variant
Dim sZeile As String
Set swApp = Application.SldWorks
Set swModel = swApp.ActiveDoc
If swModel Is Nothing Then Exit Sub
If swModel.GetType <> swDocASSEMBLY Then Exit Sub
Set swFeat = swModel.FirstFeature
Do While Not swFeat Is Nothing
If swFeat.GetTypeName2 = "MateGroup" Then Exit Do
Set swFeat = swFeat.GetNextFeature
Loop
If swFeat Is Nothing Then Exit Sub
Set swSubFeat = swFeat.GetFirstSubFeature
Do While Not swSubFeat Is Nothing
Set swSpez = swSubFeat.GetSpecificFeature2
If TypeOf swSpez Is SldWorks.Mate2 Then
Set swMate = swSpez
sZeile = swSubFeat.Name & ": Art " & swMate.Type & _
", Ausrichtung " & swMate.Alignment ' früher GetMateParams
sZeile = sZeile & ", " & swMate.GetMateEntityCount & " Elemente" ' früher GetMateEntities
Set swDispDim = swMate.DisplayDimension2(0) ' früher GetMateDimensionValue
If Not swDispDim Is Nothing Then
vWerte = swDispDim.GetDimension2(0).GetSystemValue3(swThisConfiguration, Empty)
sZeile = sZeile & ", Maß " & vWerte(0) & " (m oder rad)"
End If
Debug.Print sZeile
End If
Set swSubFeat = swSubFeat.GetNextSubFeature
Loop
End SubBemerkungen
Ersatz: Mate2.MateEntity ersetzt den Befehl GetEntity und Mate2.DisplayDimension2 den Befehl GetMateDimensionValue. GetMateEntities und GetMateParams haben keinen Nachfolger. An Mate2 liest du die Elemente einzeln mit Mate2.MateEntity, ihre Anzahl mit Mate2.GetMateEntityCount. Art, Ausrichtung und Umkehrbarkeit liefern Mate2.Type, Mate2.Alignment und Mate2.CanBeFlipped.
Element statt Fläche: Mate.GetEntity lieferte die Fläche, Kante usw. selbst. Der Nachfolger Mate2.MateEntity liefert dagegen ein MateEntity2, das Element selbst holst du dort mit MateEntity2.Reference.
Andere Zahlen: Mate.GetMateParams lieferte ein Array mit drei Zahlen: die Art, die Ausrichtung mit 1 für gleich und 2 für entgegengesetzt ausgerichtet und die Umkehrbarkeit mit 2 für umkehrbar, sonst 1. Welche Werte die Art hatte, sagt die alte Hilfe nicht. Mate2.Alignment liefert dagegen einen Wert aus swMateAlign_e mit 0 für gleich und 1 für entgegengesetzt, Mate2.CanBeFlipped ein Boolean und Mate2.Type einen Wert aus swMateType_e.
Aus der alten Hilfe: Mate.GetMateDimensionValue lieferte ein Array mit einer Zahl: einen Abstand in Metern oder einen Winkel im Bogenmaß, je nach Art, und 0, wenn die Verknüpfung kein Maß hat. Das Element aus Mate.GetEntity galt nur in der Baugruppe, zu der die Verknüpfung gehört. Beim Ursprung einer Komponente war es Nothing, bei Komponenten, die reduziert (Lightweight) geladen sind, lieferte der Befehl kein Element.
Eigenschaften und Methoden
Methoden 4, davon 0 beschrieben, 4 veraltet
| Name | Beschreibung |
|---|---|
| GetEntity | veraltet ersetzt durch Mate2.MateEntity |
| GetMateDimensionValue | veraltet ersetzt durch Mate2.DisplayDimension2 |
| GetMateEntities | veraltet |
| GetMateParams | veraltet |
Nicht aufgeführt sind 4 C++-Varianten (Namen mit I davor, zum Beispiel IGetEntity). In VBA nimmst du immer den Befehl ohne I.
Siehe auch
Englisches Original: IMate in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)
Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.