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.
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
FeatureManager.CreateDefinitionmitswFmLocalCurvePattern: eine neue Definition fürFeatureManager.CreateFeatureFeature.GetDefinition: bei einem Feature der Baugruppe mit dem TypnamenLocalCurvePattern
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 SubBemerkungen
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
swLocalCurvePatternSelectedPointist: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
| Name | Beschreibung |
|---|---|
| D1AlignmentMethod | Liest oder setzt, wie die Instanzen in Richtung 1 ausgerichtet werden: tangential zur Kurve oder wie die Ausgangskomponente. |
| 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 Komponentenmuster 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 der Ausgangskomponente in Richtung 1. |
| D1IsEqualSpaced | Liest oder setzt, ob die Instanzen in Richtung 1 gleichmäßig verteilt werden. |
| D1ReferencePoint | Liest oder setzt den Referenzpunkt für Richtung 1: Mitte des Begrenzungsrahmens, Ursprung der Komponente oder gewählter Punkt. |
| D1ReverseDirection | Liest oder setzt, ob das Komponentenmuster 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 Komponentenmuster in Richtung 2 läuft, etwa eine Kante oder Skizze. |
| D2InstanceCount | Liest oder setzt die Zahl der Instanzen der Ausgangskomponente 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 die Ausgangskomponente vervielfältigt wird, ohne die Instanzen aus Richtung 1. |
| D2ReverseDirection | Liest oder setzt, ob das Komponentenmuster 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 Komponentenmuster eine zweite Richtung hat. |
| ForceUseSeedConfiguration | Liest oder setzt, ob die gemusterten Komponenten immer dieselbe Konfiguration haben wie die Ausgangskomponente. |
| PatternComponentArray | Liest oder setzt die Komponenten, die das kurvengesteuerte Komponentenmuster vervielfältigt (Ausgangskomponenten). |
| SelectedPoint | Liest oder setzt den gewählten Referenzpunkt des kurvengesteuerten Komponentenmusters. |
| SkippedItemArray | Liest oder setzt die Nummern der Instanzen, die das kurvengesteuerte Komponentenmuster auslässt. |
Methoden 5, davon 5 beschrieben
| Name | Beschreibung |
|---|---|
| AccessSelections | Setzt das Modell vor das kurvengesteuerte Komponentenmuster zurück, damit du die Auswahlen lesen und ändern kannst, die es festlegen. |
| GetPatternComponentCount | Liefert die Zahl der Komponenten des kurvengesteuerten Komponentenmusters. |
| GetSkippedItemCount | Liefert, wie viele Instanzen das kurvengesteuerte Komponentenmuster auslässt. |
| GetTransform | Liefert die Transformation einer Instanz des kurvengesteuerten Komponentenmusters. |
| ReleaseSelectionAccess | Hebt 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.