Objekt · SldWorks
CircularPatternFeatureData-Objekt
Die Feature-Daten eines Kreismusters: Achse, Zahl und Winkel der Instanzen, zweite Richtung, gemusterte Elemente und ausgelassene Instanzen.
Beschreibung
CircularPatternFeatureData gibt Zugriff auf ein Kreismuster. Ein Kreismuster vervielfältigt Features, Flächen oder Körper um eine Achse. Seit SOLIDWORKS 2017 kann es zusätzlich in eine zweite Richtung gehen. Du liest die Daten mit Feature.GetDefinition und übernimmst Änderungen mit Feature.ModifyDefinition.
Zugriff
FeatureManager.CreateDefinitionmitswFmCirPattern: Daten für ein neues Kreismuster, das du mitFeatureManager.CreateFeatureanlegstFeature.GetDefinition: aus einem vorhandenen Kreismuster (TypnameCirPattern)
Beispiel
' Gibt Achse, Instanzen und Winkel des ausgewählten Kreismusters aus
' und erhöht die Zahl der Instanzen in Richtung 1 um eins.
' Vorbedingung: Ein Teil ist offen, ein Kreismuster ist im FeatureManager ausgewählt.
' Ergebnis: Die Werte stehen im Direktfenster, das Muster hat eine Instanz mehr.
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.CircularPatternFeatureData
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 <> "CirPattern" Then Exit Sub
Set swDaten = swFeat.GetDefinition
If False = swDaten.AccessSelections(swModel, Nothing) Then Exit Sub
Debug.Print "Art der Achse: " & swDaten.GetAxisType & " (0 Achse, 1 Kante, 2 Bemaßung, 3 Skizzenlinie)"
Debug.Print "Richtung 1: " & swDaten.TotalInstances & " Instanzen, Winkel " & _
Round(swDaten.Spacing * 180 / PI, 2) & "°, gleicher Abstand: " & swDaten.EqualSpacing
If swDaten.Direction2 Then Debug.Print "Richtung 2, symmetrisch: " & swDaten.Symmetric
If swDaten.BodyPattern Then
Debug.Print "Gemustert werden " & swDaten.GetPatternBodyCount & " Körper"
Else
Debug.Print "Gemustert werden " & swDaten.GetPatternFeatureCount & " Features und " & _
swDaten.GetPatternFaceCount & " Flächen"
End If
swDaten.TotalInstances = swDaten.TotalInstances + 1
If False = swFeat.ModifyDefinition(swDaten, swModel, Nothing) Then Debug.Print "Nicht geändert"
End SubBemerkungen
Anlegen: Vor FeatureManager.CreateDefinition wählst du die Elemente mit ModelDocExtension.SelectByID2 und diesen Markierungen aus: 1 für die Achse, 4 für die Features, 256 für die Körper und 134217728 für die Tragwerke. Danach rufst du FeatureManager.CreateFeature auf. So legt das Hilfebeispiel „Create Bidirectional Circular Pattern Feature“ ein Kreismuster an.
Ändern: Du rufst erst CircularPatternFeatureData.AccessSelections auf und übernimmst Änderungen mit Feature.ModifyDefinition. Ohne Änderung hebst du den Zustand mit CircularPatternFeatureData.ReleaseSelectionAccess auf. Ohne AccessSelections liefert CircularPatternFeatureData.Axis Nothing.
Nach dem Anlegen: Nach dem Anlegen kannst du den Abstand einzelner Instanzen variieren (CircularPatternFeatureData.InstancesToVary) und die gemusterten Tragwerke ändern.
Winkel: CircularPatternFeatureData.Spacing und CircularPatternFeatureData.Spacing2 sind im Bogenmaß.
Hilfethema: Die Hilfe verweist auf das Thema „Pattern Features and their Feature Data Objects“.
Direkt nach FeatureManager.CreateFeature und nach Feature.ModifyDefinition hat das Teil noch die alte Geometrie. Erst nach ModelDoc2.ForceRebuild3 stimmt das Ergebnis, etwa das Volumen.
Eigenschaften und Methoden
Eigenschaften 24, davon 24 beschrieben
| Name | Beschreibung |
|---|---|
| AutoSelect | Liefert, ob das Kreismuster in einem Mehrkörperteil automatisch alle Körper beeinflusst, die es schneidet. |
| Axis | Liest oder setzt das Element, das die Richtung des Kreismusters festlegt, etwa eine Achse oder Kante. |
| BodyPattern | Liest oder setzt, ob das Kreismuster Körper und Tragwerke vervielfältigt oder Features und Flächen. |
| Direction2 | Liest oder setzt, ob das Kreismuster in zwei Richtungen angelegt wird. |
| EqualSpacing | Liest oder setzt, ob die Instanzen in Richtung 1 gleichmäßig verteilt sind. |
| EqualSpacing2 | Liest oder setzt, ob die Instanzen in Richtung 2 gleichmäßig verteilt sind. |
| FeatureScope | Liefert, ob das Kreismuster in einem Mehrkörperteil nur bestimmte Körper beeinflusst. |
| FeatureScopeBodies | Liefert die Körper eines Mehrkörperteils, die das Kreismuster beeinflusst. |
| GeometryPattern | Liest oder setzt, ob das Kreismuster nur die Geometrie (Flächen und Kanten) der Features vervielfältigt. |
| InstancesToVary | Liest oder setzt, ob der Abstand einzelner Instanzen des Kreismusters variiert werden kann. |
| PatternBodyArray | Liest oder setzt die Körper, die das Kreismuster in einem Mehrkörperteil vervielfältigt. |
| PatternElement | Liest oder setzt, ob das Kreismuster Features und Flächen oder Körper vervielfältigt. |
| PatternFaceArray | Liest oder setzt die Flächen, die das Kreismuster vervielfältigt. |
| PatternFeatureArray | Liest oder setzt die Features, die das Kreismuster vervielfältigt (Ausgangsfeatures). |
| PropagateVisualProperty | Liest oder setzt, ob Farben, Texturen und Gewindedarstellungen auf alle Instanzen übertragen werden. |
| ReverseDirection | Liest oder setzt, ob die Richtung der Achse umgekehrt wird. |
| SkippedItemArray | Liest oder setzt die Nummern der Instanzen, die das Kreismuster auslässt. |
| Spacing | Liest oder setzt den Winkel zwischen den Instanzen in Richtung 1, im Bogenmaß. |
| Spacing2 | Liest oder setzt den Winkel zwischen den Instanzen in Richtung 2, im Bogenmaß. |
| StructureSystemToPatternArray | Liest oder setzt die Tragwerke, die das Kreismuster vervielfältigt. |
| Symmetric | Liest oder setzt, ob das Kreismuster in Richtung 2 symmetrisch zu Richtung 1 ist. |
| TotalInstances | Liest oder setzt die Zahl der Instanzen in Richtung 1. |
| TotalInstances2 | Liest oder setzt die Zahl der Instanzen in Richtung 2. |
| VarySketch | Liest oder setzt, ob sich die Instanzen einer Ausgangsskizze an die umgebende Geometrie anpassen dürfen. |
Methoden 11, davon 11 beschrieben
| Name | Beschreibung |
|---|---|
| AccessSelections | Setzt das Modell vor das Kreismuster zurück, damit du die Auswahlen lesen und ändern kannst, die es festlegen. |
| GetAxisType | Liefert, welche Art Element die Richtung des Kreismusters festlegt: Achse, Kante, Bemaßung oder Skizzenlinie. |
| GetInstanceToVaryOptions | Liefert die Optionen, mit denen du den Abstand einzelner Instanzen variierst. |
| GetPatternBodyCount | Liefert die Zahl der Körper, die das Kreismuster vervielfältigt. |
| GetPatternFaceCount | Liefert die Zahl der Flächen, die das Kreismuster vervielfältigt. |
| GetPatternFeatureCount | Liefert die Zahl der Features, die das Kreismuster vervielfältigt. |
| GetSkippedItemCount | Liefert, wie viele Instanzen das Kreismuster auslässt. |
| GetTransform | Liefert die Transformation einer Instanz des Kreismusters. |
| ReleaseSelectionAccess | Hebt den Rücksetz-Zustand nach AccessSelections wieder auf, wenn du das Kreismuster nicht geändert hast. |
| SetFeatureScope | Legt fest, welche Körper eines Mehrkörperteils das Kreismuster beeinflusst. |
| SetInstanceToVaryOptions | Gibt die geänderten Optionen zum Variieren einzelner Instanzen an das Kreismuster zurück. |
Nicht aufgeführt sind 10 C++-Varianten (Namen mit I davor, zum Beispiel IAccessSelections). In VBA nimmst du immer den Befehl ohne I.
Siehe auch
Englisches Original: ICircularPatternFeatureData in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)
Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.