SolidWorksMakroprogrammierung

Objekt · SldWorks

MateControllerFeatureData-Objekt

Die Daten einer Verknüpfungssteuerung in einer Baugruppe: die gesteuerten Verknüpfungen und ihre Werte in benannten Positionen.

Deklaration Dim x As SldWorks.MateControllerFeatureData · in der englischen .NET-Hilfe: IMateControllerFeatureData

Beschreibung

Eine Verknüpfungssteuerung (mate controller) speichert für Verknüpfungen einer Baugruppe Werte in benannten Positionen (mate positions), etwa einen Abstand in „Position1“ und einen anderen in „Position2“. MateControllerFeatureData hält ihre Daten. Du legst sie mit FeatureManager.CreateDefinition und FeatureManager.CreateFeature an, liest sie mit Feature.GetDefinition und übernimmst Änderungen mit Feature.ModifyDefinition. Die Befehle gibt es seit SOLIDWORKS 2023, für AddConfigurationFromPosition nennt die Hilfe keine Version.

Zugriff

Beispiel

' Legt für die einzige passende Verknüpfung der Baugruppe eine Verknüpfungssteuerung
' mit den Positionen "Nah" (10 mm) und "Fern" (50 mm) an.
' Vorbedingung: Eine Baugruppe ist offen, in der genau eine Verknüpfung passt, etwa eine
'               Abstandsverknüpfung.
' Ergebnis:     Eine neue Verknüpfungssteuerung im FeatureManager, Fehler stehen im Direktfenster.
Option Explicit

Sub main()
    Dim swApp As SldWorks.SldWorks
    Dim swModel As SldWorks.ModelDoc2
    Dim swAssy As SldWorks.AssemblyDoc
    Dim swFeatMgr As SldWorks.FeatureManager
    Dim swDaten As SldWorks.MateControllerFeatureData
    Dim swFeat As SldWorks.Feature
    Dim vMates As Variant
    Dim aWert(0) As Double
    Dim vFehler As Variant
    Dim sTyp As String
    Dim i As Long

    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
    If False = swAssy.IsSupportedMatesAvailable Then
        Debug.Print "Keine passende Verknüpfung."
        Exit Sub
    End If
    vMates = swAssy.CollectAllSupportiveMates
    If UBound(vMates) <> 0 Then
        Debug.Print "Das Beispiel erwartet genau eine passende Verknüpfung."
        Exit Sub
    End If

    Set swFeatMgr = swModel.FeatureManager
    Set swDaten = swFeatMgr.CreateDefinition(swFmMateController)
    swDaten.Initialize vMates
    swDaten.AddNewPosition "Nah"
    swDaten.AddNewPosition "Fern"
    aWert(0) = 0.01                                    ' ein Wert je Verknüpfung, 10 mm
    swDaten.SetValues "Nah", aWert
    aWert(0) = 0.05                                    ' 50 mm
    swDaten.SetValues "Fern", aWert

    Set swFeat = swFeatMgr.CreateFeature(swDaten)
    If swFeat Is Nothing Then
        If swFeatMgr.GetCreateFeatureErrors(vFehler, sTyp) > 0 Then
            For i = 0 To UBound(vFehler)
                Debug.Print "Fehler " & vFehler(i) & " (swCreateFeatureError_e)"
            Next i
        End If
    Else
        Debug.Print "Angelegt: " & swFeat.Name
    End If
End Sub

Bemerkungen

Anlegen: Prüfe mit AssemblyDoc.IsSupportedMatesAvailable, ob die Baugruppe passende Verknüpfungen hat, und sammle sie mit AssemblyDoc.CollectAllSupportiveMates. Dann holst du die Daten mit FeatureManager.CreateDefinition und übergibst die Verknüpfungen mit MateControllerFeatureData.Initialize oder wählst sie vorher aus. Danach legst du die Positionen an, setzt ihre Werte und rufst FeatureManager.CreateFeature auf. Was dabei schiefging, liefert FeatureManager.GetCreateFeatureErrors mit Werten aus swCreateFeatureError_e.

Passende Verknüpfungen: Nach IsSupportedMatesAvailable sind das Winkel, Abstand, Pfad, Nut und Breite, Pfad, Breite und Nut aber nicht mit freier oder mittiger Lage. Bei swCreateFeatureError_e nennt die Hilfe dagegen Abstand und Grenzabstand, Winkel und Grenzwinkel, Breite und Nut, ohne Pfad.

Werte: MateControllerFeatureData.SetValues erwartet je Position einen Wert für jede Verknüpfung. Ohne Werte nimmt die Verknüpfungssteuerung die Werte, mit denen die Verknüpfungen angelegt wurden. Eine Einheit nennt die Hilfe nicht. Die Hilfebeispiele setzen für einen Abstand entlang einer Nut 0,0375 und 0,0625; es sind Meter.

Ändern: Hole die Daten mit Feature.GetDefinition, rufe MateControllerFeatureData.AccessSelections auf, ändere die Werte und übernimm sie mit Feature.ModifyDefinition. Ohne Änderung hebst du den Zustand mit MateControllerFeatureData.ReleaseSelectionAccess auf. Das Hilfebeispiel ändert die Werte zweier Positionen allerdings ohne AccessSelections.

Typname: Den Typnamen des Features nennt die Hilfe nicht. Für mehr zur Verknüpfungssteuerung selbst verweist sie auf die Hilfe der Benutzeroberfläche (Baugruppen, Verknüpfungen, Mate Controller).

Der Typname des Features ist DimController. MateControllerFeatureData.Initialize legt selbst eine Position „Position 1“ mit den aktuellen Werten an, deine eigenen Positionen kommen dazu.

Eigenschaften und Methoden

Eigenschaften 1, davon 1 beschrieben

NameBeschreibung
MatesLiest oder setzt die Verknüpfungen, die die Verknüpfungssteuerung steuert.

Methoden 10, davon 10 beschrieben

NameBeschreibung
AccessSelectionsSetzt das Modell vor die Verknüpfungssteuerung zurück, damit du die Auswahlen lesen und ändern kannst, die sie festlegen.
AddConfigurationFromPositionLegt aus einer Position der Verknüpfungssteuerung eine Konfiguration an.
AddNewPositionFügt der Verknüpfungssteuerung eine neue Position hinzu.
DeletePositionLöscht eine Position aus der Verknüpfungssteuerung.
GetPositionsLiefert alle Positionen der Verknüpfungssteuerung.
GetValuesLiefert die Werte aller gesteuerten Verknüpfungen in einer Position.
InitializeÜbergibt der neuen Verknüpfungssteuerung die Verknüpfungen, die sie steuern soll.
ReleaseSelectionAccessHebt den Rücksetz-Zustand nach AccessSelections wieder auf, wenn du die Verknüpfungssteuerung nicht geändert hast.
ReOrderPositionsÄndert die Reihenfolge der Positionen der Verknüpfungssteuerung.
SetValuesSetzt die Werte aller gesteuerten Verknüpfungen für eine Position.

Siehe auch

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

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