Objekt · SldWorks
WidthMateFeatureData-Objekt
Die Daten einer Breitenverknüpfung in einer Baugruppe: Lasche, Breitenflächen und wie die Lasche dazwischen liegt.
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
AssemblyDoc.CreateMateDatamitswMateWIDTH: Daten für eine neue Breitenverknüpfung, die du anAssemblyDoc.CreateMateübergibstFeature.GetDefinition: die Daten einer vorhandenen Breitenverknüpfung
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 SubBemerkungen
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
| Name | Beschreibung |
|---|---|
| ConstraintType | Liest oder setzt, wie die Breitenverknüpfung die Lasche hält: mittig, frei, mit Abstand oder mit Prozentwert. |
| DistanceFromEnd | Liest oder setzt den Abstand vom Ende bei einer Breitenverknüpfung mit Abstand. |
| FlipDimension | Liest oder setzt, ob die Elemente der Breitenverknüpfung auf die Gegenseite des Abstands wechseln. |
| PercentDistanceFromEnd | Liest oder setzt den Abstand vom Ende als Prozentwert bei einer Breitenverknüpfung mit Prozentwert. |
| TabSelection | Liest oder setzt die Lasche der Breitenverknüpfung: zwei ebene Flächen oder eine zylindrische Fläche oder Achse. |
| WidthSelection | Liest 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.