SolidWorksMakroprogrammierung

Objekt · SldWorks

FillPatternFeatureData-Objekt

Die Feature-Daten eines Füllmusters: Füllbegrenzung, Anordnung und Abstand der Instanzen, gemusterte Elemente oder Ausgangsschnitt, Rand, Richtung und ausgelassene Instanzen.

Deklaration Dim x As SldWorks.FillPatternFeatureData · in der englischen .NET-Hilfe: IFillPatternFeatureData

Beschreibung

FillPatternFeatureData gibt Zugriff auf ein Füllmuster. Ein Füllmuster füllt eine Begrenzung, etwa eine Fläche oder Skizze, mit Instanzen. Es vervielfältigt ausgewählte Features, Flächen oder Körper oder einen Ausgangsschnitt, den es selbst erzeugt: Kreis, Quadrat, Raute oder Vieleck. Die Instanzen liegen als Perforation in versetzten Reihen oder in konzentrischen Ringen (Kreis, Quadrat, Vieleck) um die Ausgangsinstanz. Die Befehle gibt es seit SOLIDWORKS 2014, PatternElement seit SOLIDWORKS 2015.

Zugriff

Beispiel

' Gibt Anordnung, Abstand und gemusterte Elemente des ausgewählten Füllmusters aus
' und setzt den Rand zur Füllbegrenzung auf 2 mm.
' Vorbedingung: Ein Teil ist offen, ein Füllmuster ist im FeatureManager ausgewählt.
' Ergebnis:     Die Werte stehen im Direktfenster (Strg+G), das Muster hat den neuen Rand.
Option Explicit

Sub main()
    Const PI As Double = 3.14159265358979
    Dim swApp As SldWorks.SldWorks
    Dim swModel As SldWorks.ModelDoc2
    Dim swSel As Object
    Dim swFeat As SldWorks.Feature
    Dim swDaten As SldWorks.FillPatternFeatureData

    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 <> "APattern" Then Exit Sub

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

    Select Case swDaten.PatternLayoutType
        Case swPatternLayoutPerforation
            Debug.Print "Perforation, Abstand " & swDaten.InstanceSpacing * 1000 & " mm, Versatz " & _
                        Round(swDaten.StaggerAngle * 180 / PI, 2) & "°"
        Case Else
            Debug.Print "Ringe (Anordnung " & swDaten.PatternLayoutType & "), Ringabstand " & _
                        swDaten.LoopSpacing * 1000 & " mm"
            If swDaten.LayoutSpacingType = swPatternLayoutInstances Then
                Debug.Print "  " & swDaten.NoOfInstances & " Instanzen je Ring oder Seite"
            Else
                Debug.Print "  Abstand der Instanzen " & swDaten.InstanceSpacing * 1000 & " mm"
            End If
    End Select

    If swDaten.FeaturesToPatternType = swFeaturesToPatternCreateSeedCut Then
        Debug.Print "Ausgangsschnitt, Form " & swDaten.CreateSeedCutType & " (swCreateSeedCutType_e)"
    Else
        Debug.Print "Ausgewählte Elemente, Art " & swDaten.PatternElement & " (swPatternElementSelection_e)"
    End If
    Debug.Print "Rand bisher: " & swDaten.Margins * 1000 & " mm"

    swDaten.Margins = 0.002
    If False = swFeat.ModifyDefinition(swDaten, swModel, Nothing) Then
        swDaten.ReleaseSelectionAccess
        Debug.Print "Nicht geändert"
    End If
End Sub

Bemerkungen

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

  • 16384 für die Füllbegrenzung: eine Skizze, eine Fläche, eine ebene Kurve auf einer Fläche oder koplanare Flächen
  • 1 für die Richtung, etwa eine Kante oder Achse. Ohne sie wählt SOLIDWORKS eine passende Richtung für die Anordnung.
  • 3 für einen Eckpunkt oder Skizzenpunkt, an dem die Ausgangsinstanz liegt. Ohne ihn liegt sie in der Mitte der Füllbegrenzung.
  • 4 für Features, 5 für Flächen und 6 für Körper, die gemustert werden

Danach setzt du die Eigenschaften, mindestens FillPatternFeatureData.PatternLayoutType, FillPatternFeatureData.LayoutSpacingType, FillPatternFeatureData.FeaturesToPatternType, FillPatternFeatureData.GeometryPattern und, außer bei der Perforation, FillPatternFeatureData.LoopSpacing. Je nach diesen Werten kommen weitere dazu. Zum Schluss rufst du FeatureManager.CreateFeature auf. So legt das Beispiel auf der Hilfeseite des Objekts an einem Teil mit einer Bohrung ein Füllmuster an: Es wählt die Bohrung mit Markierung 4, eine Kante mit 1 und eine Fläche mit 16384 aus.

Markierungen: Die Markierungen 5 und 6 für Flächen und Körper weichen von den anderen Mustern ab. Beim linearen Muster nimmst du 4 für Features oder Flächen und 256 für Körper. Das veraltete FeatureManager.FeatureFillPattern nennt außerdem 1 für die Füllbegrenzung und 2 für die Richtung. Welche Werte stimmen, lässt sich nur in SOLIDWORKS prüfen. Das Hilfebeispiel nutzt die Werte von oben.

Ändern: Rufe erst FillPatternFeatureData.AccessSelections auf und übernimm Änderungen mit Feature.ModifyDefinition. Ohne Änderung hebst du den Zustand mit FillPatternFeatureData.ReleaseSelectionAccess auf.

Gültige Eigenschaften: Viele Eigenschaften gelten nur bei bestimmten Einstellungen:

Einheiten: Die Hilfe nennt für keine Länge und keinen Winkel eine Einheit. Das Hilfebeispiel setzt Durchmesser und Diagonale auf 0.008 und den Versatzwinkel auf 1.0471975511966. Längen sind deshalb vermutlich in Meter, Winkel im Bogenmaß (1.047 entspricht 60°).

Hilfethema: Die Hilfe verweist auf das Thema „Pattern Features and their Feature Data Objects“ und für Einzelheiten auf den PropertyManager „Fill Pattern“ in der Hilfe zur Oberfläche.

Konstanten: swFmFillPattern stammt aus swFeatureNameID_e, swPatternLayoutPerforation aus swPatternLayoutType_e, swPatternLayoutInstances aus swPatternLayoutSpacingType_e.

Ein Füllmuster ließ sich wie im Hilfebeispiel „Create Fill Pattern“ mit FeatureManager.CreateDefinition und FeatureManager.CreateFeature nicht anlegen: CreateFeature liefert Nothing, mit Bohrung als Ausgangs-Feature ebenso wie mit Ausgangsschnitt.

Eigenschaften und Methoden

Eigenschaften 33, davon 33 beschrieben

NameBeschreibung
AutoSelectLiest oder setzt, ob das Füllmuster in einem Mehrkörperteil automatisch alle Körper beeinflusst oder nur bestimmte.
CreateSeedCutPolygonSidesLiest oder setzt die Zahl der Ecken eines vieleckigen Ausgangsschnitts.
CreateSeedCutTypeLiest oder setzt die Form des Ausgangsschnitts, den das Füllmuster selbst erzeugt: Kreis, Quadrat, Raute oder Vieleck.
DiagonalLiest oder setzt die Länge der Diagonale eines rautenförmigen Ausgangsschnitts.
DiameterLiest oder setzt den Durchmesser eines kreisförmigen Ausgangsschnitts.
DimensionLiest oder setzt die Seitenlänge eines quadratischen oder rautenförmigen Ausgangsschnitts.
FeatureScopeLiest oder setzt, ob das Füllmuster in einem Mehrkörperteil nur bestimmte Körper beeinflusst.
FeatureScopeBodiesLiest oder setzt die Volumenkörper eines Mehrkörperteils, die das Füllmuster beeinflusst.
FeaturesToPatternTypeLiest oder setzt, ob das Füllmuster ausgewählte Features, Flächen oder Körper vervielfältigt oder einen Ausgangsschnitt, den es selbst erzeugt.
GeometryPatternLiest oder setzt, ob das Füllmuster die Ausgangsfeatures genau kopiert (Geometriemuster) oder jede Instanz einzeln löst.
InnerRadiusLiest oder setzt den Radius des Innenkreises eines vieleckigen Ausgangsschnitts.
InstanceSpacingLiest oder setzt den Abstand zwischen den Mittelpunkten der Instanzen im Füllmuster.
LayoutSpacingTypeLiest oder setzt, ob das Füllmuster bei den Ringen den Abstand der Instanzen oder ihre Anzahl je Ring vorgibt.
LoopSpacingLiest oder setzt den Abstand zwischen den Ringen der Instanzen im Füllmuster.
MarginsLiest oder setzt den Abstand zwischen der Füllbegrenzung und den äußersten Instanzen des Füllmusters.
NoOfInstancesLiest oder setzt die Zahl der Instanzen je Ring oder Seite im Füllmuster.
OuterRadiusLiest oder setzt den Radius des Umkreises eines vieleckigen Ausgangsschnitts.
PatternBodyArrayLiest oder setzt die Körper, die das Füllmuster vervielfältigt.
PatternDirectionLiest oder setzt das Element, das die Richtung der Anordnung des Füllmusters festlegt, etwa eine Kante oder Achse.
PatternDirectionTypeLiefert die Art des Elements, das PatternDirection als Richtung des Füllmusters liefert.
PatternElementLiest oder setzt, ob das Füllmuster Features und Flächen oder Körper vervielfältigt.
PatternFaceArrayLiest oder setzt die Flächen, die das Füllmuster vervielfältigt.
PatternFeatureArrayLiest oder setzt die Features, die das Füllmuster vervielfältigt (Ausgangsfeatures).
PatternFillBoundaryArrayLiest oder setzt die Elemente, die die Füllbegrenzung des Füllmusters bilden.
PatternLayoutPolygonSidesLiest oder setzt die Zahl der Seiten der vieleckigen Anordnung des Füllmusters.
PatternLayoutTypeLiest oder setzt die Anordnung der Instanzen in der Füllbegrenzung: Perforation, Kreis, Quadrat oder Vieleck.
PropagateVisualPropertyLiest oder setzt, ob Farben, Texturen und Gewindedarstellungen auf alle Instanzen des Füllmusters übertragen werden.
RotationLiest oder setzt den Drehwinkel eines quadratischen, rautenförmigen oder vieleckigen Ausgangsschnitts gegen den Uhrzeigersinn.
SeedCutFlipShapeDirectionLiest oder setzt, ob die Richtung des Ausgangsschnitts umgekehrt wird.
SeedFeatureCenterLiest oder setzt den Eckpunkt oder Skizzenpunkt, an dem die Mitte des Ausgangsschnitts liegt.
SeedFeatureCenterTypeLiefert die Art des Punkts, an dem die Mitte des Ausgangsschnitts liegt.
SkippedItemArrayLiest oder setzt die Instanzen, die das Füllmuster auslässt.
StaggerAngleLiest oder setzt den Winkel, um den die Reihen der Instanzen bei der Perforation versetzt sind.

Methoden 2, davon 2 beschrieben

NameBeschreibung
AccessSelectionsSetzt das Modell vor das Füllmuster zurück, damit du die Auswahlen lesen und ändern kannst, die es festlegen.
ReleaseSelectionAccessHebt den Rücksetz-Zustand nach AccessSelections wieder auf, wenn du das Füllmuster nicht geändert hast.

Siehe auch

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

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