Objekt · SldWorks
DimPatternFeatureData-Objekt
Die Feature-Daten eines variablen Musters: eine Tabelle, in der jede Zeile eine Instanz ist und jede Spalte eine steuernde Bemaßung mit ihren Werten.
Beschreibung
DimPatternFeatureData gibt Zugriff auf ein variables Muster. Ein variables Muster speichert die Bemaßungen und ihre Werte für alle Instanzen in einer Tabelle, der Mustertabelle. Jede Zeile ist eine Instanz, jede Spalte eine Bemaßung des Ausgangsfeatures oder seiner Skizze. So kann jede Instanz andere Maße haben. Die Tabelle kannst du nach Microsoft Excel exportieren und aus Excel importieren. Die Lesebefehle gibt es seit SOLIDWORKS 2015, die Befehle zum Ändern der Tabelle seit SOLIDWORKS 2017.
Zugriff
FeatureManager.CreateDefinitionmitswFmDimPattern: Daten für ein neues variables Muster, das du mitFeatureManager.CreateFeatureanlegstFeature.GetDefinition: aus einem vorhandenen variablen Muster (TypnameDimPattern, sieheFeature.GetTypeName2). Im FeatureManager heißt es etwaVarPattern1.
Früher legte man variable Muster mit FeatureManager.FeatureAdvancedTableDrivenPattern an. Die Methode ist veraltet, Nachfolger ist CreateDefinition mit CreateFeature.
Beispiel
' Gibt die steuernden Bemaßungen und die Instanzen des ausgewählten variablen Musters aus.
' Vorbedingung: Ein Teil ist offen, ein variables Muster ist im FeatureManager ausgewählt.
' Ergebnis: Spalten und Zeilen der Mustertabelle stehen im Direktfenster.
Option Explicit
Sub main()
Dim swApp As SldWorks.SldWorks
Dim swModel As SldWorks.ModelDoc2
Dim swSel As Object
Dim swFeat As SldWorks.Feature
Dim swDaten As SldWorks.DimPatternFeatureData
Dim sName As String
Dim i As Long
Set swApp = Application.SldWorks
Set swModel = swApp.ActiveDoc
If swModel Is Nothing Then Exit Sub
Set swSel = swModel.SelectionManager.GetSelectedObject6(1, -1)
If Not TypeOf swSel Is SldWorks.Feature Then Exit Sub
Set swFeat = swSel
If swFeat.GetTypeName2 <> "DimPattern" Then Exit Sub
Set swDaten = swFeat.GetDefinition
If False = swDaten.AccessSelections(swModel, Nothing) Then Exit Sub
Debug.Print "Steuernde Bemaßungen: " & swDaten.GetControllingDimensionCount
For i = 0 To swDaten.GetControllingDimensionCount - 1
Debug.Print " " & swDaten.GetControllingDimensionName(i)
Next i
Debug.Print "Instanzen: " & swDaten.GetInstanceCount
For i = 1 To swDaten.GetInstanceCount
sName = swDaten.GetInstanceNameByIndex(i)
Debug.Print " " & i & ": " & sName & _
", unterdrückt: " & swDaten.GetInstanceSuppressStateByIndex(i)
Next i
swDaten.ReleaseSelectionAccess ' nichts geändert
End SubBemerkungen
Anlegen: Vor FeatureManager.CreateDefinition wählst du die Elemente mit ModelDocExtension.SelectByID2 in beliebiger Reihenfolge und mit diesen Markierungen aus:
4für das Feature, das gemustert wird1048576für die Referenzgeometrie, die das Ausgangsfeature steuert
Danach rufst du FeatureManager.CreateFeature auf. Die Hilfe spricht hier versehentlich von einem abgeleiteten Muster (derived pattern). Das Hilfebeispiel „Insert Variable Pattern Feature“ füllt die Tabelle vorher mit der veralteten Methode FeatureManager.InsertVaryInstanceOverride, deren Nachfolger InstanceToVaryOptions ist. Wie du die Tabelle ohne diese Methode vor dem Anlegen füllst, sagt die Hilfe nicht.
Ändern: Du rufst erst DimPatternFeatureData.AccessSelections auf und übernimmst Änderungen mit Feature.ModifyDefinition. Ohne Änderung hebst du den Zustand mit DimPatternFeatureData.ReleaseSelectionAccess auf. Das Hilfebeispiel „Delete and Insert Instances in Variable Pattern Feature“ weist darauf hin, dass ModifyDefinition nach dem Hinzufügen einer Instanz mehrere Minuten dauern kann.
Nummern der Instanzen: Die Hilfe zählt nicht überall gleich:
DimPatternFeatureData.AddInstanceAtundDimPatternFeatureData.DeleteInstanceAtnehmen eine Position ab 0,-1steht für das Ende.DimPatternFeatureData.GetInstanceNameByIndexzählt die Zeilen der Tabelle ab 1.DimPatternFeatureData.GetTableRowIndexliefert den Wert in der Spalte „Instance“ der Tabelle. Diese Nummer nehmenDimPatternFeatureData.SetInstanceDimensionValueund die Befehle zum Unterdrücken.DimPatternFeatureData.GetInstanceIndexliefert die Nummer im FeatureManager.
Ob die Spalte „Instance“ bei 0 oder bei 1 beginnt, sagt die Hilfe nicht eindeutig. In SOLIDWORKS 2024 trugen die beiden Instanzen die Zeilennummern 1 und 2, mit denen auch SetInstanceDimensionValue und SetInstanceSuppressStateByIndex arbeiteten. swPatternFeatureImportExportError_e gibt an, dass die Instanzen für den Excel-Import bei 0 beginnen müssen. Die steuernden Bemaßungen zählen die Hilfebeispiele ab 0.
Namen der Bemaßungen: Eine Spalte heißt wie die Bemaßung mit dem Feature, getrennt durch @, etwa D3@Fillet1. Die Hilfebeispiele übergeben an SetInstanceDimensionValue dagegen lange Namen wie D3@Sketch2@bottle.moPart_c. Nimm darum die Namen aus DimPatternFeatureData.GetControllingDimensionName.
Einheiten: Die Hilfe nennt für die Werte in der Tabelle keine Einheit. Bei Längen sind es Meter, bei Winkeln vermutlich Bogenmaß. Die Hilfebeispiele setzen Werte wie 0.15 und 0.01.
Hilfethema: Die Hilfe verweist auf das Thema „Pattern Features and their Feature Data Objects“.
Über FeatureManager.CreateDefinition mit swFmDimPattern ließ sich kein variables Muster anlegen: FeatureManager.CreateFeature lieferte Nothing, und DimPatternFeatureData.AddDimension vor dem Anlegen brach mit einem Automatisierungsfehler ab. Haben alle Instanzen denselben Namen, liefert DimPatternFeatureData.GetTableRowIndex für jede Instanz 1 und die Befehle mit Namen treffen immer die erste Zeile; nimm dann die Zeilennummer.
Eigenschaften und Methoden
Eigenschaften 1, davon 1 beschrieben
| Name | Beschreibung |
|---|---|
| PropagateVisualProperties | Liest oder setzt, ob die Instanzen des variablen Musters die Darstellung des Ausgangsfeatures übernehmen, etwa Farben und Texturen. |
Methoden 20, davon 20 beschrieben
| Name | Beschreibung |
|---|---|
| AccessSelections | Setzt das Modell vor das variable Muster zurück, damit du die Auswahlen und die Mustertabelle lesen und ändern kannst. |
| AddDimension | Fügt die ausgewählte Bemaßung als neue Spalte in die Mustertabelle des variablen Musters ein. |
| AddInstanceAt | Fügt dem variablen Muster eine Instanz hinzu, also eine neue Zeile in der Mustertabelle. |
| DeleteDimension | Löscht eine Spalte mit steuernden Bemaßungen aus der Mustertabelle des variablen Musters. |
| DeleteInstanceAt | Löscht eine Instanz des variablen Musters, also eine Zeile der Mustertabelle. |
| ExportToExcel | Schreibt die Mustertabelle des variablen Musters in eine Excel-Datei. |
| GetControllingDimensionCount | Liefert die Zahl der steuernden Bemaßungen des variablen Musters, also der Spalten mit Bemaßungen in der Mustertabelle. |
| GetControllingDimensionName | Liefert den Namen einer steuernden Bemaßung des variablen Musters. |
| GetInstanceCount | Liefert die Zahl der Instanzen des variablen Musters. |
| GetInstanceDimensionName | Liefert den Namen der Bemaßung, die eine Instanz des variablen Musters zu einer steuernden Bemaßung hat. |
| GetInstanceIndex | Liefert die Nummer einer Instanz des variablen Musters im FeatureManager. |
| GetInstanceNameByIndex | Liefert den Namen der Instanz in einer Zeile der Mustertabelle des variablen Musters. |
| GetInstanceSuppressStateByIndex | Liefert, ob die Instanz mit einer bestimmten Nummer in der Mustertabelle unterdrückt ist. |
| GetInstanceSuppressStateByName | Liefert, ob die Instanz mit einem bestimmten Namen unterdrückt ist. |
| GetTableRowIndex | Liefert die Nummer einer Instanz in der Spalte „Instance“ der Mustertabelle. |
| ImportFromExcel | Liest eine Mustertabelle für das variable Muster aus einer Excel-Datei ein. |
| ReleaseSelectionAccess | Hebt den Rücksetz-Zustand nach AccessSelections wieder auf, wenn du das variable Muster nicht geändert hast. |
| SetInstanceDimensionValue | Setzt für eine Instanz des variablen Musters einen neuen Wert einer steuernden Bemaßung. |
| SetInstanceSuppressStateByIndex | Unterdrückt die Instanz mit einer bestimmten Nummer in der Mustertabelle oder hebt die Unterdrückung auf. |
| SetInstanceSuppressStateByName | Unterdrückt die Instanz mit einem bestimmten Namen oder hebt die Unterdrückung auf. |
Siehe auch
Englisches Original: IDimPatternFeatureData in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)
Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.