SolidWorksMakroprogrammierung

Objekt · SldWorks

WidthMateFeatureData-Objekt

Die Daten einer Breitenverknüpfung in einer Baugruppe: Lasche, Breitenflächen und wie die Lasche dazwischen liegt.

Deklaration Dim x As SldWorks.WidthMateFeatureData · in der englischen .NET-Hilfe: IWidthMateFeatureData

Beschreibung

Eine Breitenverknüpfung hält eine Lasche (tab) zwischen zwei ebenen Flächen. WidthMateFeatureData hält ihre Daten. Übergeordnet ist MateFeatureData, das die Art der Verknüpfung liefert (swMateWIDTH). Die Befehle gibt es seit SOLIDWORKS 2018.

Zugriff

Beispiel

' Gibt die Einstellung der ausgewählten Breitenverknüpfung aus und stellt sie auf
' 50 Prozent vom Ende.
' Vorbedingung: Eine Baugruppe mit einer Breitenverknüpfung ist offen, die Verknüpfung
'               ist im FeatureManager ausgewählt.
' Ergebnis:     Die Verknüpfung hält die Lasche bei 50 Prozent, die alten Werte stehen
'               im Direktfenster.
Option Explicit

Sub main()
    Dim swApp As SldWorks.SldWorks
    Dim swModel As SldWorks.ModelDoc2
    Dim swSel As Object
    Dim swFeat As SldWorks.Feature
    Dim swDef As Object
    Dim swMateDaten As SldWorks.MateFeatureData
    Dim swDaten As SldWorks.WidthMateFeatureData

    Set swApp = Application.SldWorks
    Set swModel = swApp.ActiveDoc
    If swModel Is Nothing Then Exit Sub
    If swModel.GetType <> swDocASSEMBLY Then Exit Sub
    Set swSel = swModel.SelectionManager.GetSelectedObject6(1, -1)
    If Not TypeOf swSel Is SldWorks.Feature Then Exit Sub
    Set swFeat = swSel
    Set swDef = swFeat.GetDefinition
    If Not TypeOf swDef Is SldWorks.MateFeatureData Then Exit Sub
    Set swMateDaten = swDef
    If swMateDaten.TypeName <> swMateWIDTH Then Exit Sub
    Set swDaten = swMateDaten                          ' dieselben Daten, anderer Typ

    Select Case swDaten.ConstraintType
        Case swMateWidth_Centered:  Debug.Print "Bisher: mittig"
        Case swMateWidth_Free:      Debug.Print "Bisher: frei"
        Case swMateWidth_Dimension: Debug.Print "Bisher: " & swDaten.DistanceFromEnd * 1000 & " mm vom Ende"
        Case swMateWidth_Percent:   Debug.Print "Bisher: " & swDaten.PercentDistanceFromEnd & " % vom Ende"
    End Select

    swDaten.ConstraintType = swMateWidth_Percent
    swDaten.PercentDistanceFromEnd = 50
    If False = swFeat.ModifyDefinition(swDaten, swModel, Nothing) Then Debug.Print "Ändern fehlgeschlagen"
End Sub

Bemerkungen

Anlegen: Folge dem Ablauf bei AssemblyDoc.CreateMate. Die Lasche setzt du mit WidthMateFeatureData.TabSelection oder wählst sie vorher mit ModelDocExtension.SelectByID2 und Markierung 16 aus, die Breitenflächen mit WidthMateFeatureData.WidthSelection oder mit Markierung 1. Dann setzt du WidthMateFeatureData.ConstraintType und die übrigen Werte. Die Liste bei CreateMate führt Breitenverknüpfungen allerdings nicht unter den Arten mit Vorauswahl; was gilt, ist offen.

Ändern: Hole mit Feature.GetDefinition das MateFeatureData-Objekt, weise es einer Variablen vom Typ WidthMateFeatureData zu, ändere die Werte und rufe Feature.ModifyDefinition auf. Löschen geht mit ModelDocExtension.DeleteSelection2.

Hilfebeispiel: Das Beispiel „Create and Edit Width Mate“ ruft AssemblyDoc.CreateMateData mit dem Wert 11 auf, wählt die Flächen mit ModelDocExtension.SelectByRay aus, übergibt sie als Arrays und legt eine Verknüpfung mit Abstand an. Danach stellt es sie auf swMateWidth_Percent mit dem Wert 47 um.

Einheiten: Für WidthMateFeatureData.DistanceFromEnd nennt die Hilfe keine Einheit, vermutlich Meter. WidthMateFeatureData.PercentDistanceFromEnd ist im Hilfebeispiel eine Zahl zwischen 0 und 100.

Eigenschaften und Methoden

Eigenschaften 6, davon 6 beschrieben

NameBeschreibung
ConstraintTypeLiest oder setzt, wie die Breitenverknüpfung die Lasche hält: mittig, frei, mit Abstand oder mit Prozentwert.
DistanceFromEndLiest oder setzt den Abstand vom Ende bei einer Breitenverknüpfung mit Abstand.
FlipDimensionLiest oder setzt, ob die Elemente der Breitenverknüpfung auf die Gegenseite des Abstands wechseln.
PercentDistanceFromEndLiest oder setzt den Abstand vom Ende als Prozentwert bei einer Breitenverknüpfung mit Prozentwert.
TabSelectionLiest oder setzt die Lasche der Breitenverknüpfung: zwei ebene Flächen oder eine zylindrische Fläche oder Achse.
WidthSelectionLiest oder setzt die beiden ebenen Flächen, zwischen denen die Breitenverknüpfung die Lasche hält.

Siehe auch

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

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