SolidWorksMakroprogrammierung

Objekt · SldWorks

ProfileCenterMateFeatureData-Objekt

Die Daten einer Profilmittelpunkt-Verknüpfung in einer Baugruppe: die Elemente, die Ausrichtung, der Versatz und ob die Drehung gesperrt ist.

Deklaration Dim x As SldWorks.ProfileCenterMateFeatureData · in der englischen .NET-Hilfe: IProfileCenterMateFeatureData

Beschreibung

Eine Profilmittelpunkt-Verknüpfung richtet rechteckige und runde Profile mittig zueinander aus und bestimmt die Komponenten vollständig. ProfileCenterMateFeatureData hält ihre Daten. Übergeordnet ist MateFeatureData. Die Befehle gibt es seit SOLIDWORKS 2018.

Zugriff

Beispiel

' Legt eine Profilmittelpunkt-Verknüpfung zwischen den beiden ausgewählten Flächen an,
' mit 5 mm Versatz und gesperrter Drehung.
' Vorbedingung: Eine Baugruppe ist offen. Ausgewählt sind zwei Flächen
'               rechteckiger oder runder Profile verschiedener Komponenten.
' Ergebnis:     Eine neue 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.ProfileCenterMateFeatureData
    Dim swFeat As SldWorks.Feature
    Dim vElemente(1) As Object

    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 vElemente(0) = swSelMgr.GetSelectedObject6(1, -1)
    Set vElemente(1) = swSelMgr.GetSelectedObject6(2, -1)

    Set swDaten = swAssy.CreateMateData(swMatePROFILECENTER)
    swDaten.EntitiesToMate = vElemente
    swDaten.MateAlignment = swMateAlignALIGNED
    swDaten.OffsetDistance = 0.005                       ' 5 mm, in Metern
    swDaten.FlipDimension = False
    swDaten.LockRotation = True

    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 ProfileCenterMateFeatureData.EntitiesToMate oder wählst sie vorher mit ModelDocExtension.SelectByID2 und der Markierung 1 aus. Dann setzt du die übrigen Eigenschaften. Das Hilfebeispiel wählt die Flächen mit ModelDocExtension.SelectByRay aus und setzt sie zusätzlich mit EntitiesToMate. Die Liste bei CreateMate führt Profilmittelpunkt-Verknüpfungen allerdings nicht unter den Arten mit Vorauswahl; was gilt, ist offen.

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

Kopieren: Das Hilfebeispiel „Copy Component With Profile Center Mate“ kopiert eine Komponente samt Profilmittelpunkt-Verknüpfung mit AssemblyDoc.CopyWithMates2. Dort gibst du Versatz, Seite des Maßes und Drehsperre der kopierten Verknüpfung in eigenen Arrays an.

Hilfebeispiel: Das VBA-Beispiel „Create and Edit Profile Center Mate“ ruft CreateMateData mit der Zahl 24 auf und prüft den Typ der Daten mit MateFeatureData.TypeName gegen swMatePROFILECENTER. Das Beispiel hier nimmt gleich die Konstante.

Eigenschaften und Methoden

Eigenschaften 5, davon 5 beschrieben

NameBeschreibung
EntitiesToMateLiest oder setzt die Flächen oder Kanten, die die Profilmittelpunkt-Verknüpfung mittig zueinander ausrichtet.
FlipDimensionLiest oder setzt, ob die Profilmittelpunkt-Verknüpfung die Elemente auf die jeweils andere Seite des Maßes legt.
LockRotationLiest oder setzt, ob die Profilmittelpunkt-Verknüpfung die Drehung sperrt.
MateAlignmentLiest oder setzt die Ausrichtung der Profilmittelpunkt-Verknüpfung.
OffsetDistanceLiest oder setzt den Versatz der Profilmittelpunkt-Verknüpfung.

Siehe auch

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

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