SolidWorksMakroprogrammierung

Objekt · SldWorks

LocalCurvePatternFeatureData-Objekt

Die Definition eines kurvengesteuerten Komponentenmusters in einer Baugruppe: Ausgangskomponenten, Kurve und Zahl, Abstand und Ausrichtung der Instanzen in einer oder zwei Richtungen.

Deklaration Dim x As SldWorks.LocalCurvePatternFeatureData · in der englischen .NET-Hilfe: ILocalCurvePatternFeatureData

Beschreibung

LocalCurvePatternFeatureData gibt Zugriff auf ein kurvengesteuertes Komponentenmuster in einer Baugruppe. Es vervielfältigt Komponenten entlang einer Kurve, Kante, Skizze oder eines Skizzenelements, auf Wunsch in einer zweiten Richtung. Für Richtung 1 legst du Zahl, Abstand, Ausrichtung und Referenzpunkt der Instanzen fest, für Richtung 2 Zahl und Abstand. Die meisten Befehle gibt es seit SOLIDWORKS 2015.

Das Gegenstück im Teil ist CurveDrivenPatternFeatureData. Es mustert Features, Flächen oder Körper, dieses Objekt mustert Komponenten. Deshalb fehlen hier die Befehle für Features, Flächen, Körper, Geometriemuster und Darstellung. Dafür gibt es die Ausgangskomponenten, einen Referenzpunkt für Richtung 1 und die Konfiguration der Instanzen.

Zugriff

Beispiel

' Gibt die Daten des ausgewählten kurvengesteuerten Komponentenmusters aus und erhöht
' die Zahl der Instanzen in Richtung 1 um eins.
' Vorbedingung: Eine Baugruppe mit einem kurvengesteuerten Komponentenmuster 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.LocalCurvePatternFeatureData
    Dim swComp As SldWorks.Component2
    Dim swKompFeat As SldWorks.Feature
    Dim vKomp 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 <> "LocalCurvePattern" Then Exit Sub

    Set swDaten = swFeat.GetDefinition
    If False = swDaten.AccessSelections(swModel, Nothing) Then Exit Sub
    vKomp = swDaten.PatternComponentArray
    If IsArray(vKomp) Then
        For i = 0 To UBound(vKomp)
            Set swKompFeat = vKomp(i)                    ' die Elemente sind Features
            Set swComp = swKompFeat.GetSpecificFeature2
            Debug.Print "Ausgangskomponente: " & swComp.Name2
        Next i
    End If
    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"
    Else
        swDaten.ReleaseSelectionAccess
    End If
End Sub

Bemerkungen

Anlegen: Vor FeatureManager.CreateDefinition wählst du mit ModelDocExtension.SelectByID2 aus:

  • Komponenten zum Mustern: 1
  • Kurve, Kante, Skizze oder Skizzenelement für Richtung 1: 2
  • Kurve, Kante, Skizze oder Skizzenelement für Richtung 2: 4
  • Referenzpunkt, nur wenn D1ReferencePoint swLocalCurvePatternSelectedPoint ist: 32
  • Fläche, auf der eine 3D-Kurve liegt: 64

Danach setzt du die übrigen Werte und legst das Muster mit FeatureManager.CreateFeature an. Das Hilfebeispiel „Create Local Curve-driven Pattern“ wählt eine Komponente mit 1 und eine Kante mit 2 aus. Die Seiten zu D1Direction und D2Direction nennen dagegen die Markierung 1 für die Richtungen. Das passt nicht zur Übersicht und zum Beispiel.

Ändern: Nach LocalCurvePatternFeatureData.AccessSelections setzt du die Werte und rufst Feature.ModifyDefinition auf. Änderst du nichts, rufst du LocalCurvePatternFeatureData.ReleaseSelectionAccess auf. Die Elemente für die Richtungen und die Fläche gibst du nur beim Ändern über D1Direction, D2Direction und D1FaceNormal an. Das Muster ist ein Feature der Baugruppe, die Beispiele übergeben deshalb die Baugruppe und Nothing für die Komponente.

Elemente zuweisen: Richtungen, Fläche, Punkt und Komponenten sind Objekt-Eigenschaften. Wie du ihnen etwas zuweist, mit oder ohne Set, zeigt die Hilfe nicht. Die Beispiele hier lesen sie nur.

Einheiten: Für die Abstände nennt die Hilfe keine Einheit. Vermutlich sind es wie sonst in der API Meter, das Hilfebeispiel setzt 0.05.

Mehr dazu: Die Hilfe verweist auf das Thema „Pattern Features and their Feature Data Objects“ und auf „Curve Driven Component Pattern“ in der Hilfe zur Oberfläche. Der ältere Befehl FeatureManager.FeatureLocalCurveDrivenPattern ist veraltet, Nachfolger ist FeatureManager.CreateFeature.

LocalCurvePatternFeatureData.PatternComponentArray liefert Features, keine Component2-Objekte; die Komponente holst du mit Feature.GetSpecificFeature2. Würden die Kopien hinter dem Ende der Kante liegen, liefert FeatureManager.CreateFeature Nothing; dann kehrst du die Richtung mit LocalCurvePatternFeatureData.D1ReverseDirection = True um.

Eigenschaften und Methoden

Eigenschaften 20, davon 20 beschrieben

NameBeschreibung
D1AlignmentMethodLiest oder setzt, wie die Instanzen in Richtung 1 ausgerichtet werden: tangential zur Kurve oder wie die Ausgangskomponente.
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 Komponentenmuster 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 der Ausgangskomponente in Richtung 1.
D1IsEqualSpacedLiest oder setzt, ob die Instanzen in Richtung 1 gleichmäßig verteilt werden.
D1ReferencePointLiest oder setzt den Referenzpunkt für Richtung 1: Mitte des Begrenzungsrahmens, Ursprung der Komponente oder gewählter Punkt.
D1ReverseDirectionLiest oder setzt, ob das Komponentenmuster 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 Komponentenmuster in Richtung 2 läuft, etwa eine Kante oder Skizze.
D2InstanceCountLiest oder setzt die Zahl der Instanzen der Ausgangskomponente in Richtung 2.
D2IsEqualSpacedLiest oder setzt, ob die Instanzen in Richtung 2 gleichmäßig verteilt werden.
D2PatternSeedOnlyLiest oder setzt, ob in Richtung 2 nur die Ausgangskomponente vervielfältigt wird, ohne die Instanzen aus Richtung 1.
D2ReverseDirectionLiest oder setzt, ob das Komponentenmuster 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 Komponentenmuster eine zweite Richtung hat.
ForceUseSeedConfigurationLiest oder setzt, ob die gemusterten Komponenten immer dieselbe Konfiguration haben wie die Ausgangskomponente.
PatternComponentArrayLiest oder setzt die Komponenten, die das kurvengesteuerte Komponentenmuster vervielfältigt (Ausgangskomponenten).
SelectedPointLiest oder setzt den gewählten Referenzpunkt des kurvengesteuerten Komponentenmusters.
SkippedItemArrayLiest oder setzt die Nummern der Instanzen, die das kurvengesteuerte Komponentenmuster auslässt.

Methoden 5, davon 5 beschrieben

NameBeschreibung
AccessSelectionsSetzt das Modell vor das kurvengesteuerte Komponentenmuster zurück, damit du die Auswahlen lesen und ändern kannst, die es festlegen.
GetPatternComponentCountLiefert die Zahl der Komponenten des kurvengesteuerten Komponentenmusters.
GetSkippedItemCountLiefert, wie viele Instanzen das kurvengesteuerte Komponentenmuster auslässt.
GetTransformLiefert die Transformation einer Instanz des kurvengesteuerten Komponentenmusters.
ReleaseSelectionAccessHebt den Rücksetz-Zustand nach AccessSelections wieder auf, wenn du das kurvengesteuerte Komponentenmuster nicht geändert hast.

Siehe auch

Englisches Original: ILocalCurvePatternFeatureData in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)

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