SolidWorksMakroprogrammierung

Objekt · SldWorks

MateReference-Objekt

Steht für eine Verknüpfungsreferenz: bis zu drei Elemente einer Komponente, die beim automatischen Verknüpfen benutzt werden.

Deklaration Dim x As SldWorks.MateReference · in der englischen .NET-Hilfe: IMateReference

Beschreibung

Eine Verknüpfungsreferenz legt ein oder mehrere Elemente einer Komponente fest, die beim automatischen Verknüpfen benutzt werden, etwa die Fläche einer Bohrung für eine Schraube. Es gibt bis zu drei Elemente: primär, sekundär und tertiär. Für jedes gibt die Referenz eine Art der Verknüpfung und eine Ausrichtung vor. MateReference liest diese Angaben und ändert sie. Die meisten Befehle gibt es seit SOLIDWORKS 2005, ReferenceEntity2 und ReferenceEntityType seit SOLIDWORKS 2011.

MateReference.ReferenceEntity ist veraltet.

Zugriff

Beispiel

' Gibt Name, Art der Verknüpfung, Ausrichtung und Elementart für jedes Element
' der ausgewählten Verknüpfungsreferenz aus.
' Vorbedingung: Ein Teil mit einer Verknüpfungsreferenz ist offen, die Verknüpfungsreferenz
'               ist im FeatureManager ausgewählt.
' Ergebnis:     Die Werte stehen im Direktfenster, das Teil 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 swRef As SldWorks.MateReference
    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.MateReference Then
        Debug.Print swFeat.Name & " ist keine Verknüpfungsreferenz."
        Exit Sub
    End If
    Set swRef = swSpez

    Debug.Print "Verknüpfungsreferenz " & swRef.Name
    For i = 0 To swRef.ReferenceEntityCount - 1             ' 0 primär, 1 sekundär, 2 tertiär
        If swRef.ReferenceType(i) = -1 Then
            Debug.Print "  " & i & ": kein Element"
        Else
            Debug.Print "  " & i & ": Art " & swRef.ReferenceType(i) & " (swMateReferenceType_e), " & _
                        "Ausrichtung " & swRef.ReferenceAlignment(i) & " (swMateReferenceAlignment_e), " & _
                        "Element " & swRef.ReferenceEntityType(i) & " (swSelectType_e)"
        End If
    Next i
End Sub

Bemerkungen

Auswählen: Die Hilfebeispiele legen eine Verknüpfungsreferenz mit dem Namen „Default“ an, wählen danach „Default-<1>“ mit ModelDocExtension.SelectByID2 und dem Typ POSGROUP aus und holen das Objekt mit Feature.GetSpecificFeature2. Die Tabelle bei Feature.GetTypeName2 nennt für das Feature den Typnamen PosGroupFolder, für den Ordner der Verknüpfungsreferenzen im FeatureManager den Typnamen MateReferenceGroupFolder.

Drei Elemente: Den Index nimmst du aus swMateReferenceIndex_e. MateReference.ReferenceEntityCount liefert die Zahl der belegten Elemente; die Elemente stehen ab Index 0. Die Hilfe nennt bei MateReference.ReferenceType und MateReference.ReferenceAlignment den Wert -1 für einen Index ohne Element; es kommt dafür 0.

Element lesen: MateReference.ReferenceEntity2 liefert ein Entity oder einen SketchPoint. Welches von beiden, sagt MateReference.ReferenceEntityType mit einem Wert aus swSelectType_e. Die veraltete MateReference.ReferenceEntity lieferte nur ein Entity.

Ändern: MateReference.Edit setzt den Namen und alle drei Elemente mit Art und Ausrichtung neu. Danach baust du das Modell mit ModelDoc2.EditRebuild3 neu auf. Anlegen geht mit FeatureManager.InsertMateReference2.

Eigenschaften und Methoden

Eigenschaften 7, davon 6 beschrieben, 1 veraltet

NameBeschreibung
NameLiefert den Namen der Verknüpfungsreferenz.
ReferenceAlignmentLiefert die Ausrichtung, die die Verknüpfungsreferenz für eines ihrer Elemente vorgibt.
ReferenceEntityveraltet ersetzt durch MateReference.ReferenceEntity2
ReferenceEntity2Liefert ein Element der Verknüpfungsreferenz, als Entity oder als Skizzenpunkt.
ReferenceEntityCountLiefert die Zahl der belegten Elemente der Verknüpfungsreferenz, 1 bis 3.
ReferenceEntityTypeLiefert die Art des Elements, das ReferenceEntity2 für einen Index liefert, etwa Fläche oder Skizzenpunkt.
ReferenceTypeLiefert die Art der Verknüpfung, die die Verknüpfungsreferenz für eines ihrer Elemente vorgibt, etwa konzentrisch.

Methoden 1, davon 1 beschrieben

NameBeschreibung
EditÄndert die Verknüpfungsreferenz: den Namen und für bis zu drei Elemente das Element, die Art der Verknüpfung und die Ausrichtung.

Siehe auch

Englisches Original: IMateReference in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)

Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.