SolidWorksMakroprogrammierung

Objekt · SldWorks

SlotMateFeatureData-Objekt

Die Daten einer Nutverknüpfung in einer Baugruppe: die Elemente, die Ausrichtung und wo die Komponente in der Nut sitzt.

Deklaration Dim x As SldWorks.SlotMateFeatureData · in der englischen .NET-Hilfe: ISlotMateFeatureData

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

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 Sub

Bemerkungen

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

NameBeschreibung
ConstraintLiest oder setzt, wo die Nutverknüpfung die Komponente in der Nut hält: frei, mittig, in festem Abstand oder in Prozent der Nutlänge.
DistanceLiest oder setzt den Abstand vom Ende der Nut, in dem die Achse der Komponente liegt.
EntitiesToMateLiest oder setzt die beiden Elemente der Nutverknüpfung.
FlipDirectionLiest oder setzt, von welchem Ende der Nut aus Abstand oder Anteil gemessen wird.
MateAlignmentLiest oder setzt die Ausrichtung der Nutverknüpfung.
PercentLiest 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.