SolidWorksMakroprogrammierung

Objekt · SldWorks

DistanceMateFeatureData-Objekt

Die Daten einer Abstandsverknüpfung in einer Baugruppe, auch mit Grenzen: Elemente, Abstand, Ausrichtung und Maßrichtung.

Deklaration Dim x As SldWorks.DistanceMateFeatureData · in der englischen .NET-Hilfe: IDistanceMateFeatureData

Beschreibung

Eine Abstandsverknüpfung legt zwei Elemente in einem bestimmten Abstand zueinander fest. Es gibt sie auch als erweiterte Verknüpfung mit Grenzen (limit distance mate): Dann dürfen sich die Komponenten innerhalb eines Abstandsbereichs bewegen. DistanceMateFeatureData hält die Daten für beide Arten. Übergeordnet ist MateFeatureData, das die Art der Verknüpfung liefert (swMateDISTANCE). Die Befehle gibt es seit SOLIDWORKS 2018, IsAdvancedMate seit 2019.

Zugriff

Beide liefern ein MateFeatureData-Objekt, das du einer Variablen vom Typ DistanceMateFeatureData zuweist.

Beispiel

' Legt zwischen zwei ausgewählten Flächen verschiedener Komponenten eine Abstandsverknüpfung
' mit 25,4 mm Startabstand an, die zwischen 10 und 25,4 mm bewegt werden darf.
' Vorbedingung: Eine Baugruppe ist offen, zwei ebene Flächen verschiedener Komponenten sind ausgewählt.
' Ergebnis:     Eine neue Abstandsverknüpfung mit Grenzen 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 swMateDaten As SldWorks.MateFeatureData
    Dim swDaten As SldWorks.DistanceMateFeatureData
    Dim swFeat As SldWorks.Feature
    Dim aFlaechen(1) As SldWorks.Face2
    Dim vFlaechen As Variant

    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 genau zwei Flächen auswählen."
        Exit Sub
    End If
    Set aFlaechen(0) = swSelMgr.GetSelectedObject6(1, -1)
    Set aFlaechen(1) = swSelMgr.GetSelectedObject6(2, -1)
    vFlaechen = aFlaechen

    Set swMateDaten = swAssy.CreateMateData(swMateDISTANCE)
    Set swDaten = swMateDaten
    swDaten.EntitiesToMate = vFlaechen
    swDaten.MateAlignment = swMateAlignALIGNED
    swDaten.FlipDimension = False
    swDaten.IsAdvancedMate = True
    swDaten.Distance = 0.0254
    swDaten.MinimumDistance = 0.01
    swDaten.MaximumDistance = 0.0254

    Set swFeat = swAssy.CreateMate(swDaten)
    If swFeat Is Nothing Then
        Debug.Print "Keine Verknüpfung entstanden, Status " & swMateDaten.ErrorStatus
    Else
        Debug.Print "Angelegt: " & swFeat.Name
    End If
End Sub

Bemerkungen

Anlegen: Folge dem Ablauf bei AssemblyDoc.CreateMate. Die Elemente setzt du mit EntitiesToMate oder wählst sie vorher mit ModelDocExtension.SelectByID2 und Markierung 1 aus. Dann setzt du die übrigen Eigenschaften. Die Liste bei CreateMate führt Abstandsverknüpfungen allerdings nicht unter den Arten mit Vorauswahl; was gilt, ist offen.

Ändern: Mit Feature.GetDefinition holst du das MateFeatureData-Objekt und weist es einer Variablen vom Typ DistanceMateFeatureData zu. Dann änderst du die Werte und rufst Feature.ModifyDefinition auf. Löschen geht mit ModelDocExtension.DeleteSelection2.

Einheiten: Für die Abstände nennt die Hilfe keine Einheit. Das Hilfebeispiel „Create and Edit Limit Distance Mate“ setzt 0.0254 und 0.01. Es sind Meter wie sonst in der API.

Grenzen: Das Hilfebeispiel setzt Minimum und Maximum, aber nicht DistanceMateFeatureData.IsAdvancedMate, und nennt das Ergebnis trotzdem eine Abstandsverknüpfung mit Grenzen. Das Beispiel hier setzt IsAdvancedMate ausdrücklich.

Andere Wege: Ohne Datenobjekt legst du eine Abstandsverknüpfung mit AssemblyDoc.AddDistanceMate an und änderst sie mit AssemblyDoc.EditDistanceMate. Dort gibt es auch die Bogenbedingungen für Zylinder, für die DistanceMateFeatureData keine Eigenschaft hat. Bei einer vorhandenen Verknüpfung liest du sie mit Mate2.DistanceFirstArcCondition. Die verwandte Winkelverknüpfung beschreibt AngleMateFeatureData.

Eigenschaften und Methoden

Eigenschaften 7, davon 7 beschrieben

NameBeschreibung
DistanceLiest oder setzt den Abstand einer Abstandsverknüpfung. Bei einer Verknüpfung mit Grenzen ist es der Startabstand.
EntitiesToMateLiest oder setzt die beiden Elemente, die eine Abstandsverknüpfung verbindet, etwa zwei Flächen, eine Ebene und einen Punkt oder zwei Zylinder.
FlipDimensionLiest oder setzt, ob bei einer Abstandsverknüpfung das Maß umgekehrt wird, die Elemente also auf entgegengesetzten Seiten des Maßes liegen.
IsAdvancedMateLiest oder setzt, ob eine Abstandsverknüpfung Grenzen hat (limit distance mate), innerhalb derer sich die Komponenten bewegen dürfen.
MateAlignmentLiest oder setzt die Ausrichtung einer Abstandsverknüpfung: gleich oder entgegengesetzt ausgerichtet.
MaximumDistanceLiest oder setzt den größten erlaubten Abstand einer Abstandsverknüpfung mit Grenzen.
MinimumDistanceLiest oder setzt den kleinsten erlaubten Abstand einer Abstandsverknüpfung mit Grenzen.

Siehe auch

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

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