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.
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
FeatureManager.CreateDefinitionmitswFmLocalCirPattern: Daten für ein neues kreisförmiges Komponentenmuster, das du mitFeatureManager.CreateFeatureanlegstFeature.GetDefinition: aus einem vorhandenen kreisförmigen Komponentenmuster (TypnameLocalCirPattern)
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 SubBemerkungen
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:
- Gemustert werden Komponenten (
LocalCircularPatternFeatureData.SeedComponentArray), nicht Features, Flächen oder Körper. - Beim Anlegen hat die Achse die Markierung
2und die Komponenten1. BeiCircularPatternFeatureDatahat die Achse1und die Features4. LocalCircularPatternFeatureData.GetAxisTypekennt nur Referenzachse, Kante und Bemaßung, keine Skizzenlinie.- Einzelne Instanzen änderst du mit
LocalCircularPatternFeatureData.ModifyInstance, im Teil überCircularPatternFeatureData.InstancesToVary. - Dazu kommen
LocalCircularPatternFeatureData.ForceUseSeedConfigurationundLocalCircularPatternFeatureData.SynchronizeFlexibleComponents. - Typname
LocalCirPatternstattCirPattern, KonstanteswFmLocalCirPatternstattswFmCirPattern.
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
| Name | Beschreibung |
|---|---|
| Axis | Liest oder setzt die Achse, um die das kreisförmige Komponentenmuster läuft. |
| Direction2 | Liest oder setzt, ob das kreisförmige Komponentenmuster 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. |
| ForceUseSeedConfiguration | Liest oder setzt, ob die gemusterten Komponenten immer dieselbe Konfiguration haben wie die Ausgangskomponente. |
| ReverseDirection | Liest oder setzt, ob die Richtung der Achse des kreisförmigen Komponentenmusters umgekehrt wird. |
| SeedComponentArray | Liest oder setzt die Ausgangskomponenten des kreisförmigen Komponentenmusters. |
| SkippedItemArray | Liest oder setzt die Nummern der Instanzen, die das kreisförmige Komponentenmuster 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ß. |
| Symmetric | Liest oder setzt, ob das kreisförmige Komponentenmuster in Richtung 2 symmetrisch zu Richtung 1 ist. |
| SynchronizeFlexibleComponents | Liest oder setzt, ob die Bewegung flexibler Unterbaugruppen im kreisförmigen Komponentenmuster abgeglichen wird. |
| TotalInstances | Liest oder setzt die Zahl der Instanzen in Richtung 1. |
| TotalInstances2 | Liest oder setzt die Zahl der Instanzen in Richtung 2. |
Methoden 9, davon 9 beschrieben
| Name | Beschreibung |
|---|---|
| AccessSelections | Setzt das Modell vor das kreisförmige Komponentenmuster zurück, damit du die Auswahlen lesen und ändern kannst, die es festlegen. |
| GetAxisType | Liefert, welche Art Element die Achse des kreisförmigen Komponentenmusters ist: Referenzachse, Kante oder Bemaßung. |
| GetModifiedInstance | Liefert Winkel und Versatz einer geänderten Instanz des kreisförmigen Komponentenmusters. |
| GetModifiedInstances | Liefert die Nummern aller geänderten Instanzen des kreisförmigen Komponentenmusters. |
| GetSeedComponentCount | Liefert die Zahl der Ausgangskomponenten des kreisförmigen Komponentenmusters. |
| GetSkippedItemCount | Liefert, wie viele Instanzen das kreisförmige Komponentenmuster auslässt. |
| GetTransform | Liefert die Transformation einer Instanz des kreisförmigen Komponentenmusters. |
| ModifyInstance | Gibt einer Instanz des kreisförmigen Komponentenmusters einen eigenen Winkel. |
| ReleaseSelectionAccess | Hebt 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.