SolidWorksMakroprogrammierung

Objekt · SldWorks

LinearPatternFeatureData-Objekt

Die Feature-Daten eines linearen Musters im Teil: Richtungen, Abstand und Anzahl der Instanzen, Bis Referenz, gemusterte Elemente und ausgelassene Instanzen.

Deklaration Dim x As SldWorks.LinearPatternFeatureData · in der englischen .NET-Hilfe: ILinearPatternFeatureData

Beschreibung

LinearPatternFeatureData gibt Zugriff auf ein lineares Muster. Es vervielfältigt Features, Flächen oder Körper eines Teils in einer Richtung oder in zwei Richtungen. Je Richtung gibst du entweder Abstand und Anzahl der Instanzen direkt an oder lässt das Muster bis zu einer Referenz laufen (Bis Referenz). Das Gegenstück für Baugruppen ist LocalLinearPatternFeatureData. Die Grundbefehle gibt es seit SOLIDWORKS 2001, die Befehle für Bis Referenz seit SOLIDWORKS 2019.

Zugriff

Früher legte man lineare Muster mit den Methoden FeatureLinearPattern bis FeatureLinearPattern5 von FeatureManager an. Sie sind veraltet, Nachfolger ist CreateDefinition mit CreateFeature.

Beispiel

' Gibt Richtungen, Abstände und Instanzen des ausgewählten linearen Musters aus
' und erhöht die Zahl der Instanzen in Richtung 1 um eins.
' Vorbedingung: Ein Teil ist offen, ein lineares Muster 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.LinearPatternFeatureData

    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 <> "LPattern" Then Exit Sub

    Set swDaten = swFeat.GetDefinition
    If False = swDaten.AccessSelections(swModel, Nothing) Then Exit Sub
    If swDaten.D1EndCondition = swPatternEndCondition_UpToReference Then
        Debug.Print "Richtung 1: Bis Referenz, Versatz " & swDaten.D1EndRefOffset * 1000 & " mm"
    Else
        Debug.Print "Richtung 1: " & swDaten.D1TotalInstances & " Instanzen, Abstand " & _
                    swDaten.D1Spacing * 1000 & " mm"
    End If
    If swDaten.IsDirection2Specified Then
        Debug.Print "Richtung 2: " & swDaten.D2TotalInstances & " Instanzen, Abstand " & _
                    swDaten.D2Spacing * 1000 & " mm, nur Ausgangselement: " & swDaten.D2PatternSeedOnly
    End If
    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

    If swDaten.D1EndCondition = swPatternEndCondition_UpToReference And swDaten.D1EndUseSpacing Then
        swDaten.ReleaseSelectionAccess          ' Anzahl ergibt sich aus Abstand und Referenz
        Exit Sub
    End If
    swDaten.D1TotalInstances = swDaten.D1TotalInstances + 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 Richtung 1, 2 für Richtung 2
  • 4 für die Features oder Flächen, 256 für die Körper, 134217728 für die Tragwerke
  • 2097152 für die Referenzen bei Bis Referenz
  • 8388608 für die Ausgangsgeometrie, wenn der Versatz nicht vom Schwerpunkt aus gemessen wird

Wählst du direkt aus, nimmst du Entity.Select4 mit SelectData.Mark für die Richtungen und Feature.Select2 mit der Markierung für die übrigen Elemente. Danach setzt du die Eigenschaften und rufst FeatureManager.CreateFeature auf. So legt das Beispiel auf der Hilfeseite des Objekts ein Muster in zwei Richtungen an. Wie du die Referenzen von Richtung 1 und Richtung 2 unterscheidest, wenn beide Bis Referenz nutzen, sagt die Hilfe nicht.

Reihenfolge: Richtung 1 mit LinearPatternFeatureData.D1Axis, die Art der Elemente mit LinearPatternFeatureData.BodyPattern und den passenden Arrays, dann LinearPatternFeatureData.D1EndCondition. Bei swPatternEndCondition_SpacingAndInstances folgen LinearPatternFeatureData.D1Spacing, LinearPatternFeatureData.D1TotalInstances und LinearPatternFeatureData.D1ReverseDirection. Bei swPatternEndCondition_UpToReference folgen die D1End…-Eigenschaften und, je nach LinearPatternFeatureData.D1EndUseSpacing, der Abstand oder die Anzahl. Für Richtung 2 nimmst du die D2…-Eigenschaften.

Ändern: Rufe erst LinearPatternFeatureData.AccessSelections auf und übernimm Änderungen mit Feature.ModifyDefinition. Ohne Änderung hebst du den Zustand mit LinearPatternFeatureData.ReleaseSelectionAccess auf.

Nach dem Anlegen: Nach dem Anlegen kannst du den Abstand einzelner Instanzen variieren (LinearPatternFeatureData.InstancesToVary) und die gemusterten Tragwerke ändern.

Einheiten: LinearPatternFeatureData.D1Spacing und LinearPatternFeatureData.D2Spacing sind in Meter. Für die Versätze bei Bis Referenz nennt die Hilfe keine Einheit, vermutlich ebenfalls Meter.

Hilfethema: Die Hilfe verweist auf das Thema „Pattern Features and their Feature Data Objects“ und für Einzelheiten auf den PropertyManager „Linear Pattern“ in der Hilfe zur Oberfläche.

Eigenschaften und Methoden

Eigenschaften 37, davon 37 beschrieben

NameBeschreibung
AutoSelectLiefert, ob das lineare Muster in einem Mehrkörperteil automatisch alle Körper beeinflusst, die es schneidet.
BodyPatternLiest oder setzt, ob das lineare Muster Körper und Tragwerke vervielfältigt oder Features und Flächen.
D1AxisLiest oder setzt das Element, das Richtung 1 des linearen Musters festlegt, etwa eine Kante, Achse oder Ebene.
D1EndConditionLiest oder setzt, wie Abstand und Anzahl der Instanzen in Richtung 1 bestimmt werden: direkt oder Bis Referenz.
D1EndReferenceLiest oder setzt die Referenz, bis zu der das lineare Muster in Richtung 1 läuft (Bis Referenz).
D1EndRefOffsetLiest oder setzt den Abstand der letzten Instanz von der Referenz in Richtung 1 (Bis Referenz).
D1EndRefReverseOffsetLiest oder setzt, ob der Versatz von der Referenz in Richtung 1 umgekehrt wird.
D1EndSeedReferenceLiest oder setzt die Geometrie des Ausgangselements, von der aus der Versatz zur Referenz in Richtung 1 gemessen wird.
D1EndUseSeedReferenceLiest oder setzt, ob der Versatz zur Referenz in Richtung 1 von einer Ausgangsgeometrie oder vom Schwerpunkt aus gemessen wird.
D1EndUseSpacingLiest oder setzt, ob bei Bis Referenz in Richtung 1 der Abstand oder die Anzahl der Instanzen gilt.
D1ReverseDirectionLiest oder setzt, ob Richtung 1 des linearen Musters umgekehrt wird.
D1SpacingLiest oder setzt den Abstand zwischen den Instanzen in Richtung 1, in Meter.
D1TotalInstancesLiest oder setzt die Zahl der Instanzen in Richtung 1.
D2AxisLiest oder setzt das Element, das Richtung 2 des linearen Musters festlegt.
D2EndConditionLiest oder setzt, wie Abstand und Anzahl der Instanzen in Richtung 2 bestimmt werden: direkt oder Bis Referenz.
D2EndReferenceLiest oder setzt die Referenz, bis zu der das lineare Muster in Richtung 2 läuft (Bis Referenz).
D2EndRefOffsetLiest oder setzt den Abstand der letzten Instanz von der Referenz in Richtung 2 (Bis Referenz).
D2EndRefReverseOffsetLiest oder setzt, ob der Versatz von der Referenz in Richtung 2 umgekehrt wird.
D2EndSeedReferenceLiest oder setzt die Geometrie des Ausgangsfeatures, von der aus der Versatz zur Referenz in Richtung 2 gemessen wird.
D2EndUseSeedReferenceLiest oder setzt, ob der Versatz zur Referenz in Richtung 2 von einer Ausgangsgeometrie oder vom Schwerpunkt aus gemessen wird.
D2EndUseSpacingLiest oder setzt, ob bei Bis Referenz in Richtung 2 der Abstand oder die Anzahl der Instanzen gilt.
D2PatternSeedOnlyLiest oder setzt, ob Richtung 2 nur das Ausgangselement vervielfältigt, ohne die Instanzen von Richtung 1.
D2ReverseDirectionLiest oder setzt, ob Richtung 2 des linearen Musters umgekehrt wird.
D2SpacingLiest oder setzt den Abstand zwischen den Instanzen in Richtung 2, in Meter.
D2TotalInstancesLiest oder setzt die Zahl der Instanzen in Richtung 2.
FeatureScopeLiefert, ob das lineare Muster in einem Mehrkörperteil nur bestimmte Körper beeinflusst.
FeatureScopeBodiesLiefert die Körper eines Mehrkörperteils, die das lineare Muster beeinflusst.
GeometryPatternLiest oder setzt, ob das lineare Muster nur die Geometrie (Flächen und Kanten) der Features vervielfältigt (geometrisches Muster).
InstancesToVaryLiest oder setzt, ob der Abstand einzelner Instanzen des linearen Musters variiert werden kann.
PatternBodyArrayLiest oder setzt die Körper, die das lineare Muster in einem Mehrkörperteil vervielfältigt.
PatternElementLiest oder setzt, ob das lineare Muster Features und Flächen oder Körper vervielfältigt.
PatternFaceArrayLiest oder setzt die Flächen, die das lineare Muster vervielfältigt.
PatternFeatureArrayLiest oder setzt die Features, die das lineare Muster vervielfältigt (Ausgangsfeatures).
PropagateVisualPropertyLiest oder setzt, ob die Instanzen die Darstellung des Ausgangsfeatures übernehmen, etwa Farben und Texturen.
SkippedItemArrayLiest oder setzt die Nummern der Instanzen, die das lineare Muster überspringt.
StructureSystemToPatternArrayLiest oder setzt die Tragwerke, die das lineare Muster vervielfältigt.
VarySketchLiest oder setzt, ob sich die Instanzen einer Ausgangsskizze an die umgebende Geometrie anpassen dürfen (Skizze variieren).

Methoden 13, davon 13 beschrieben

NameBeschreibung
AccessSelectionsSetzt das Modell vor das lineare Muster zurück, damit du die Auswahlen lesen und ändern kannst, die es festlegen.
GetD1AxisTypeLiefert, welche Art Element Richtung 1 des linearen Musters festlegt: Achse, Kante, Bemaßung oder Skizzensegment.
GetD2AxisTypeLiefert, welche Art Element Richtung 2 des linearen Musters festlegt: Achse, Kante, Bemaßung oder Skizzensegment.
GetInstanceToVaryOptionsLiefert die Optionen, mit denen du den Abstand einzelner Instanzen variierst.
GetPatternBodyCountLiefert die Zahl der Körper, die das lineare Muster vervielfältigt.
GetPatternFaceCountLiefert die Zahl der Flächen, die das lineare Muster vervielfältigt.
GetPatternFeatureCountLiefert die Zahl der Features, die das lineare Muster vervielfältigt.
GetSkippedItemCountLiefert, wie viele Instanzen das lineare Muster überspringt.
GetTransformLiefert die Transformation einer Instanz des linearen Musters.
IsDirection2SpecifiedLiefert, ob das lineare Muster eine Richtung 2 hat.
ReleaseSelectionAccessHebt den Rücksetz-Zustand nach AccessSelections wieder auf, wenn du das lineare Muster nicht geändert hast.
SetFeatureScopeLegt fest, welche Körper eines Mehrkörperteils das lineare Muster beeinflusst.
SetInstanceToVaryOptionsGibt die geänderten Optionen zum Variieren einzelner Instanzen an das lineare Muster 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: ILinearPatternFeatureData in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)

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