SolidWorksMakroprogrammierung

Objekt · SldWorks

MateLoadReference-Objekt

Steht für die Lastreferenz einer Verknüpfung: zusätzliche Flächen an den beiden Komponenten der Verknüpfung.

Deklaration Dim x As SldWorks.MateLoadReference · in der englischen .NET-Hilfe: IMateLoadReference

Beschreibung

Eine Lastreferenz gehört zu einer Verknüpfung und hält zusätzliche Flächen (supplemental faces), die zu den beiden Komponenten der Verknüpfung gehören. MateLoadReference liefert ihren Namen, die Verknüpfung, deren Komponenten und je Komponente die Flächen. Wofür die Lastreferenz gedacht ist, beschreibt die API-Hilfe nicht, dem Namen nach für Lasten an Verknüpfungen. Alle Befehle gibt es seit SOLIDWORKS 2006.

Zugriff

Beispiel

' Legt für die ausgewählte Verknüpfung eine Lastreferenz mit den ausgewählten Flächen an
' und gibt Name, Komponenten und Zahl der Flächen aus.
' Vorbedingung: Eine Baugruppe ist offen. Zuerst ist eine Verknüpfung im FeatureManager ausgewählt,
'               dazu mit Strg eine oder mehrere Flächen ihrer beiden Komponenten.
' Ergebnis:     Eine neue Lastreferenz an der Verknüpfung, die Werte stehen im Direktfenster.
Option Explicit

Sub main()
    Dim swApp As SldWorks.SldWorks
    Dim swModel As SldWorks.ModelDoc2
    Dim swAssy As SldWorks.AssemblyDoc
    Dim swSel As Object
    Dim swFeat As SldWorks.Feature
    Dim swSpez As Object
    Dim swMate As SldWorks.Mate2
    Dim swLastRef As SldWorks.MateLoadReference
    Dim swComp As SldWorks.Component2
    Dim i As Long

    Set swApp = Application.SldWorks
    Set swModel = swApp.ActiveDoc
    If swModel Is Nothing Then Exit Sub
    If swModel.GetType <> swDocASSEMBLY Then Exit Sub
    Set swAssy = swModel
    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

    Set swLastRef = swAssy.InsertLoadReference(swMate)
    If swLastRef Is Nothing Then
        Debug.Print "Keine Lastreferenz angelegt."
        Exit Sub
    End If
    Debug.Print "Lastreferenz " & swLastRef.Name & " an " & swFeat.Name
    For i = 0 To 1
        Set swComp = swLastRef.Component(i)
        If Not swComp Is Nothing Then
            Debug.Print "  " & swComp.Name2 & ": " & swLastRef.GetFacesCount(i) & " zusätzliche Flächen"
        End If
    Next i
End Sub

Bemerkungen

Anlegen: Wähle die zusätzlichen Flächen aus, bevor du AssemblyDoc.InsertLoadReference aufrufst. SOLIDWORKS ordnet jede Fläche der passenden Komponente der Verknüpfung zu, Flächen anderer Komponenten werden ignoriert. Übergibst du Nothing statt der Verknüpfung, muss auch sie ausgewählt sein. Das Hilfebeispiel „Insert Mate Load Reference“ wählt die Verknüpfung mit ModelDocExtension.SelectByID2 und dem Typ MATE aus und hängt dann eine Fläche an die Auswahl an.

Komponenten: Bei MateLoadReference.Component, MateLoadReference.GetFaces und MateLoadReference.GetFacesCount wählst du mit 0 oder 1 die erste oder zweite Komponente der Verknüpfung.

FeatureManager: InsertLoadReference und MateLoadReference.Delete bauen den FeatureManager neu auf. Bei vielen Aufrufen schaltest du das mit FeatureManager.EnableFeatureTree vorübergehend ab.

Nicht verwechseln: Auch Mate2.GetSupplementalFaces liefert Flächen je Komponente einer Verknüpfung, dazu gibt es seit SOLIDWORKS 2009 die lasttragenden Flächen (Mate2.HasLoadBearingFaces). Wie beides mit der Lastreferenz zusammenhängt, sagt die Hilfe nicht.

Eigenschaften und Methoden

Eigenschaften 3, davon 3 beschrieben

NameBeschreibung
ComponentLiefert eine der beiden Komponenten der Verknüpfung, zu der die Lastreferenz gehört.
MateLiefert die Verknüpfung, zu der die Lastreferenz gehört.
NameLiefert den Namen der Lastreferenz.

Methoden 3, davon 3 beschrieben

NameBeschreibung
DeleteLöscht die Lastreferenz.
GetFacesLiefert die zusätzlichen Flächen der Lastreferenz an einer der beiden Komponenten.
GetFacesCountLiefert die Zahl der zusätzlichen Flächen der Lastreferenz an einer der beiden Komponenten.

Nicht aufgeführt sind 1 C++-Varianten (Namen mit I davor, zum Beispiel IGetFaces). In VBA nimmst du immer den Befehl ohne I.

Siehe auch

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

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