Objekt · SldWorks
LocalSketchPatternFeatureData-Objekt
Die Definition eines skizzengesteuerten Komponentenmusters in einer Baugruppe: Ausgangskomponenten, Skizze mit den Punkten der Instanzen und Referenzpunkt.
Beschreibung
LocalSketchPatternFeatureData gibt Zugriff auf ein skizzengesteuertes Komponentenmuster in einer Baugruppe. Es vervielfältigt Komponenten an die Skizzenpunkte einer Skizze. Welcher Punkt der Ausgangskomponente auf den Skizzenpunkten landet, legt der Referenzpunkt fest: die Mitte des Begrenzungsrahmens, der Ursprung der Komponente oder ein gewählter Punkt. Die Befehle gibt es seit SOLIDWORKS 2015.
Das Gegenstück im Teil ist SketchPatternFeatureData. Es mustert Features, Flächen oder Körper, dieses Objekt mustert Komponenten. Deshalb fehlen hier die Befehle für Features, Flächen, Körper und Geometriemuster, dafür gibt es die Ausgangskomponenten, ausgelassene Instanzen und die Konfiguration der Instanzen. Auch der Referenzpunkt ist anders aufgebaut: LocalSketchPatternFeatureData.ReferencePoint ist hier ein Wert aus swLocalSketchPatternReferencePoint_e, der gewählte Punkt steht in LocalSketchPatternFeatureData.SelectedPoint.
Zugriff
FeatureManager.CreateDefinitionmitswFmLocalSketchPattern: eine neue Definition fürFeatureManager.CreateFeatureFeature.GetDefinition: bei einem Feature der Baugruppe mit dem TypnamenLocalSketchPattern
Beispiel
' Gibt Skizze, Ausgangskomponenten, Referenzpunkt und ausgelassene Instanzen des
' ausgewählten skizzengesteuerten Komponentenmusters aus.
' Vorbedingung: Eine Baugruppe mit einem skizzengesteuerten Komponentenmuster ist offen,
' das Muster ist im FeatureManager ausgewählt.
' Ergebnis: Die Werte stehen im Direktfenster, die Baugruppe bleibt unverändert.
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.LocalSketchPatternFeatureData
Dim swSketch As SldWorks.Sketch
Dim swSkizzenFeat As SldWorks.Feature
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 <> "LocalSketchPattern" Then Exit Sub
Set swDaten = swFeat.GetDefinition
If False = swDaten.AccessSelections(swModel, Nothing) Then Exit Sub
Set swSketch = swDaten.Sketch
Set swSkizzenFeat = swSketch ' dieselbe Skizze als Feature
Debug.Print swFeat.Name & ": Skizze " & swSkizzenFeat.Name & " mit " & swSketch.GetSketchPointsCount2 & " Punkten"
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
Select Case swDaten.ReferencePoint
Case swLocalSketchPatternBoundingBoxCenter: Debug.Print " Referenzpunkt: Mitte des Begrenzungsrahmens"
Case swLocalSketchPatternComponentOrigin: Debug.Print " Referenzpunkt: Ursprung der Komponente"
Case swLocalSketchPatternSelectedPoint: Debug.Print " Referenzpunkt: gewählter Punkt"
End Select
Debug.Print " " & swDaten.GetSkippedItemCount & " Instanzen ausgelassen"
swDaten.ReleaseSelectionAccess
End SubBemerkungen
Anlegen: Vor FeatureManager.CreateDefinition wählst du mit ModelDocExtension.SelectByID2 aus: die Komponenten mit der Markierung 1, die Skizze mit 16 und den Referenzpunkt mit 32. Die Markierungen sind andere als beim Muster im Teil. Danach setzt du die übrigen Werte und legst das Muster mit FeatureManager.CreateFeature an. Das Hilfebeispiel „Create Local Sketch-driven Pattern“ legt eine Skizze mit drei Punkten an, wählt eine Komponente mit 1 und die Skizze mit 16 aus und setzt ReferencePoint auf 1 (Mitte des Begrenzungsrahmens).
Ändern: Nach LocalSketchPatternFeatureData.AccessSelections setzt du die Werte und rufst Feature.ModifyDefinition auf. Änderst du nichts, rufst du LocalSketchPatternFeatureData.ReleaseSelectionAccess auf. Das Muster ist ein Feature der Baugruppe, die Beispiele übergeben deshalb die Baugruppe und Nothing für die Komponente.
Elemente zuweisen: Skizze, 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: Die Hilfe nennt keine. Es sind Meter (GetBasePoint lieferte die Lage der Lasche, 60/0/20 mm, und GetTransform die Abstände der Skizzenpunkte).
Mehr dazu: Die Hilfe verweist auf das Thema „Pattern Features and their Feature Data Objects“. Der ältere Befehl FeatureManager.FeatureLocalSketchDrivenPattern ist veraltet, Nachfolger ist FeatureManager.CreateFeature.
LocalSketchPatternFeatureData.PatternComponentArray liefert Features, keine Component2. Weist du die Einträge einer Variablen vom Typ Component2 zu, bricht das Makro mit Fehler 13 („Typen unverträglich“) ab; die Komponente holst du mit Feature.GetSpecificFeature2.
Eigenschaften und Methoden
Eigenschaften 6, davon 6 beschrieben
| Name | Beschreibung |
|---|---|
| ForceUseSeedConfiguration | Liest oder setzt, ob die gemusterten Komponenten immer dieselbe Konfiguration haben wie die Ausgangskomponente. |
| PatternComponentArray | Liest oder setzt die Komponenten, die das skizzengesteuerte Komponentenmuster vervielfältigt (Ausgangskomponenten). |
| ReferencePoint | Liest oder setzt die Art des Referenzpunkts: Mitte des Begrenzungsrahmens, Ursprung der Komponente oder gewählter Punkt. |
| SelectedPoint | Liest oder setzt den gewählten Punkt, wenn der Referenzpunkt des skizzengesteuerten Komponentenmusters ein gewählter Punkt ist. |
| Sketch | Liest oder setzt die Skizze, an deren Punkte das skizzengesteuerte Komponentenmuster die Instanzen setzt. |
| SkippedItemArray | Liest oder setzt die Nummern der Instanzen, die das skizzengesteuerte Komponentenmuster auslässt. |
Methoden 7, davon 7 beschrieben
| Name | Beschreibung |
|---|---|
| AccessSelections | Setzt das Modell vor das skizzengesteuerte Komponentenmuster zurück, damit du die Auswahlen lesen und ändern kannst, die es festlegen. |
| GetBasePoint | Liefert den Basispunkt, von dem aus das skizzengesteuerte Komponentenmuster erzeugt wird. |
| GetPatternComponentCount | Liefert die Zahl der Komponenten des skizzengesteuerten Komponentenmusters. |
| GetReferencePointType | Liefert die Art des Referenzpunkts des skizzengesteuerten Komponentenmusters. |
| GetSkippedItemCount | Liefert, wie viele Instanzen das skizzengesteuerte Komponentenmuster auslässt. |
| GetTransform | Liefert die Transformation einer Instanz des skizzengesteuerten Komponentenmusters. |
| ReleaseSelectionAccess | Hebt den Rücksetz-Zustand nach AccessSelections wieder auf, wenn du das skizzengesteuerte Komponentenmuster nicht geändert hast. |
Siehe auch
Englisches Original: ILocalSketchPatternFeatureData in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)
Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.