SolidWorksMakroprogrammierung

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.

Deklaration Dim x As SldWorks.DimPatternFeatureData · in der englischen .NET-Hilfe: IDimPatternFeatureData

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

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 Sub

Bemerkungen

Anlegen: Vor FeatureManager.CreateDefinition wählst du die Elemente mit ModelDocExtension.SelectByID2 in beliebiger Reihenfolge und mit diesen Markierungen aus:

  • 4 für das Feature, das gemustert wird
  • 1048576 fü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:

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

NameBeschreibung
PropagateVisualPropertiesLiest oder setzt, ob die Instanzen des variablen Musters die Darstellung des Ausgangsfeatures übernehmen, etwa Farben und Texturen.

Methoden 20, davon 20 beschrieben

NameBeschreibung
AccessSelectionsSetzt das Modell vor das variable Muster zurück, damit du die Auswahlen und die Mustertabelle lesen und ändern kannst.
AddDimensionFügt die ausgewählte Bemaßung als neue Spalte in die Mustertabelle des variablen Musters ein.
AddInstanceAtFügt dem variablen Muster eine Instanz hinzu, also eine neue Zeile in der Mustertabelle.
DeleteDimensionLöscht eine Spalte mit steuernden Bemaßungen aus der Mustertabelle des variablen Musters.
DeleteInstanceAtLöscht eine Instanz des variablen Musters, also eine Zeile der Mustertabelle.
ExportToExcelSchreibt die Mustertabelle des variablen Musters in eine Excel-Datei.
GetControllingDimensionCountLiefert die Zahl der steuernden Bemaßungen des variablen Musters, also der Spalten mit Bemaßungen in der Mustertabelle.
GetControllingDimensionNameLiefert den Namen einer steuernden Bemaßung des variablen Musters.
GetInstanceCountLiefert die Zahl der Instanzen des variablen Musters.
GetInstanceDimensionNameLiefert den Namen der Bemaßung, die eine Instanz des variablen Musters zu einer steuernden Bemaßung hat.
GetInstanceIndexLiefert die Nummer einer Instanz des variablen Musters im FeatureManager.
GetInstanceNameByIndexLiefert den Namen der Instanz in einer Zeile der Mustertabelle des variablen Musters.
GetInstanceSuppressStateByIndexLiefert, ob die Instanz mit einer bestimmten Nummer in der Mustertabelle unterdrückt ist.
GetInstanceSuppressStateByNameLiefert, ob die Instanz mit einem bestimmten Namen unterdrückt ist.
GetTableRowIndexLiefert die Nummer einer Instanz in der Spalte „Instance“ der Mustertabelle.
ImportFromExcelLiest eine Mustertabelle für das variable Muster aus einer Excel-Datei ein.
ReleaseSelectionAccessHebt den Rücksetz-Zustand nach AccessSelections wieder auf, wenn du das variable Muster nicht geändert hast.
SetInstanceDimensionValueSetzt für eine Instanz des variablen Musters einen neuen Wert einer steuernden Bemaßung.
SetInstanceSuppressStateByIndexUnterdrückt die Instanz mit einer bestimmten Nummer in der Mustertabelle oder hebt die Unterdrückung auf.
SetInstanceSuppressStateByNameUnterdrü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.