SolidWorksMakroprogrammierung

Objekt · SldWorks

CurveDrivenPatternFeatureData-Objekt

Die Definition eines kurvengesteuerten Musters: Ausgangselemente, Kurve und Zahl, Abstand und Ausrichtung der Instanzen in einer oder zwei Richtungen.

Deklaration Dim x As SldWorks.CurveDrivenPatternFeatureData · in der englischen .NET-Hilfe: ICurveDrivenPatternFeatureData

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

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 Sub

Bemerkungen

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

NameBeschreibung
AutoSelectLiefert, ob das kurvengesteuerte Muster in einem Mehrkörperteil automatisch alle Körper beeinflusst, die es schneidet.
BodyPatternLiest oder setzt, ob das kurvengesteuerte Muster Körper vervielfältigt oder Features und Flächen.
D1AlignmentMethodLiest oder setzt, wie die Instanzen in Richtung 1 ausgerichtet werden: tangential zur Kurve oder wie das Ausgangselement.
D1CurveMethodLiest oder setzt, wie die Instanzen in Richtung 1 der Kurve folgen: Kurve transformieren oder Kurve versetzen.
D1DirectionLiest oder setzt das Element, an dem entlang das Muster in Richtung 1 läuft, etwa eine Kante oder Skizze.
D1FaceNormalLiest oder setzt die Fläche, auf der die 3D-Kurve für Richtung 1 liegt.
D1InstanceCountLiest oder setzt die Zahl der Instanzen in Richtung 1.
D1IsEqualSpacedLiest oder setzt, ob die Instanzen in Richtung 1 gleichmäßig verteilt werden.
D1ReverseDirectionLiest oder setzt, ob das Muster in Richtung 1 in die andere Richtung läuft.
D1SpacingLiest oder setzt den Abstand der Instanzen in Richtung 1.
D2DirectionLiest oder setzt das Element, an dem entlang das Muster in Richtung 2 läuft, etwa eine Kante oder Skizze.
D2InstanceCountLiest oder setzt die Zahl der Instanzen in Richtung 2.
D2IsEqualSpacedLiest oder setzt, ob die Instanzen in Richtung 2 gleichmäßig verteilt werden.
D2PatternSeedOnlyLiest oder setzt, ob in Richtung 2 nur das Ausgangselement vervielfältigt wird, ohne das Muster aus Richtung 1.
D2ReverseDirectionLiest oder setzt, ob das Muster in Richtung 2 in die andere Richtung läuft.
D2SpacingLiest oder setzt den Abstand der Instanzen in Richtung 2.
Dir2SpecifiedLiest oder setzt, ob das kurvengesteuerte Muster eine zweite Richtung hat.
FeatureScopeLiefert, ob das kurvengesteuerte Muster in einem Mehrkörperteil nur bestimmte Körper beeinflusst.
FeatureScopeBodiesLiefert die Körper eines Mehrkörperteils, die das kurvengesteuerte Muster beeinflusst.
GeometryPatternLiest oder setzt, ob das kurvengesteuerte Muster nur die Geometrie (Flächen und Kanten) der Features vervielfältigt.
PatternBodyArrayLiest oder setzt die Körper, die das kurvengesteuerte Muster in einem Mehrkörperteil vervielfältigt.
PatternElementLiest oder setzt, ob das kurvengesteuerte Muster Features und Flächen oder Körper vervielfältigt.
PatternFaceArrayLiest oder setzt die Flächen, die das kurvengesteuerte Muster vervielfältigt.
PatternFeatureArrayLiest oder setzt die Features, die das kurvengesteuerte Muster vervielfältigt (Ausgangsfeatures).
PropagateVisualPropertyLiest oder setzt, ob Farben, Texturen und andere sichtbare Eigenschaften auf alle Instanzen übertragen werden.
SkippedItemArrayLiest oder setzt die Nummern der Instanzen, die das kurvengesteuerte Muster auslässt.
VarySketchLiest oder setzt, ob sich die Instanzen einer Ausgangsskizze an die umgebende Geometrie anpassen dürfen.

Methoden 8, davon 8 beschrieben

NameBeschreibung
AccessSelectionsSetzt das Modell vor das kurvengesteuerte Muster zurück, damit du die Auswahlen lesen und ändern kannst, die es festlegen.
GetPatternBodyCountLiefert die Zahl der Körper, die das kurvengesteuerte Muster vervielfältigt.
GetPatternFaceCountLiefert die Zahl der Flächen, die das kurvengesteuerte Muster vervielfältigt.
GetPatternFeatureCountLiefert die Zahl der Features, die das kurvengesteuerte Muster vervielfältigt.
GetSkippedItemCountLiefert, wie viele Instanzen das kurvengesteuerte Muster auslässt.
GetTransformLiefert die Transformation einer Instanz des kurvengesteuerten Musters.
ReleaseSelectionAccessHebt den Rücksetz-Zustand nach AccessSelections wieder auf, wenn du das kurvengesteuerte Muster nicht geändert hast.
SetFeatureScopeLegt 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.