Objekt · SldWorks
DistanceMateFeatureData-Objekt
Die Daten einer Abstandsverknüpfung in einer Baugruppe, auch mit Grenzen: Elemente, Abstand, Ausrichtung und Maßrichtung.
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
AssemblyDoc.CreateMateDatamitswMateDISTANCE: Daten für eine neue Verknüpfung, die du anAssemblyDoc.CreateMateübergibstFeature.GetDefinition: die Daten einer vorhandenen Abstandsverknüpfung
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 SubBemerkungen
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
| Name | Beschreibung |
|---|---|
| Distance | Liest oder setzt den Abstand einer Abstandsverknüpfung. Bei einer Verknüpfung mit Grenzen ist es der Startabstand. |
| EntitiesToMate | Liest oder setzt die beiden Elemente, die eine Abstandsverknüpfung verbindet, etwa zwei Flächen, eine Ebene und einen Punkt oder zwei Zylinder. |
| FlipDimension | Liest oder setzt, ob bei einer Abstandsverknüpfung das Maß umgekehrt wird, die Elemente also auf entgegengesetzten Seiten des Maßes liegen. |
| IsAdvancedMate | Liest oder setzt, ob eine Abstandsverknüpfung Grenzen hat (limit distance mate), innerhalb derer sich die Komponenten bewegen dürfen. |
| MateAlignment | Liest oder setzt die Ausrichtung einer Abstandsverknüpfung: gleich oder entgegengesetzt ausgerichtet. |
| MaximumDistance | Liest oder setzt den größten erlaubten Abstand einer Abstandsverknüpfung mit Grenzen. |
| MinimumDistance | Liest 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.