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.
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
FeatureManager.CreateDefinitionmitswFmFillPattern: Daten für ein neues Füllmuster, das du mitFeatureManager.CreateFeatureanlegstFeature.GetDefinition: aus einem vorhandenen Füllmuster (TypnameAPattern)
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 SubBemerkungen
Anlegen: Vor FeatureManager.CreateDefinition wählst du die Elemente mit ModelDocExtension.SelectByID2 und diesen Markierungen aus:
16384für die Füllbegrenzung: eine Skizze, eine Fläche, eine ebene Kurve auf einer Fläche oder koplanare Flächen1für die Richtung, etwa eine Kante oder Achse. Ohne sie wählt SOLIDWORKS eine passende Richtung für die Anordnung.3für einen Eckpunkt oder Skizzenpunkt, an dem die Ausgangsinstanz liegt. Ohne ihn liegt sie in der Mitte der Füllbegrenzung.4für Features,5für Flächen und6fü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:
- Bei
swFeaturesToPatternCreateSeedCutausswFeaturesToPatternType_egelten die Maße des Ausgangsschnitts, je nach Form ausswCreateSeedCutType_e. BeiswFeaturesToPatternSelectedFeaturesgelten die Arrays der gemusterten Elemente. - Bei der Perforation gelten
FillPatternFeatureData.InstanceSpacingundFillPatternFeatureData.StaggerAngle. Bei den Ringen geltenFillPatternFeatureData.LoopSpacingund, je nachFillPatternFeatureData.LayoutSpacingType, der Abstand oder die Anzahl. FillPatternFeatureData.FeatureScope,FillPatternFeatureData.AutoSelectundFillPatternFeatureData.FeatureScopeBodiesgelten nur, wennFillPatternFeatureData.GeometryPatternTrueist.
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
| Name | Beschreibung |
|---|---|
| AutoSelect | Liest oder setzt, ob das Füllmuster in einem Mehrkörperteil automatisch alle Körper beeinflusst oder nur bestimmte. |
| CreateSeedCutPolygonSides | Liest oder setzt die Zahl der Ecken eines vieleckigen Ausgangsschnitts. |
| CreateSeedCutType | Liest oder setzt die Form des Ausgangsschnitts, den das Füllmuster selbst erzeugt: Kreis, Quadrat, Raute oder Vieleck. |
| Diagonal | Liest oder setzt die Länge der Diagonale eines rautenförmigen Ausgangsschnitts. |
| Diameter | Liest oder setzt den Durchmesser eines kreisförmigen Ausgangsschnitts. |
| Dimension | Liest oder setzt die Seitenlänge eines quadratischen oder rautenförmigen Ausgangsschnitts. |
| FeatureScope | Liest oder setzt, ob das Füllmuster in einem Mehrkörperteil nur bestimmte Körper beeinflusst. |
| FeatureScopeBodies | Liest oder setzt die Volumenkörper eines Mehrkörperteils, die das Füllmuster beeinflusst. |
| FeaturesToPatternType | Liest oder setzt, ob das Füllmuster ausgewählte Features, Flächen oder Körper vervielfältigt oder einen Ausgangsschnitt, den es selbst erzeugt. |
| GeometryPattern | Liest oder setzt, ob das Füllmuster die Ausgangsfeatures genau kopiert (Geometriemuster) oder jede Instanz einzeln löst. |
| InnerRadius | Liest oder setzt den Radius des Innenkreises eines vieleckigen Ausgangsschnitts. |
| InstanceSpacing | Liest oder setzt den Abstand zwischen den Mittelpunkten der Instanzen im Füllmuster. |
| LayoutSpacingType | Liest oder setzt, ob das Füllmuster bei den Ringen den Abstand der Instanzen oder ihre Anzahl je Ring vorgibt. |
| LoopSpacing | Liest oder setzt den Abstand zwischen den Ringen der Instanzen im Füllmuster. |
| Margins | Liest oder setzt den Abstand zwischen der Füllbegrenzung und den äußersten Instanzen des Füllmusters. |
| NoOfInstances | Liest oder setzt die Zahl der Instanzen je Ring oder Seite im Füllmuster. |
| OuterRadius | Liest oder setzt den Radius des Umkreises eines vieleckigen Ausgangsschnitts. |
| PatternBodyArray | Liest oder setzt die Körper, die das Füllmuster vervielfältigt. |
| PatternDirection | Liest oder setzt das Element, das die Richtung der Anordnung des Füllmusters festlegt, etwa eine Kante oder Achse. |
| PatternDirectionType | Liefert die Art des Elements, das PatternDirection als Richtung des Füllmusters liefert. |
| PatternElement | Liest oder setzt, ob das Füllmuster Features und Flächen oder Körper vervielfältigt. |
| PatternFaceArray | Liest oder setzt die Flächen, die das Füllmuster vervielfältigt. |
| PatternFeatureArray | Liest oder setzt die Features, die das Füllmuster vervielfältigt (Ausgangsfeatures). |
| PatternFillBoundaryArray | Liest oder setzt die Elemente, die die Füllbegrenzung des Füllmusters bilden. |
| PatternLayoutPolygonSides | Liest oder setzt die Zahl der Seiten der vieleckigen Anordnung des Füllmusters. |
| PatternLayoutType | Liest oder setzt die Anordnung der Instanzen in der Füllbegrenzung: Perforation, Kreis, Quadrat oder Vieleck. |
| PropagateVisualProperty | Liest oder setzt, ob Farben, Texturen und Gewindedarstellungen auf alle Instanzen des Füllmusters übertragen werden. |
| Rotation | Liest oder setzt den Drehwinkel eines quadratischen, rautenförmigen oder vieleckigen Ausgangsschnitts gegen den Uhrzeigersinn. |
| SeedCutFlipShapeDirection | Liest oder setzt, ob die Richtung des Ausgangsschnitts umgekehrt wird. |
| SeedFeatureCenter | Liest oder setzt den Eckpunkt oder Skizzenpunkt, an dem die Mitte des Ausgangsschnitts liegt. |
| SeedFeatureCenterType | Liefert die Art des Punkts, an dem die Mitte des Ausgangsschnitts liegt. |
| SkippedItemArray | Liest oder setzt die Instanzen, die das Füllmuster auslässt. |
| StaggerAngle | Liest oder setzt den Winkel, um den die Reihen der Instanzen bei der Perforation versetzt sind. |
Methoden 2, davon 2 beschrieben
| Name | Beschreibung |
|---|---|
| AccessSelections | Setzt das Modell vor das Füllmuster zurück, damit du die Auswahlen lesen und ändern kannst, die es festlegen. |
| ReleaseSelectionAccess | Hebt 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.