SolidWorksMakroprogrammierung

Objekt · SldWorks

HingeMateFeatureData-Objekt

Die Daten einer Scharnier-Verknüpfung in einer Baugruppe: die konzentrischen, deckungsgleichen und Winkel-Elemente, die Ausrichtung und die Winkelgrenzen.

Deklaration Dim x As SldWorks.HingeMateFeatureData · in der englischen .NET-Hilfe: IHingeMateFeatureData

Beschreibung

Eine Scharnier-Verknüpfung lässt zwischen zwei Komponenten nur eine Drehung zu und kann den Drehwinkel zusätzlich begrenzen. Sie wirkt wie eine konzentrische und eine deckungsgleiche Verknüpfung zusammen. HingeMateFeatureData hält ihre Daten. Übergeordnet ist MateFeatureData. Die Befehle gibt es seit SOLIDWORKS 2019.

Zugriff

Beispiel

' Legt eine Scharnier-Verknüpfung ohne Winkelgrenzen an. Die ersten beiden ausgewählten
' Elemente werden konzentrisch, die nächsten beiden deckungsgleich verknüpft.
' Vorbedingung: Eine Baugruppe ist offen. Ausgewählt sind zuerst zwei Zylinderflächen,
'               dann zwei ebene Flächen verschiedener Komponenten.
' Ergebnis:     Eine neue Scharnier-Verknüpfung 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 swDaten As SldWorks.HingeMateFeatureData
    Dim swFeat As SldWorks.Feature
    Dim vKonz(1) As Object
    Dim vDeck(1) As Object
    Dim vElemente 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) <> 4 Then
        Debug.Print "Bitte zwei Zylinderflächen und zwei ebene Flächen auswählen."
        Exit Sub
    End If
    Set vKonz(0) = swSelMgr.GetSelectedObject6(1, -1)
    Set vKonz(1) = swSelMgr.GetSelectedObject6(2, -1)
    Set vDeck(0) = swSelMgr.GetSelectedObject6(3, -1)
    Set vDeck(1) = swSelMgr.GetSelectedObject6(4, -1)

    Set swDaten = swAssy.CreateMateData(swMateHINGE)
    vElemente = vKonz
    swDaten.EntitiesToMate(swHingeMateEntityType_Concentric) = vElemente
    vElemente = vDeck
    swDaten.EntitiesToMate(swHingeMateEntityType_Coincident) = vElemente
    swDaten.AngleSelection = False
    swDaten.MateAlignment = swMateAlignALIGNED

    Set swFeat = swAssy.CreateMate(swDaten)
    swModel.ClearSelection2 True
    If swFeat Is Nothing Then
        Debug.Print "Keine Verknüpfung entstanden."
    Else
        Debug.Print "Angelegt: " & swFeat.Name
        swModel.EditRebuild3
    End If
End Sub

Bemerkungen

Anlegen: Folge dem Ablauf bei AssemblyDoc.CreateMate. Die Elemente setzt du mit HingeMateFeatureData.EntitiesToMate je Wert aus swHingeMateEntityType_e oder wählst sie vorher mit ModelDocExtension.SelectByID2 aus: Markierung 1 für die konzentrischen Elemente, 32768 für die deckungsgleichen und 65536 für die Winkelflächen. Vorher auswählen geht nur beim Anlegen, nicht beim Ändern.

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

Winkelgrenzen: Setzt du HingeMateFeatureData.AngleSelection auf True, setzt du auch HingeMateFeatureData.Angle, HingeMateFeatureData.MinVal, HingeMateFeatureData.MaxVal und die beiden Winkelflächen. Alle Winkel sind im Bogenmaß.

Hilfebeispiel: Das VBA-Beispiel der Hilfe öffnet Hinge-Assy.sldasm aus den Lernbeispielen, wählt sechs Elemente mit ModelDocExtension.SelectByRay und den Markierungen 32768, 65536 und 1 aus und ruft CreateMateData über eine Variable vom Typ ModelDoc2 mit der Zahl 22 auf. Es weist die Elemente über eine Variant-Variable mit den Indizes 0, 1 und 2 zu, setzt AngleSelection auf True, Angle, MinVal und MaxVal alle auf 30° (0.5235987755983) und MateAlignment auf 0 (swMateAlignALIGNED). Das Beispiel hier nimmt eine Variable vom Typ AssemblyDoc und die Konstanten.

Eigenschaften und Methoden

Eigenschaften 6, davon 6 beschrieben

NameBeschreibung
AngleLiest oder setzt den Nennwinkel zwischen den beiden Winkelflächen der Scharnier-Verknüpfung, im Bogenmaß.
AngleSelectionLiest oder setzt, ob die Scharnier-Verknüpfung den Drehwinkel begrenzt.
EntitiesToMateLiest oder setzt die Elemente der Scharnier-Verknüpfung: die konzentrischen, die deckungsgleichen oder die beiden Winkelflächen.
MateAlignmentLiest oder setzt die Ausrichtung der Scharnier-Verknüpfung.
MaxValLiest oder setzt die größte erlaubte Drehung zwischen den beiden Komponenten der Scharnier-Verknüpfung, im Bogenmaß.
MinValLiest oder setzt die kleinste erlaubte Drehung zwischen den beiden Komponenten der Scharnier-Verknüpfung, im Bogenmaß.

Siehe auch

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

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