Objekt · SldWorks
MateControllerFeatureData-Objekt
Die Daten einer Verknüpfungssteuerung in einer Baugruppe: die gesteuerten Verknüpfungen und ihre Werte in benannten Positionen.
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
FeatureManager.CreateDefinitionmitswFmMateController: Daten für eine neue Verknüpfungssteuerung, die du anFeatureManager.CreateFeatureübergibstFeature.GetDefinition: die Daten einer vorhandenen Verknüpfungssteuerung
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 SubBemerkungen
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
| Name | Beschreibung |
|---|---|
| Mates | Liest oder setzt die Verknüpfungen, die die Verknüpfungssteuerung steuert. |
Methoden 10, davon 10 beschrieben
| Name | Beschreibung |
|---|---|
| AccessSelections | Setzt das Modell vor die Verknüpfungssteuerung zurück, damit du die Auswahlen lesen und ändern kannst, die sie festlegen. |
| AddConfigurationFromPosition | Legt aus einer Position der Verknüpfungssteuerung eine Konfiguration an. |
| AddNewPosition | Fügt der Verknüpfungssteuerung eine neue Position hinzu. |
| DeletePosition | Löscht eine Position aus der Verknüpfungssteuerung. |
| GetPositions | Liefert alle Positionen der Verknüpfungssteuerung. |
| GetValues | Liefert die Werte aller gesteuerten Verknüpfungen in einer Position. |
| Initialize | Übergibt der neuen Verknüpfungssteuerung die Verknüpfungen, die sie steuern soll. |
| ReleaseSelectionAccess | Hebt 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. |
| SetValues | Setzt 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.