Objekt · SldWorks
SlotMateFeatureData-Objekt
Die Daten einer Nutverknüpfung in einer Baugruppe: die Elemente, die Ausrichtung und wo die Komponente in der Nut sitzt.
Beschreibung
Eine Nutverknüpfung verknüpft einen Bolzen mit einer geraden oder gebogenen Nut oder zwei Nuten miteinander. SlotMateFeatureData hält ihre Daten. Übergeordnet ist MateFeatureData. Die Befehle gibt es seit SOLIDWORKS 2019.
Zugriff
AssemblyDoc.CreateMateDatamitswMateSLOT: Daten für eine neue Verknüpfung, die du anAssemblyDoc.CreateMateübergibstFeature.GetDefinition: die Daten einer vorhandenen Nutverknüpfung
Beispiel
' Legt eine Nutverknüpfung zwischen den beiden ausgewählten Flächen an. Der Bolzen sitzt
' 10 mm vom Ende der Nut.
' Vorbedingung: Eine Baugruppe ist offen. Ausgewählt sind eine Fläche einer Nut und
' eine zylindrische Fläche oder eine Fläche einer zweiten Nut.
' Ergebnis: Eine neue Nutverknüpfung im Ordner "Verknüpfungen".
Option Explicit
Sub main()
Dim swApp As SldWorks.SldWorks
Dim swModel As SldWorks.ModelDoc2
Dim swAssy As SldWorks.AssemblyDoc
Dim swSelMgr As SldWorks.SelectionMgr
Dim swDaten As SldWorks.SlotMateFeatureData
Dim swFeat As SldWorks.Feature
Dim vElemente(1) As Object
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 swSelMgr = swModel.SelectionManager
If swSelMgr.GetSelectedObjectCount2(-1) <> 2 Then
Debug.Print "Bitte erst eine Fläche der Nut, dann die zweite Fläche auswählen."
Exit Sub
End If
Set vElemente(0) = swSelMgr.GetSelectedObject6(1, -1)
Set vElemente(1) = swSelMgr.GetSelectedObject6(2, -1)
Set swDaten = swAssy.CreateMateData(swMateSLOT)
swDaten.EntitiesToMate = vElemente
swDaten.MateAlignment = swMateAlignALIGNED
swDaten.Constraint = swSlotMateConstraintOption_Distance
swDaten.Distance = 0.01 ' Meter
Set swFeat = swAssy.CreateMate(swDaten)
swModel.ClearSelection2 True
If swFeat Is Nothing Then
Debug.Print "Keine Verknüpfung entstanden."
Else
Debug.Print "Angelegt: " & swFeat.Name
swModel.EditRebuild3
End If
End SubBemerkungen
Anlegen: Du folgst dem Ablauf bei AssemblyDoc.CreateMate. Die Elemente setzt du mit SlotMateFeatureData.EntitiesToMate oder wählst sie vorher mit ModelDocExtension.SelectByID2 und der Markierung 1 aus. Vorher auswählen geht nur beim Anlegen, nicht beim Ändern. Das Hilfebeispiel wählt die Flächen mit ModelDocExtension.SelectByRay aus und setzt sie zusätzlich mit EntitiesToMate.
Ändern: Du holst mit Feature.GetDefinition das MateFeatureData-Objekt und weist es einer Variablen vom Typ SlotMateFeatureData zu. Dann änderst du die Werte und rufst Feature.ModifyDefinition auf. Löschen geht mit ModelDocExtension.DeleteSelection2.
Zwei Nuten: Verknüpfst du zwei Nuten miteinander, gelten für SlotMateFeatureData.Constraint nur swSlotMateConstraintOption_Free und swSlotMateConstraintOption_Centered.
Hilfebeispiel: Das VBA-Beispiel der Hilfe ruft CreateMateData und CreateMate über eine Variable vom Typ ModelDoc2 auf und übergibt die Zahl 21. Beide Befehle gehören zu AssemblyDoc, das Beispiel hier nimmt deshalb eine Variable vom Typ AssemblyDoc und die Konstante swMateSLOT.
Eigenschaften und Methoden
Eigenschaften 6, davon 6 beschrieben
| Name | Beschreibung |
|---|---|
| Constraint | Liest oder setzt, wo die Nutverknüpfung die Komponente in der Nut hält: frei, mittig, in festem Abstand oder in Prozent der Nutlänge. |
| Distance | Liest oder setzt den Abstand vom Ende der Nut, in dem die Achse der Komponente liegt. |
| EntitiesToMate | Liest oder setzt die beiden Elemente der Nutverknüpfung. |
| FlipDirection | Liest oder setzt, von welchem Ende der Nut aus Abstand oder Anteil gemessen wird. |
| MateAlignment | Liest oder setzt die Ausrichtung der Nutverknüpfung. |
| Percent | Liest oder setzt den Anteil der Nutlänge vom Ende der Nut, an dem die Achse der Komponente liegt. |
Siehe auch
Englisches Original: ISlotMateFeatureData in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)
Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.