SolidWorksMakroprogrammierung

Objekt · SldWorks

DerivedPatternFeatureData-Objekt

Die Feature-Daten eines abgeleiteten Musters in einer Baugruppe: Ausgangskomponenten, steuerndes Muster, Ausgangsposition, ausgelassene Instanzen und Darstellung.

Deklaration Dim x As SldWorks.DerivedPatternFeatureData · in der englischen .NET-Hilfe: IDerivedPatternFeatureData

Beschreibung

DerivedPatternFeatureData gibt Zugriff auf ein abgeleitetes Muster (derived pattern). Die Hilfe nennt es auch „pattern driven pattern“, in der Oberfläche heißt es vermutlich „Mustergesteuertes Komponentenmuster“. Es vervielfältigt Komponenten (die Ausgangskomponenten) nach einem vorhandenen Muster, dem steuernden Muster. In den Hilfebeispielen ist das ein lineares Muster in einem Teil der Baugruppe oder ein lineares Komponentenmuster. Die Grundbefehle gibt es seit SOLIDWORKS 2001 SP02, DerivedPatternFeatureData.GetTransform seit SOLIDWORKS 2010, DerivedPatternFeatureData.SeedPosition und DerivedPatternFeatureData.PropagateVisualProperty seit SOLIDWORKS 2017 und DerivedPatternFeatureData.ForceUseSeedConfiguration seit SOLIDWORKS 2021.

Zugriff

Beispiel

' Gibt steuerndes Muster, Ausgangsposition, Ausgangskomponenten und ausgelassene
' Instanzen des ausgewählten abgeleiteten Musters aus.
' Vorbedingung: Eine Baugruppe ist offen, ein abgeleitetes Muster ist im
'               FeatureManager ausgewählt.
' Ergebnis:     Die Werte stehen im Direktfenster (Strg+G).
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.DerivedPatternFeatureData
    Dim swMuster As SldWorks.Feature
    Dim swAusgang As SldWorks.Feature
    Dim vAusgang As Variant
    Dim vAusgelassen As Variant
    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 swSel = swModel.SelectionManager.GetSelectedObject6(1, -1)
    If Not TypeOf swSel Is SldWorks.Feature Then Exit Sub
    Set swFeat = swSel
    Select Case swFeat.GetTypeName2
        Case "DerivedLPattern", "DerivedCirPattern", "DerivedHolePattern"
        Case Else
            Debug.Print swFeat.Name & " ist kein abgeleitetes Muster."
            Exit Sub
    End Select

    Set swDaten = swFeat.GetDefinition
    If False = swDaten.AccessSelections(swModel, Nothing) Then Exit Sub

    Set swMuster = swDaten.PatternFeature
    Debug.Print "Steuerndes Muster: " & swMuster.Name & " (" & swMuster.GetTypeName2 & ")"
    Debug.Print "Ausgangsposition:  " & swDaten.SeedPosition

    vAusgang = swDaten.SeedComponentArray
    If IsArray(vAusgang) Then
        For i = 0 To UBound(vAusgang)
            Set swAusgang = vAusgang(i)
            Debug.Print "Ausgangskomponente: " & swAusgang.Name
        Next i
    End If

    Debug.Print "Ausgelassen: " & swDaten.GetSkippedItemCount & " Instanzen"
    vAusgelassen = swDaten.DrivingFeatureSkippedItemArray
    If IsArray(vAusgelassen) Then
        For i = 0 To UBound(vAusgelassen)
            Debug.Print "Im steuernden Muster ausgelassen: " & vAusgelassen(i)
        Next i
    End If
    Debug.Print "Darstellung übernehmen: " & swDaten.PropagateVisualProperty

    swDaten.ReleaseSelectionAccess
End Sub

Bemerkungen

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

  • Ausgangskomponente: 1
  • steuerndes Muster: 2

Nach dem Einstellen der Daten rufst du FeatureManager.CreateFeature auf. Das Hilfebeispiel „Create Derived Pattern Feature“ wählt so eine Komponente (COMPONENT, Markierung 1) und ein lineares Muster in einem Teil der Baugruppe (BODYFEATURE, Markierung 2) aus. Die älteren Befehle AssemblyDoc.InsertDerivedPattern und FeatureManager.InsertDerivedPattern2 sind veraltet, Nachfolger ist FeatureManager.CreateFeature.

Ändern: Du rufst erst DerivedPatternFeatureData.AccessSelections auf und übernimmst Änderungen mit Feature.ModifyDefinition. Ohne Änderung hebst du den Zustand mit DerivedPatternFeatureData.ReleaseSelectionAccess auf.

Typnamen: In der Tabelle zu Feature.GetTypeName2 gehören DerivedLPattern, DerivedCirPattern und DerivedHolePattern zu DerivedPatternFeatureData. Die Tabelle führt sie bei den Körper-Features, das Hilfebeispiel „Get and Set Seed Components“ findet DerivedLPattern und DerivedCirPattern aber in einer Baugruppe. Ob es abgeleitete Muster auch in Teilen gibt, sagt die Hilfe nicht.

Objekte zuweisen: Das steuernde Muster ist eine Objekt-Eigenschaft. Wie du ihr ein Feature zuweist, mit oder ohne Set, zeigt die Hilfe nicht. Die Ausgangskomponenten weist das Hilfebeispiel „Get and Set Seed Components“ als Array ohne Set zu.

Hilfethema: Die Hilfe verweist auf das Thema „Pattern Features and their Feature Data Objects“ und auf den PropertyManager „Pattern Driven Component Pattern“ in der Hilfe zur Oberfläche.

Eigenschaften und Methoden

Eigenschaften 7, davon 7 beschrieben

NameBeschreibung
DrivingFeatureSkippedItemArrayLiefert die Instanzen, die das steuernde Muster des abgeleiteten Musters auslässt.
ForceUseSeedConfigurationLiest oder setzt, ob die gemusterten Komponenten immer dieselbe Konfiguration haben wie die Ausgangskomponente.
PatternFeatureLiest oder setzt das steuernde Muster, nach dem das abgeleitete Muster die Ausgangskomponenten anordnet.
PropagateVisualPropertyLiest oder setzt, ob das abgeleitete Muster Darstellungseigenschaften wie Farben und Texturen auf die Instanzen überträgt.
SeedComponentArrayLiest oder setzt die Ausgangskomponenten des abgeleiteten Musters.
SeedPositionLiest oder setzt, welche Instanz des steuernden Musters als Ausgangsposition des abgeleiteten Musters dient.
SkippedItemArrayLiest oder setzt die Instanzen, die das abgeleitete Muster auslässt.

Methoden 5, davon 5 beschrieben

NameBeschreibung
AccessSelectionsSetzt das Modell vor das abgeleitete Muster zurück, damit du die Auswahlen lesen und ändern kannst, die es festlegen.
GetSeedComponentCountLiefert die Zahl der Ausgangskomponenten des abgeleiteten Musters.
GetSkippedItemCountLiefert, wie viele Instanzen das abgeleitete Muster auslässt.
GetTransformLiefert die Transformation einer Instanz des abgeleiteten Musters.
ReleaseSelectionAccessHebt den Rücksetz-Zustand nach AccessSelections wieder auf, wenn du das abgeleitete Muster nicht geändert hast.

Nicht aufgeführt sind 6 C++-Varianten (Namen mit I davor, zum Beispiel IAccessSelections). In VBA nimmst du immer den Befehl ohne I.

Siehe auch

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

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