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.
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
FeatureManager.CreateDefinitionmitswFmLPattern: Daten für ein neues lineares Muster, das du mitFeatureManager.CreateFeatureanlegstFeature.GetDefinition: aus einem vorhandenen linearen Muster (TypnameLPattern, sieheFeature.GetTypeName2)
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 SubBemerkungen
Anlegen: Vor FeatureManager.CreateDefinition wählst du die Elemente mit ModelDocExtension.SelectByID2 und diesen Markierungen aus:
1für Richtung 1,2für Richtung 24für die Features oder Flächen,256für die Körper,134217728für die Tragwerke2097152für die Referenzen bei Bis Referenz8388608fü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
| Name | Beschreibung |
|---|---|
| AutoSelect | Liefert, ob das lineare Muster in einem Mehrkörperteil automatisch alle Körper beeinflusst, die es schneidet. |
| BodyPattern | Liest oder setzt, ob das lineare Muster Körper und Tragwerke vervielfältigt oder Features und Flächen. |
| D1Axis | Liest oder setzt das Element, das Richtung 1 des linearen Musters festlegt, etwa eine Kante, Achse oder Ebene. |
| D1EndCondition | Liest oder setzt, wie Abstand und Anzahl der Instanzen in Richtung 1 bestimmt werden: direkt oder Bis Referenz. |
| D1EndReference | Liest oder setzt die Referenz, bis zu der das lineare Muster in Richtung 1 läuft (Bis Referenz). |
| D1EndRefOffset | Liest oder setzt den Abstand der letzten Instanz von der Referenz in Richtung 1 (Bis Referenz). |
| D1EndRefReverseOffset | Liest oder setzt, ob der Versatz von der Referenz in Richtung 1 umgekehrt wird. |
| D1EndSeedReference | Liest oder setzt die Geometrie des Ausgangselements, von der aus der Versatz zur Referenz in Richtung 1 gemessen wird. |
| D1EndUseSeedReference | Liest oder setzt, ob der Versatz zur Referenz in Richtung 1 von einer Ausgangsgeometrie oder vom Schwerpunkt aus gemessen wird. |
| D1EndUseSpacing | Liest oder setzt, ob bei Bis Referenz in Richtung 1 der Abstand oder die Anzahl der Instanzen gilt. |
| D1ReverseDirection | Liest oder setzt, ob Richtung 1 des linearen Musters umgekehrt wird. |
| 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. |
| D2Axis | Liest oder setzt das Element, das Richtung 2 des linearen Musters festlegt. |
| D2EndCondition | Liest oder setzt, wie Abstand und Anzahl der Instanzen in Richtung 2 bestimmt werden: direkt oder Bis Referenz. |
| D2EndReference | Liest oder setzt die Referenz, bis zu der das lineare Muster in Richtung 2 läuft (Bis Referenz). |
| D2EndRefOffset | Liest oder setzt den Abstand der letzten Instanz von der Referenz in Richtung 2 (Bis Referenz). |
| D2EndRefReverseOffset | Liest oder setzt, ob der Versatz von der Referenz in Richtung 2 umgekehrt wird. |
| D2EndSeedReference | Liest oder setzt die Geometrie des Ausgangsfeatures, von der aus der Versatz zur Referenz in Richtung 2 gemessen wird. |
| D2EndUseSeedReference | Liest oder setzt, ob der Versatz zur Referenz in Richtung 2 von einer Ausgangsgeometrie oder vom Schwerpunkt aus gemessen wird. |
| D2EndUseSpacing | Liest oder setzt, ob bei Bis Referenz in Richtung 2 der Abstand oder die Anzahl der Instanzen gilt. |
| D2PatternSeedOnly | Liest oder setzt, ob Richtung 2 nur das Ausgangselement vervielfältigt, ohne die Instanzen von Richtung 1. |
| D2ReverseDirection | Liest oder setzt, ob Richtung 2 des linearen Musters umgekehrt wird. |
| 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. |
| FeatureScope | Liefert, ob das lineare Muster in einem Mehrkörperteil nur bestimmte Körper beeinflusst. |
| FeatureScopeBodies | Liefert die Körper eines Mehrkörperteils, die das lineare Muster beeinflusst. |
| GeometryPattern | Liest oder setzt, ob das lineare Muster nur die Geometrie (Flächen und Kanten) der Features vervielfältigt (geometrisches Muster). |
| InstancesToVary | Liest oder setzt, ob der Abstand einzelner Instanzen des linearen Musters variiert werden kann. |
| PatternBodyArray | Liest oder setzt die Körper, die das lineare Muster in einem Mehrkörperteil vervielfältigt. |
| PatternElement | Liest oder setzt, ob das lineare Muster Features und Flächen oder Körper vervielfältigt. |
| PatternFaceArray | Liest oder setzt die Flächen, die das lineare Muster vervielfältigt. |
| PatternFeatureArray | Liest oder setzt die Features, die das lineare Muster vervielfältigt (Ausgangsfeatures). |
| PropagateVisualProperty | Liest oder setzt, ob die Instanzen die Darstellung des Ausgangsfeatures übernehmen, etwa Farben und Texturen. |
| SkippedItemArray | Liest oder setzt die Nummern der Instanzen, die das lineare Muster überspringt. |
| StructureSystemToPatternArray | Liest oder setzt die Tragwerke, die das lineare Muster vervielfältigt. |
| VarySketch | Liest oder setzt, ob sich die Instanzen einer Ausgangsskizze an die umgebende Geometrie anpassen dürfen (Skizze variieren). |
Methoden 13, davon 13 beschrieben
| Name | Beschreibung |
|---|---|
| AccessSelections | Setzt das Modell vor das lineare Muster zurück, damit du die Auswahlen lesen und ändern kannst, die es festlegen. |
| GetD1AxisType | Liefert, welche Art Element Richtung 1 des linearen Musters festlegt: Achse, Kante, Bemaßung oder Skizzensegment. |
| GetD2AxisType | Liefert, welche Art Element Richtung 2 des linearen Musters festlegt: Achse, Kante, Bemaßung oder Skizzensegment. |
| GetInstanceToVaryOptions | Liefert die Optionen, mit denen du den Abstand einzelner Instanzen variierst. |
| GetPatternBodyCount | Liefert die Zahl der Körper, die das lineare Muster vervielfältigt. |
| GetPatternFaceCount | Liefert die Zahl der Flächen, die das lineare Muster vervielfältigt. |
| GetPatternFeatureCount | Liefert die Zahl der Features, die das lineare Muster vervielfältigt. |
| GetSkippedItemCount | Liefert, wie viele Instanzen das lineare Muster überspringt. |
| GetTransform | Liefert die Transformation einer Instanz des linearen Musters. |
| IsDirection2Specified | Liefert, ob das lineare Muster eine Richtung 2 hat. |
| ReleaseSelectionAccess | Hebt den Rücksetz-Zustand nach AccessSelections wieder auf, wenn du das lineare Muster nicht geändert hast. |
| SetFeatureScope | Legt fest, welche Körper eines Mehrkörperteils das lineare Muster beeinflusst. |
| SetInstanceToVaryOptions | Gibt 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.