Objekt · SldWorks
HingeMateFeatureData-Objekt
Die Daten einer Scharnier-Verknüpfung in einer Baugruppe: die konzentrischen, deckungsgleichen und Winkel-Elemente, die Ausrichtung und die Winkelgrenzen.
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
AssemblyDoc.CreateMateDatamitswMateHINGE: Daten für eine neue Verknüpfung, die du anAssemblyDoc.CreateMateübergibstFeature.GetDefinition: die Daten einer vorhandenen Scharnier-Verknüpfung (TypnameMateHinge)
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 SubBemerkungen
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
| Name | Beschreibung |
|---|---|
| Angle | Liest oder setzt den Nennwinkel zwischen den beiden Winkelflächen der Scharnier-Verknüpfung, im Bogenmaß. |
| AngleSelection | Liest oder setzt, ob die Scharnier-Verknüpfung den Drehwinkel begrenzt. |
| EntitiesToMate | Liest oder setzt die Elemente der Scharnier-Verknüpfung: die konzentrischen, die deckungsgleichen oder die beiden Winkelflächen. |
| MateAlignment | Liest oder setzt die Ausrichtung der Scharnier-Verknüpfung. |
| MaxVal | Liest oder setzt die größte erlaubte Drehung zwischen den beiden Komponenten der Scharnier-Verknüpfung, im Bogenmaß. |
| MinVal | Liest 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.