Objekt · SldWorks
CurveDrivenPatternFeatureData-Objekt
Die Definition eines kurvengesteuerten Musters: Ausgangselemente, Kurve und Zahl, Abstand und Ausrichtung der Instanzen in einer oder zwei Richtungen.
Beschreibung
CurveDrivenPatternFeatureData gibt Zugriff auf ein kurvengesteuertes Muster. Es vervielfältigt Features, Flächen oder Körper entlang einer Kurve, Kante, Skizze oder eines Skizzenelements, auf Wunsch in einer zweiten Richtung. Für Richtung 1 legst du die Zahl, den Abstand und die Ausrichtung der Instanzen fest, für Richtung 2 Zahl und Abstand. Die meisten Befehle gibt es seit SOLIDWORKS 2001Plus.
Zugriff
FeatureManager.CreateDefinitionmitswFmCurvePattern: eine neue Definition fürFeatureManager.CreateFeatureFeature.GetDefinition: bei einem Feature mit dem TypnamenCurvePattern
Beispiel
' Gibt die Daten des ausgewählten kurvengesteuerten Musters aus und erhöht die Zahl
' der Instanzen in Richtung 1 um eins.
' Vorbedingung: Ein Teil mit einem kurvengesteuerten Muster ist offen, das Muster ist im
' FeatureManager ausgewählt.
' Ergebnis: Das Muster hat eine Instanz mehr, die Werte stehen im Direktfenster.
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.CurveDrivenPatternFeatureData
Dim bWarnung As Boolean
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 <> "CurvePattern" Then Exit Sub
Set swDaten = swFeat.GetDefinition
If False = swDaten.AccessSelections(swModel, Nothing) Then Exit Sub
Debug.Print swFeat.Name & ": " & swDaten.GetPatternFeatureCount & " Ausgangsfeature(s)"
Debug.Print "Richtung 1: " & swDaten.D1InstanceCount & " Instanzen, " & _
IIf(swDaten.D1IsEqualSpaced, "gleichmäßig verteilt", "Abstand " & swDaten.D1Spacing * 1000 & " mm")
If swDaten.Dir2Specified Then
Debug.Print "Richtung 2: " & swDaten.D2InstanceCount & " Instanzen"
End If
swDaten.D1InstanceCount = swDaten.D1InstanceCount + 1
If swFeat.ModifyDefinition(swDaten, swModel, Nothing) Then
Debug.Print "Jetzt " & swDaten.D1InstanceCount & " Instanzen, Fehlercode " & swFeat.GetErrorCode2(bWarnung)
Else
swDaten.ReleaseSelectionAccess
End If
End SubBemerkungen
Anlegen: Vor FeatureManager.CreateDefinition wählst du mit ModelDocExtension.SelectByID2 aus: die Features zum Mustern mit der Markierung 4, das Element für Richtung 1 mit 1, das für Richtung 2 mit 2. Ist Richtung 1 eine 3D-Kurve und sollen die Instanzen tangential folgen, wählst du zusätzlich die Fläche, auf der die Kurve liegt, mit 1024 aus. Danach setzt du die übrigen Werte und legst das Muster mit FeatureManager.CreateFeature an.
Ändern: Nach CurveDrivenPatternFeatureData.AccessSelections setzt du die Werte und rufst Feature.ModifyDefinition auf. Änderst du nichts, rufst du CurveDrivenPatternFeatureData.ReleaseSelectionAccess auf. Die Elemente für die Richtungen gibst du nur beim Ändern über D1Direction und D2Direction an.
Was gemustert wird: CurveDrivenPatternFeatureData.BodyPattern entscheidet zwischen Körpern und Features oder Flächen. Mit CurveDrivenPatternFeatureData.GeometryPattern und CurveDrivenPatternFeatureData.SetFeatureScope legst du in Mehrkörperteilen fest, welche Körper das Muster beeinflusst.
Einheiten: Für die Abstände nennt die Hilfe keine Einheit. Es sind Meter. Nach dem Umkehren der Richtung kamen genau drei Zapfen im Abstand von 20 mm auf den Quader, der Abstand ist also in Metern.
Mehr dazu: Die Hilfe verweist auf das Thema „Pattern Features and their Feature Data Objects“ und auf den PropertyManager „Curve Driven Pattern“ in der Hilfe zur Oberfläche.
Die Richtung, die SOLIDWORKS beim Anlegen wählt, kann vom Körper weg zeigen, sodass die Instanzen daneben liegen. Dann kehrst du sie mit CurveDrivenPatternFeatureData.D1ReverseDirection um.
Eigenschaften und Methoden
Eigenschaften 27, davon 27 beschrieben
| Name | Beschreibung |
|---|---|
| AutoSelect | Liefert, ob das kurvengesteuerte Muster in einem Mehrkörperteil automatisch alle Körper beeinflusst, die es schneidet. |
| BodyPattern | Liest oder setzt, ob das kurvengesteuerte Muster Körper vervielfältigt oder Features und Flächen. |
| D1AlignmentMethod | Liest oder setzt, wie die Instanzen in Richtung 1 ausgerichtet werden: tangential zur Kurve oder wie das Ausgangselement. |
| D1CurveMethod | Liest oder setzt, wie die Instanzen in Richtung 1 der Kurve folgen: Kurve transformieren oder Kurve versetzen. |
| D1Direction | Liest oder setzt das Element, an dem entlang das Muster in Richtung 1 läuft, etwa eine Kante oder Skizze. |
| D1FaceNormal | Liest oder setzt die Fläche, auf der die 3D-Kurve für Richtung 1 liegt. |
| D1InstanceCount | Liest oder setzt die Zahl der Instanzen in Richtung 1. |
| D1IsEqualSpaced | Liest oder setzt, ob die Instanzen in Richtung 1 gleichmäßig verteilt werden. |
| D1ReverseDirection | Liest oder setzt, ob das Muster in Richtung 1 in die andere Richtung läuft. |
| D1Spacing | Liest oder setzt den Abstand der Instanzen in Richtung 1. |
| D2Direction | Liest oder setzt das Element, an dem entlang das Muster in Richtung 2 läuft, etwa eine Kante oder Skizze. |
| D2InstanceCount | Liest oder setzt die Zahl der Instanzen in Richtung 2. |
| D2IsEqualSpaced | Liest oder setzt, ob die Instanzen in Richtung 2 gleichmäßig verteilt werden. |
| D2PatternSeedOnly | Liest oder setzt, ob in Richtung 2 nur das Ausgangselement vervielfältigt wird, ohne das Muster aus Richtung 1. |
| D2ReverseDirection | Liest oder setzt, ob das Muster in Richtung 2 in die andere Richtung läuft. |
| D2Spacing | Liest oder setzt den Abstand der Instanzen in Richtung 2. |
| Dir2Specified | Liest oder setzt, ob das kurvengesteuerte Muster eine zweite Richtung hat. |
| FeatureScope | Liefert, ob das kurvengesteuerte Muster in einem Mehrkörperteil nur bestimmte Körper beeinflusst. |
| FeatureScopeBodies | Liefert die Körper eines Mehrkörperteils, die das kurvengesteuerte Muster beeinflusst. |
| GeometryPattern | Liest oder setzt, ob das kurvengesteuerte Muster nur die Geometrie (Flächen und Kanten) der Features vervielfältigt. |
| PatternBodyArray | Liest oder setzt die Körper, die das kurvengesteuerte Muster in einem Mehrkörperteil vervielfältigt. |
| PatternElement | Liest oder setzt, ob das kurvengesteuerte Muster Features und Flächen oder Körper vervielfältigt. |
| PatternFaceArray | Liest oder setzt die Flächen, die das kurvengesteuerte Muster vervielfältigt. |
| PatternFeatureArray | Liest oder setzt die Features, die das kurvengesteuerte Muster vervielfältigt (Ausgangsfeatures). |
| PropagateVisualProperty | Liest oder setzt, ob Farben, Texturen und andere sichtbare Eigenschaften auf alle Instanzen übertragen werden. |
| SkippedItemArray | Liest oder setzt die Nummern der Instanzen, die das kurvengesteuerte Muster auslässt. |
| VarySketch | Liest oder setzt, ob sich die Instanzen einer Ausgangsskizze an die umgebende Geometrie anpassen dürfen. |
Methoden 8, davon 8 beschrieben
| Name | Beschreibung |
|---|---|
| AccessSelections | Setzt das Modell vor das kurvengesteuerte Muster zurück, damit du die Auswahlen lesen und ändern kannst, die es festlegen. |
| GetPatternBodyCount | Liefert die Zahl der Körper, die das kurvengesteuerte Muster vervielfältigt. |
| GetPatternFaceCount | Liefert die Zahl der Flächen, die das kurvengesteuerte Muster vervielfältigt. |
| GetPatternFeatureCount | Liefert die Zahl der Features, die das kurvengesteuerte Muster vervielfältigt. |
| GetSkippedItemCount | Liefert, wie viele Instanzen das kurvengesteuerte Muster auslässt. |
| GetTransform | Liefert die Transformation einer Instanz des kurvengesteuerten Musters. |
| ReleaseSelectionAccess | Hebt den Rücksetz-Zustand nach AccessSelections wieder auf, wenn du das kurvengesteuerte Muster nicht geändert hast. |
| SetFeatureScope | Legt fest, welche Körper eines Mehrkörperteils das kurvengesteuerte Muster beeinflusst. |
Nicht aufgeführt sind 9 C++-Varianten (Namen mit I davor, zum Beispiel IAccessSelections). In VBA nimmst du immer den Befehl ohne I.
Siehe auch
Englisches Original: ICurveDrivenPatternFeatureData in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)
Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.