SolidWorksMakroprogrammierung

Objekt · SldWorks

AngleMateFeatureData-Objekt

Die Daten einer Winkelverknüpfung in einer Baugruppe, auch mit Grenzen: Elemente, Winkel, Ausrichtung und Referenzrichtung.

Deklaration Dim x As SldWorks.AngleMateFeatureData · in der englischen .NET-Hilfe: IAngleMateFeatureData

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

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 Sub

Bemerkungen

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

NameBeschreibung
AngleLiest oder setzt den Winkel einer Winkelverknüpfung, im Bogenmaß. Bei einer Verknüpfung mit Grenzen ist es der Startwinkel.
EntitiesToMateLiest oder setzt die beiden Elemente, die eine Winkelverknüpfung verbindet, etwa zwei Flächen oder zwei Ebenen.
FlipDimensionLiest oder setzt, ob bei einer Winkelverknüpfung das Maß umgekehrt wird, die Elemente also auf entgegengesetzten Seiten des Maßes liegen.
IsAdvancedMateLiest oder setzt, ob eine Winkelverknüpfung Grenzen hat (limit angle mate), innerhalb derer sich die Teile bewegen dürfen.
MateAlignmentLiest oder setzt die Ausrichtung einer Winkelverknüpfung: gleich oder entgegengesetzt ausgerichtet.
MaximumAngleLiest oder setzt den größten erlaubten Winkel einer Winkelverknüpfung mit Grenzen, im Bogenmaß.
MinimumAngleLiest oder setzt den kleinsten erlaubten Winkel einer Winkelverknüpfung mit Grenzen, im Bogenmaß.
ReferenceEntityLiest 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.