Objekt · SldWorks
AngleMateFeatureData-Objekt
Die Daten einer Winkelverknüpfung in einer Baugruppe, auch mit Grenzen: Elemente, Winkel, Ausrichtung und Referenzrichtung.
Beschreibung
Eine Winkelverknüpfung stellt zwei Elemente in einem Winkel zueinander. Es gibt sie auch als erweiterte Verknüpfung mit Grenzen (limit angle mate): Dann dürfen sich die Teile innerhalb eines Winkelbereichs bewegen. AngleMateFeatureData hält die Daten für beide Arten. Übergeordnet ist MateFeatureData, das die Art der Verknüpfung liefert (swMateANGLE).
Zugriff
AssemblyDoc.CreateMateDatamitswMateANGLE: Daten für eine neue Verknüpfung, die du anAssemblyDoc.CreateMateübergibstFeature.GetDefinition: die Daten einer vorhandenen Winkelverknüpfung
Beispiel
' Legt zwischen zwei ausgewählten Flächen verschiedener Komponenten eine Winkelverknüpfung mit 30 Grad an.
' Vorbedingung: Eine Baugruppe ist offen, zwei ebene Flächen verschiedener Komponenten sind ausgewählt.
' Ergebnis: Eine neue Winkelverknüpfung im Ordner "Verknüpfungen".
Option Explicit
Sub main()
Const PI As Double = 3.14159265358979
Dim swApp As SldWorks.SldWorks
Dim swModel As SldWorks.ModelDoc2
Dim swAssy As SldWorks.AssemblyDoc
Dim swSelMgr As SldWorks.SelectionMgr
Dim swDaten As SldWorks.AngleMateFeatureData
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 swDaten = swAssy.CreateMateData(swMateANGLE)
swDaten.EntitiesToMate = vFlaechen
swDaten.MateAlignment = swMateAlignALIGNED
swDaten.FlipDimension = False
swDaten.Angle = 30 * PI / 180
Set swFeat = swAssy.CreateMate(swDaten)
If swFeat Is Nothing Then
Debug.Print "Keine Verknüpfung entstanden."
Else
Debug.Print "Angelegt: " & swFeat.Name
End If
End SubBemerkungen
Anlegen: Du folgst dem Ablauf bei AssemblyDoc.CreateMate. Die Elemente setzt du mit EntitiesToMate oder wählst sie vorher mit ModelDocExtension.SelectByID2 und Markierung 1 aus. Die Referenzrichtung setzt du mit ReferenceEntity oder wählst sie mit Markierung 67108864 aus. Dann setzt du die übrigen Eigenschaften. Die Liste bei CreateMate führt Winkelverknüpfungen allerdings nicht unter den Arten mit Vorauswahl. In SOLIDWORKS 2024 lieferte CreateMate mit zwei Flächen, die mit Markierung 1 ausgewählt waren, aber ohne EntitiesToMate Nothing. Setze die Elemente darum mit EntitiesToMate wie im Beispiel. Das Beispiel selbst legte die Verknüpfung an, die Flächennormalen standen danach 30° zueinander.
Ändern: Du holst mit Feature.GetDefinition das MateFeatureData-Objekt und weist es einer Variablen vom Typ AngleMateFeatureData zu. Dann änderst du die Werte und rufst Feature.ModifyDefinition auf. Löschen geht mit ModelDocExtension.DeleteSelection2.
Einheiten: Alle Winkel sind im Bogenmaß.
Grenzen: Das Hilfebeispiel „Create and Edit Limit Angle Mate“ legt eine Winkelverknüpfung mit Grenzen an, setzt dabei aber nur Minimum und Maximum, nicht AngleMateFeatureData.IsAdvancedMate. In SOLIDWORKS 2024 genügt das. Die neue Verknüpfung hieß „LimitWinkel1“ (Typname MateLimitPlanarAngleDim statt MatePlanarAngleDim), und IsAdvancedMate lieferte danach True. Die Beispiele hier setzen IsAdvancedMate trotzdem ausdrücklich.
Befehle von MateFeatureData: In SOLIDWORKS 2024 lieferte ErrorStatus über eine Variable vom Typ AngleMateFeatureData den Winkel statt des Fehlerstatus, TypeName brach mit Laufzeitfehler 13 ab. Für die Befehle von MateFeatureData nimmst du darum vermutlich besser eine Variable vom Typ MateFeatureData.
Eigenschaften und Methoden
Eigenschaften 8, davon 8 beschrieben
| Name | Beschreibung |
|---|---|
| Angle | Liest oder setzt den Winkel einer Winkelverknüpfung, im Bogenmaß. Bei einer Verknüpfung mit Grenzen ist es der Startwinkel. |
| EntitiesToMate | Liest oder setzt die beiden Elemente, die eine Winkelverknüpfung verbindet, etwa zwei Flächen oder zwei Ebenen. |
| FlipDimension | Liest oder setzt, ob bei einer Winkelverknüpfung das Maß umgekehrt wird, die Elemente also auf entgegengesetzten Seiten des Maßes liegen. |
| IsAdvancedMate | Liest oder setzt, ob eine Winkelverknüpfung Grenzen hat (limit angle mate), innerhalb derer sich die Teile bewegen dürfen. |
| MateAlignment | Liest oder setzt die Ausrichtung einer Winkelverknüpfung: gleich oder entgegengesetzt ausgerichtet. |
| MaximumAngle | Liest oder setzt den größten erlaubten Winkel einer Winkelverknüpfung mit Grenzen, im Bogenmaß. |
| MinimumAngle | Liest oder setzt den kleinsten erlaubten Winkel einer Winkelverknüpfung mit Grenzen, im Bogenmaß. |
| ReferenceEntity | Liest oder setzt die Referenzrichtung einer Winkelverknüpfung: eine Ebene, ebene Fläche, gerade Kante oder Referenzachse. |
Siehe auch
Englisches Original: IAngleMateFeatureData in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)
Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.