SolidWorksMakroprogrammierung

Objekt · SldWorks

MateEntity-Objekt

Veraltetes Objekt für ein Element einer Verknüpfung: Komponente, Geometrieart und Lage. MateEntity2 tritt an seine Stelle.

Deklaration Dim x As SldWorks.MateEntity · in der englischen .NET-Hilfe: IMateEntity

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 Sub

Bemerkungen

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

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.