Objekt · SldWorks
LocalLinearPatternFeatureData-Objekt
Die Feature-Daten eines linearen Komponentenmusters in einer Baugruppe: Ausgangskomponenten, Richtung 1 und 2, Abstand und Zahl der Instanzen, Bis Referenz, Drehen und ausgelassene Instanzen.
Beschreibung
LocalLinearPatternFeatureData gibt Zugriff auf ein lineares Komponentenmuster in einer Baugruppe. Es vervielfältigt Komponenten (die Ausgangskomponenten) entlang einer oder zwei Richtungen. Das Gegenstück im Teil ist LinearPatternFeatureData. Je Richtung gibst du entweder Abstand und Zahl der Instanzen an oder lässt das Muster bis zu einer Referenz laufen (LocalLinearPatternFeatureData.D1EndCondition). Die Grundbefehle gibt es seit SOLIDWORKS 2001 SP02. Bis Referenz und das Drehen der Instanzen kamen mit SOLIDWORKS 2020, das Ändern einzelner Instanzen mit SOLIDWORKS 2021.
Zugriff
FeatureManager.CreateDefinitionmitswFmLocalLPattern: Daten für ein neues lineares Komponentenmuster, das du mitFeatureManager.CreateFeatureanlegstFeature.GetDefinition: aus einem vorhandenen linearen Komponentenmuster (TypnameLocalLPattern)
Beispiel
' Gibt Ausgangskomponenten, Richtung 1 und Richtung 2 des ausgewählten linearen
' Komponentenmusters aus und erhöht die Zahl der Instanzen in Richtung 1 um eins.
' Vorbedingung: Eine Baugruppe ist offen, ein lineares Komponentenmuster ist im
' FeatureManager ausgewählt.
' Ergebnis: Die Werte stehen im Direktfenster, das Muster hat eine Instanz mehr.
Option Explicit
Sub main()
Dim swApp As SldWorks.SldWorks
Dim swModel As SldWorks.ModelDoc2
Dim swSel As Object
Dim swFeat As SldWorks.Feature
Dim swDaten As SldWorks.LocalLinearPatternFeatureData
Dim swAusgang 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
If swModel.GetType <> swDocASSEMBLY 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 <> "LocalLPattern" Then Exit Sub
Set swDaten = swFeat.GetDefinition
If False = swDaten.AccessSelections(swModel, Nothing) Then Exit Sub
vAusgang = swDaten.SeedComponentArray
If IsArray(vAusgang) Then
For i = 0 To UBound(vAusgang)
Set swAusgang = vAusgang(i)
Debug.Print "Ausgangskomponente: " & swAusgang.Name
Next i
End If
Debug.Print "Richtung 1: " & swDaten.D1TotalInstances & " Instanzen, Abstand " & _
swDaten.D1Spacing * 1000 & " mm"
Debug.Print "Richtung 2: " & swDaten.D2TotalInstances & " Instanzen, Abstand " & _
swDaten.D2Spacing * 1000 & " mm"
Debug.Print "Ausgelassen: " & swDaten.GetSkippedItemCount & " Instanzen"
If swDaten.D1EndCondition = swPatternEndCondition_SpacingAndInstances Then
swDaten.D1TotalInstances = swDaten.D1TotalInstances + 1
If False = swFeat.ModifyDefinition(swDaten, swModel, Nothing) Then swDaten.ReleaseSelectionAccess
Else
swDaten.ReleaseSelectionAccess
End If
End SubBemerkungen
Anlegen: Vor FeatureManager.CreateDefinition wählst du die Elemente aus. Mit ModelDocExtension.SelectByID2 nimmst du diese Markierungen:
- Komponenten, die gemustert werden:
1 - Richtung 1:
2, Richtung 2:4 - Referenz für Bis Referenz in Richtung 1:
256, Ausgangsreferenz dazu:512 - Referenz für Bis Referenz in Richtung 2:
1024, Ausgangsreferenz dazu:2048
Direkt ausgewählt nimmst du dieselben Werte mit Entity.Select4 bzw. Component2.Select4 und SelectData.Mark. Danach kannst du die Daten weiter einstellen und rufst FeatureManager.CreateFeature auf. So legt das Hilfebeispiel zu LocalLinearPatternFeatureData ein Muster an: eine Kante mit der Markierung 2, eine Komponente mit 1, dann Abstand und Zahl je Richtung. Die Hilfe nennt in derselben Tabelle für Körper zusätzlich 1 für Richtung 1 und 256 für die Körper. Was Körper in einem Komponentenmuster bedeuten, sagt sie nicht.
Ändern: Rufe erst LocalLinearPatternFeatureData.AccessSelections auf und übernimm Änderungen mit Feature.ModifyDefinition. Ohne Änderung hebst du den Zustand mit LocalLinearPatternFeatureData.ReleaseSelectionAccess auf.
Elemente zuweisen: Richtungen, Referenzen und die Drehachse sind Objekt-Eigenschaften. Wie du ihnen ein Element zuweist, mit oder ohne Set, zeigt die Hilfe nicht. Die Beispiele hier lesen sie nur. Die Ausgangskomponenten weist das Hilfebeispiel „Get and Set Seed Components“ als Array ohne Set zu.
Einheiten: LocalLinearPatternFeatureData.D1Spacing und LocalLinearPatternFeatureData.D2Spacing sind in Meter und LocalLinearPatternFeatureData.RotationAngle im Bogenmaß. Für die Versätze bei Bis Referenz und die Abstände bei LocalLinearPatternFeatureData.ModifyInstance nennt die Hilfe keine Einheit, vermutlich Meter.
Hilfethema: Die Hilfe verweist auf das Thema „Pattern Features and their Feature Data Objects“ und auf den PropertyManager „Linear Component Pattern“ in der Hilfe zur Oberfläche.
Eigenschaften und Methoden
Eigenschaften 38, davon 38 beschrieben
| Name | Beschreibung |
|---|---|
| AlignToSeed | Liest oder setzt, ob jede gedrehte Instanz des linearen Komponentenmusters so ausgerichtet wird wie die Ausgangskomponente. |
| D1Axis | Liest oder setzt das Element, das Richtung 1 des linearen Komponentenmusters festlegt, etwa eine Kante oder Achse. |
| D1EndCondition | Liest oder setzt, wie das lineare Komponentenmuster in Richtung 1 Abstand und Zahl der Instanzen bestimmt. |
| D1EndReference | Liest oder setzt die Referenz, bis zu der das lineare Komponentenmuster in Richtung 1 läuft (Bis Referenz). |
| D1EndReferenceType | Liefert die Art der Referenz für Bis Referenz in Richtung 1. |
| D1EndRefOffset | Liest oder setzt bei Bis Referenz den Versatz zur Referenz in Richtung 1. |
| D1EndRefReverseOffset | Liest oder setzt, ob bei Bis Referenz der Versatz zur Referenz in Richtung 1 umgekehrt wird. |
| D1EndSeedReference | Liest oder setzt bei Bis Referenz die Ausgangsreferenz in Richtung 1, deren Versatz zur Referenz gemessen wird. |
| D1EndSeedReferenceType | Liefert die Art der Ausgangsreferenz für Bis Referenz in Richtung 1. |
| D1EndUseSeedReference | Liest oder setzt, ob bei Bis Referenz in Richtung 1 der Versatz von einer Ausgangsreferenz oder vom Schwerpunkt gemessen wird. |
| D1EndUseSpacing | Liest oder setzt, ob bei Bis Referenz in Richtung 1 der Abstand oder die Zahl der Instanzen gilt. |
| D1ReverseDirection | Liest oder setzt, ob das lineare Komponentenmuster in Richtung 1 in die andere Richtung läuft. |
| D1Spacing | Liest oder setzt den Abstand zwischen den Instanzen in Richtung 1, in Meter. |
| D1TotalInstances | Liest oder setzt die Zahl der Instanzen in Richtung 1, ausgelassene Instanzen mitgezählt. |
| D2Axis | Liest oder setzt das Element, das Richtung 2 des linearen Komponentenmusters festlegt. |
| D2EndCondition | Liest oder setzt, wie das lineare Komponentenmuster in Richtung 2 Abstand und Zahl der Instanzen bestimmt. |
| D2EndReference | Liest oder setzt die Referenz, bis zu der das lineare Komponentenmuster in Richtung 2 läuft (Bis Referenz). |
| D2EndReferenceType | Liefert die Art der Referenz für Bis Referenz in Richtung 2. |
| D2EndRefOffset | Liest oder setzt bei Bis Referenz den Abstand der letzten Instanz zur Referenz in Richtung 2. |
| D2EndRefReverseOffset | Liest oder setzt, ob bei Bis Referenz der Versatz zur Referenz in Richtung 2 umgekehrt wird. |
| D2EndSeedReference | Liest oder setzt bei Bis Referenz die Ausgangsreferenz in Richtung 2, deren Versatz zur Referenz gemessen wird. |
| D2EndSeedReferenceType | Liefert die Art der Ausgangsreferenz für Bis Referenz in Richtung 2. |
| D2EndUseSeedReference | Liest oder setzt, ob bei Bis Referenz in Richtung 2 der Versatz von einer Ausgangsreferenz oder vom Schwerpunkt gemessen wird. |
| D2EndUseSpacing | Liest oder setzt, ob bei Bis Referenz in Richtung 2 der Abstand oder die Zahl der Instanzen gilt. |
| D2PatternSeedOnly | Liest oder setzt, ob in Richtung 2 nur die Ausgangskomponenten gemustert werden, ohne die Instanzen aus Richtung 1. |
| D2ReverseDirection | Liest oder setzt, ob das lineare Komponentenmuster in Richtung 2 in die andere Richtung läuft. |
| D2Spacing | Liest oder setzt den Abstand zwischen den Instanzen in Richtung 2, in Meter. |
| D2TotalInstances | Liest oder setzt die Zahl der Instanzen in Richtung 2, ausgelassene Instanzen mitgezählt. |
| FixedAxisOfRotation | Liest oder setzt, ob sich alle gedrehten Instanzen um eine gemeinsame Achse drehen. |
| ForceUseSeedConfiguration | Liest oder setzt, ob die gemusterten Komponenten immer dieselbe Konfiguration haben wie die Ausgangskomponente. |
| ReverseAxisOfRotation | Liest oder setzt, ob die Drehrichtung der gedrehten Instanzen umgekehrt wird. |
| RotateInstances | Liest oder setzt, ob die Instanzen in Richtung 1 gedreht werden. |
| RotationAngle | Liest oder setzt den Drehwinkel der Instanzen, im Bogenmaß. |
| RotationAxis | Liest oder setzt die Achse, um die sich die gedrehten Instanzen drehen. |
| SeedAlignmentReferencePoint | Liest oder setzt den Bezugspunkt, an dem gedrehte Instanzen an der Ausgangskomponente ausgerichtet werden. |
| SeedComponentArray | Liest oder setzt die Ausgangskomponenten des linearen Komponentenmusters. |
| SkippedItemArray | Liest oder setzt die Nummern der Instanzen, die das lineare Komponentenmuster auslässt. |
| SynchronizeFlexibleComponents | Liest oder setzt, ob sich gemusterte flexible Unterbaugruppen mit der flexiblen Ausgangs-Unterbaugruppe mitbewegen. |
Methoden 10, davon 10 beschrieben
| Name | Beschreibung |
|---|---|
| AccessSelections | Setzt das Modell vor das lineare Komponentenmuster zurück, damit du die Auswahlen lesen und ändern kannst, die es festlegen. |
| GetD1AxisType | Liefert, welche Art Element Richtung 1 des linearen Komponentenmusters festlegt: Achse, Kante, Bemaßung oder Fläche. |
| GetD2AxisType | Liefert, welche Art Element Richtung 2 des linearen Komponentenmusters festlegt: Achse, Kante, Bemaßung oder Fläche. |
| GetModifiedInstance | Liefert die geänderten Abstände einer Instanz des linearen Komponentenmusters in Richtung 1 und 2. |
| GetModifiedInstances | Liefert die Nummern aller geänderten Instanzen des linearen Komponentenmusters. |
| GetSeedComponentCount | Liefert die Zahl der Ausgangskomponenten des linearen Komponentenmusters. |
| GetSkippedItemCount | Liefert, wie viele Instanzen das lineare Komponentenmuster auslässt. |
| GetTransform | Liefert die Transformation einer Instanz des linearen Komponentenmusters. |
| ModifyInstance | Verschiebt eine Instanz des linearen Komponentenmusters auf andere Abstände in Richtung 1 und 2. |
| ReleaseSelectionAccess | Hebt den Rücksetz-Zustand nach AccessSelections wieder auf, wenn du das lineare 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: ILocalLinearPatternFeatureData in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)
Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.