SolidWorksMakroprogrammierung

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.

Deklaration Dim x As SldWorks.LocalLinearPatternFeatureData · in der englischen .NET-Hilfe: ILocalLinearPatternFeatureData

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

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 Sub

Bemerkungen

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

NameBeschreibung
AlignToSeedLiest oder setzt, ob jede gedrehte Instanz des linearen Komponentenmusters so ausgerichtet wird wie die Ausgangskomponente.
D1AxisLiest oder setzt das Element, das Richtung 1 des linearen Komponentenmusters festlegt, etwa eine Kante oder Achse.
D1EndConditionLiest oder setzt, wie das lineare Komponentenmuster in Richtung 1 Abstand und Zahl der Instanzen bestimmt.
D1EndReferenceLiest oder setzt die Referenz, bis zu der das lineare Komponentenmuster in Richtung 1 läuft (Bis Referenz).
D1EndReferenceTypeLiefert die Art der Referenz für Bis Referenz in Richtung 1.
D1EndRefOffsetLiest oder setzt bei Bis Referenz den Versatz zur Referenz in Richtung 1.
D1EndRefReverseOffsetLiest oder setzt, ob bei Bis Referenz der Versatz zur Referenz in Richtung 1 umgekehrt wird.
D1EndSeedReferenceLiest oder setzt bei Bis Referenz die Ausgangsreferenz in Richtung 1, deren Versatz zur Referenz gemessen wird.
D1EndSeedReferenceTypeLiefert die Art der Ausgangsreferenz für Bis Referenz in Richtung 1.
D1EndUseSeedReferenceLiest oder setzt, ob bei Bis Referenz in Richtung 1 der Versatz von einer Ausgangsreferenz oder vom Schwerpunkt gemessen wird.
D1EndUseSpacingLiest oder setzt, ob bei Bis Referenz in Richtung 1 der Abstand oder die Zahl der Instanzen gilt.
D1ReverseDirectionLiest oder setzt, ob das lineare Komponentenmuster in Richtung 1 in die andere Richtung läuft.
D1SpacingLiest oder setzt den Abstand zwischen den Instanzen in Richtung 1, in Meter.
D1TotalInstancesLiest oder setzt die Zahl der Instanzen in Richtung 1, ausgelassene Instanzen mitgezählt.
D2AxisLiest oder setzt das Element, das Richtung 2 des linearen Komponentenmusters festlegt.
D2EndConditionLiest oder setzt, wie das lineare Komponentenmuster in Richtung 2 Abstand und Zahl der Instanzen bestimmt.
D2EndReferenceLiest oder setzt die Referenz, bis zu der das lineare Komponentenmuster in Richtung 2 läuft (Bis Referenz).
D2EndReferenceTypeLiefert die Art der Referenz für Bis Referenz in Richtung 2.
D2EndRefOffsetLiest oder setzt bei Bis Referenz den Abstand der letzten Instanz zur Referenz in Richtung 2.
D2EndRefReverseOffsetLiest oder setzt, ob bei Bis Referenz der Versatz zur Referenz in Richtung 2 umgekehrt wird.
D2EndSeedReferenceLiest oder setzt bei Bis Referenz die Ausgangsreferenz in Richtung 2, deren Versatz zur Referenz gemessen wird.
D2EndSeedReferenceTypeLiefert die Art der Ausgangsreferenz für Bis Referenz in Richtung 2.
D2EndUseSeedReferenceLiest oder setzt, ob bei Bis Referenz in Richtung 2 der Versatz von einer Ausgangsreferenz oder vom Schwerpunkt gemessen wird.
D2EndUseSpacingLiest oder setzt, ob bei Bis Referenz in Richtung 2 der Abstand oder die Zahl der Instanzen gilt.
D2PatternSeedOnlyLiest oder setzt, ob in Richtung 2 nur die Ausgangskomponenten gemustert werden, ohne die Instanzen aus Richtung 1.
D2ReverseDirectionLiest oder setzt, ob das lineare Komponentenmuster in Richtung 2 in die andere Richtung läuft.
D2SpacingLiest oder setzt den Abstand zwischen den Instanzen in Richtung 2, in Meter.
D2TotalInstancesLiest oder setzt die Zahl der Instanzen in Richtung 2, ausgelassene Instanzen mitgezählt.
FixedAxisOfRotationLiest oder setzt, ob sich alle gedrehten Instanzen um eine gemeinsame Achse drehen.
ForceUseSeedConfigurationLiest oder setzt, ob die gemusterten Komponenten immer dieselbe Konfiguration haben wie die Ausgangskomponente.
ReverseAxisOfRotationLiest oder setzt, ob die Drehrichtung der gedrehten Instanzen umgekehrt wird.
RotateInstancesLiest oder setzt, ob die Instanzen in Richtung 1 gedreht werden.
RotationAngleLiest oder setzt den Drehwinkel der Instanzen, im Bogenmaß.
RotationAxisLiest oder setzt die Achse, um die sich die gedrehten Instanzen drehen.
SeedAlignmentReferencePointLiest oder setzt den Bezugspunkt, an dem gedrehte Instanzen an der Ausgangskomponente ausgerichtet werden.
SeedComponentArrayLiest oder setzt die Ausgangskomponenten des linearen Komponentenmusters.
SkippedItemArrayLiest oder setzt die Nummern der Instanzen, die das lineare Komponentenmuster auslässt.
SynchronizeFlexibleComponentsLiest oder setzt, ob sich gemusterte flexible Unterbaugruppen mit der flexiblen Ausgangs-Unterbaugruppe mitbewegen.

Methoden 10, davon 10 beschrieben

NameBeschreibung
AccessSelectionsSetzt das Modell vor das lineare Komponentenmuster zurück, damit du die Auswahlen lesen und ändern kannst, die es festlegen.
GetD1AxisTypeLiefert, welche Art Element Richtung 1 des linearen Komponentenmusters festlegt: Achse, Kante, Bemaßung oder Fläche.
GetD2AxisTypeLiefert, welche Art Element Richtung 2 des linearen Komponentenmusters festlegt: Achse, Kante, Bemaßung oder Fläche.
GetModifiedInstanceLiefert die geänderten Abstände einer Instanz des linearen Komponentenmusters in Richtung 1 und 2.
GetModifiedInstancesLiefert die Nummern aller geänderten Instanzen des linearen Komponentenmusters.
GetSeedComponentCountLiefert die Zahl der Ausgangskomponenten des linearen Komponentenmusters.
GetSkippedItemCountLiefert, wie viele Instanzen das lineare Komponentenmuster auslässt.
GetTransformLiefert die Transformation einer Instanz des linearen Komponentenmusters.
ModifyInstanceVerschiebt eine Instanz des linearen Komponentenmusters auf andere Abstände in Richtung 1 und 2.
ReleaseSelectionAccessHebt 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.