SolidWorksMakroprogrammierung

Objekt · SldWorks

CircularPatternFeatureData-Objekt

Die Feature-Daten eines Kreismusters: Achse, Zahl und Winkel der Instanzen, zweite Richtung, gemusterte Elemente und ausgelassene Instanzen.

Deklaration Dim x As SldWorks.CircularPatternFeatureData · in der englischen .NET-Hilfe: ICircularPatternFeatureData

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

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 Sub

Bemerkungen

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

NameBeschreibung
AutoSelectLiefert, ob das Kreismuster in einem Mehrkörperteil automatisch alle Körper beeinflusst, die es schneidet.
AxisLiest oder setzt das Element, das die Richtung des Kreismusters festlegt, etwa eine Achse oder Kante.
BodyPatternLiest oder setzt, ob das Kreismuster Körper und Tragwerke vervielfältigt oder Features und Flächen.
Direction2Liest oder setzt, ob das Kreismuster in zwei Richtungen angelegt wird.
EqualSpacingLiest oder setzt, ob die Instanzen in Richtung 1 gleichmäßig verteilt sind.
EqualSpacing2Liest oder setzt, ob die Instanzen in Richtung 2 gleichmäßig verteilt sind.
FeatureScopeLiefert, ob das Kreismuster in einem Mehrkörperteil nur bestimmte Körper beeinflusst.
FeatureScopeBodiesLiefert die Körper eines Mehrkörperteils, die das Kreismuster beeinflusst.
GeometryPatternLiest oder setzt, ob das Kreismuster nur die Geometrie (Flächen und Kanten) der Features vervielfältigt.
InstancesToVaryLiest oder setzt, ob der Abstand einzelner Instanzen des Kreismusters variiert werden kann.
PatternBodyArrayLiest oder setzt die Körper, die das Kreismuster in einem Mehrkörperteil vervielfältigt.
PatternElementLiest oder setzt, ob das Kreismuster Features und Flächen oder Körper vervielfältigt.
PatternFaceArrayLiest oder setzt die Flächen, die das Kreismuster vervielfältigt.
PatternFeatureArrayLiest oder setzt die Features, die das Kreismuster vervielfältigt (Ausgangsfeatures).
PropagateVisualPropertyLiest oder setzt, ob Farben, Texturen und Gewindedarstellungen auf alle Instanzen übertragen werden.
ReverseDirectionLiest oder setzt, ob die Richtung der Achse umgekehrt wird.
SkippedItemArrayLiest oder setzt die Nummern der Instanzen, die das Kreismuster auslässt.
SpacingLiest oder setzt den Winkel zwischen den Instanzen in Richtung 1, im Bogenmaß.
Spacing2Liest oder setzt den Winkel zwischen den Instanzen in Richtung 2, im Bogenmaß.
StructureSystemToPatternArrayLiest oder setzt die Tragwerke, die das Kreismuster vervielfältigt.
SymmetricLiest oder setzt, ob das Kreismuster in Richtung 2 symmetrisch zu Richtung 1 ist.
TotalInstancesLiest oder setzt die Zahl der Instanzen in Richtung 1.
TotalInstances2Liest oder setzt die Zahl der Instanzen in Richtung 2.
VarySketchLiest oder setzt, ob sich die Instanzen einer Ausgangsskizze an die umgebende Geometrie anpassen dürfen.

Methoden 11, davon 11 beschrieben

NameBeschreibung
AccessSelectionsSetzt das Modell vor das Kreismuster zurück, damit du die Auswahlen lesen und ändern kannst, die es festlegen.
GetAxisTypeLiefert, welche Art Element die Richtung des Kreismusters festlegt: Achse, Kante, Bemaßung oder Skizzenlinie.
GetInstanceToVaryOptionsLiefert die Optionen, mit denen du den Abstand einzelner Instanzen variierst.
GetPatternBodyCountLiefert die Zahl der Körper, die das Kreismuster vervielfältigt.
GetPatternFaceCountLiefert die Zahl der Flächen, die das Kreismuster vervielfältigt.
GetPatternFeatureCountLiefert die Zahl der Features, die das Kreismuster vervielfältigt.
GetSkippedItemCountLiefert, wie viele Instanzen das Kreismuster auslässt.
GetTransformLiefert die Transformation einer Instanz des Kreismusters.
ReleaseSelectionAccessHebt den Rücksetz-Zustand nach AccessSelections wieder auf, wenn du das Kreismuster nicht geändert hast.
SetFeatureScopeLegt fest, welche Körper eines Mehrkörperteils das Kreismuster beeinflusst.
SetInstanceToVaryOptionsGibt 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.