SolidWorksMakroprogrammierung

Objekt · SldWorks

LocalCircularPatternFeatureData-Objekt

Die Feature-Daten eines kreisförmigen Komponentenmusters in einer Baugruppe: Achse, Zahl und Winkel der Instanzen, zweite Richtung, Ausgangskomponenten, ausgelassene und geänderte Instanzen.

Deklaration Dim x As SldWorks.LocalCircularPatternFeatureData · in der englischen .NET-Hilfe: ILocalCircularPatternFeatureData

Beschreibung

LocalCircularPatternFeatureData gibt Zugriff auf ein kreisförmiges Komponentenmuster in einer Baugruppe. Es vervielfältigt Komponenten um eine Achse, seit SOLIDWORKS 2020 auch in eine zweite Richtung. Das Gegenstück im Teil ist CircularPatternFeatureData, das Features, Flächen oder Körper mustert. Die meisten Befehle gibt es seit SOLIDWORKS 2001 SP02.

Zugriff

Beispiel

' Gibt Achse, Instanzen, Winkel und Ausgangskomponenten des ausgewählten
' kreisförmigen Komponentenmusters aus und erhöht die Zahl der Instanzen um eins.
' Vorbedingung: Eine Baugruppe ist offen, ein kreisförmiges Komponentenmuster 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.LocalCircularPatternFeatureData
    Dim swKompFeat As SldWorks.Feature
    Dim vAusgang As Variant
    Dim i As Long

    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 <> "LocalCirPattern" 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)"
    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
    vAusgang = swDaten.SeedComponentArray
    If Not IsEmpty(vAusgang) Then
        For i = 0 To UBound(vAusgang)
            Set swKompFeat = vAusgang(i)
            Debug.Print "Ausgangskomponente: " & swKompFeat.Name
        Next i
    End If

    swDaten.TotalInstances = swDaten.TotalInstances + 1
    If False = swFeat.ModifyDefinition(swDaten, swModel, Nothing) Then swDaten.ReleaseSelectionAccess
End Sub

Bemerkungen

Anlegen: Vor FeatureManager.CreateDefinition wählst du die Elemente aus. Mit ModelDocExtension.SelectByID2 markierst du die Komponenten mit 1 und die Achse mit 2. Die Hilfe nennt die Reihenfolge der Auswahl dabei wichtig, welche sie meint, sagt sie nicht. Wählst du direkt aus, setzt du die Markierung mit SelectData.Mark und wählst die Komponente mit Component2.Select3 aus, das heute veraltet ist (Nachfolger Component2.Select4). Danach musst du FeatureManager.CreateFeature aufrufen. Das Hilfebeispiel öffnet distance linkage.sldasm aus den Lernbeispielen, wählt eine Kante mit 2 und die Komponente „mount base-1“ mit 1 aus, setzt TotalInstances = 3 und EqualSpacing = True und legt so „LocalCirPattern1“ an. Es wählt zuerst die Kante und dann die Komponente aus.

Ändern: Hole die Daten mit Feature.GetDefinition, rufe LocalCircularPatternFeatureData.AccessSelections auf und übernimm Änderungen mit Feature.ModifyDefinition. Ohne Änderung hebst du den Zustand mit LocalCircularPatternFeatureData.ReleaseSelectionAccess auf. Ausgewählt wird das Muster mit dem Typ COMPPATTERN, so macht es das Hilfebeispiel „Change Dimension“.

Unterschied zum Kreismuster im Teil:

Winkel: LocalCircularPatternFeatureData.Spacing und LocalCircularPatternFeatureData.Spacing2 sind im Bogenmaß. Bei EqualSpacing schreibt die Hilfe aber, Spacing werde dann auf 360 Grad gesetzt. Vermutlich ist der volle Kreis gemeint, also 2π.

Nummern der Instanzen: LocalCircularPatternFeatureData.SkippedItemArray, LocalCircularPatternFeatureData.ModifyInstance und LocalCircularPatternFeatureData.GetModifiedInstance nehmen die Nummer I einer Instanz: in einer Richtung I = i - 1, in zwei Richtungen I = n2 * (i - 1) + (j - 1). Dabei ist i der Index in Richtung 1, j der Index in Richtung 2 und n2 die Zahl der Instanzen in Richtung 2. LocalCircularPatternFeatureData.GetTransform nimmt dagegen eine Nummer von 1 bis TotalInstances.

Hilfethema: Die Hilfe verweist auf die Themen „Pattern Features and their Feature Data Objects“ und „Accessing Selections that Define Features“.

Eigenschaften und Methoden

Eigenschaften 14, davon 14 beschrieben

NameBeschreibung
AxisLiest oder setzt die Achse, um die das kreisförmige Komponentenmuster läuft.
Direction2Liest oder setzt, ob das kreisförmige Komponentenmuster 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.
ForceUseSeedConfigurationLiest oder setzt, ob die gemusterten Komponenten immer dieselbe Konfiguration haben wie die Ausgangskomponente.
ReverseDirectionLiest oder setzt, ob die Richtung der Achse des kreisförmigen Komponentenmusters umgekehrt wird.
SeedComponentArrayLiest oder setzt die Ausgangskomponenten des kreisförmigen Komponentenmusters.
SkippedItemArrayLiest oder setzt die Nummern der Instanzen, die das kreisförmige Komponentenmuster 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ß.
SymmetricLiest oder setzt, ob das kreisförmige Komponentenmuster in Richtung 2 symmetrisch zu Richtung 1 ist.
SynchronizeFlexibleComponentsLiest oder setzt, ob die Bewegung flexibler Unterbaugruppen im kreisförmigen Komponentenmuster abgeglichen wird.
TotalInstancesLiest oder setzt die Zahl der Instanzen in Richtung 1.
TotalInstances2Liest oder setzt die Zahl der Instanzen in Richtung 2.

Methoden 9, davon 9 beschrieben

NameBeschreibung
AccessSelectionsSetzt das Modell vor das kreisförmige Komponentenmuster zurück, damit du die Auswahlen lesen und ändern kannst, die es festlegen.
GetAxisTypeLiefert, welche Art Element die Achse des kreisförmigen Komponentenmusters ist: Referenzachse, Kante oder Bemaßung.
GetModifiedInstanceLiefert Winkel und Versatz einer geänderten Instanz des kreisförmigen Komponentenmusters.
GetModifiedInstancesLiefert die Nummern aller geänderten Instanzen des kreisförmigen Komponentenmusters.
GetSeedComponentCountLiefert die Zahl der Ausgangskomponenten des kreisförmigen Komponentenmusters.
GetSkippedItemCountLiefert, wie viele Instanzen das kreisförmige Komponentenmuster auslässt.
GetTransformLiefert die Transformation einer Instanz des kreisförmigen Komponentenmusters.
ModifyInstanceGibt einer Instanz des kreisförmigen Komponentenmusters einen eigenen Winkel.
ReleaseSelectionAccessHebt den Rücksetz-Zustand nach AccessSelections wieder auf, wenn du das kreisförmige Komponentenmuster 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: ILocalCircularPatternFeatureData in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)

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