Objekt · SldWorks
MateLoadReference-Objekt
Steht für die Lastreferenz einer Verknüpfung: zusätzliche Flächen an den beiden Komponenten der Verknüpfung.
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
AssemblyDoc.InsertLoadReference: eine neue Lastreferenz für eine VerknüpfungMate2.MateLoadReference: die Lastreferenz einer vorhandenen Verknüpfung
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 SubBemerkungen
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
| Name | Beschreibung |
|---|---|
| Component | Liefert eine der beiden Komponenten der Verknüpfung, zu der die Lastreferenz gehört. |
| Mate | Liefert die Verknüpfung, zu der die Lastreferenz gehört. |
| Name | Liefert den Namen der Lastreferenz. |
Methoden 3, davon 3 beschrieben
| Name | Beschreibung |
|---|---|
| Delete | Löscht die Lastreferenz. |
| GetFaces | Liefert die zusätzlichen Flächen der Lastreferenz an einer der beiden Komponenten. |
| GetFacesCount | Liefert 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.