Objekt · SldWorks
SketchPatternFeatureData-Objekt
Die Definition eines skizzengesteuerten Musters: Ausgangselemente, Skizze mit den Punkten der Instanzen und Referenzpunkt.
Beschreibung
SketchPatternFeatureData gibt Zugriff auf ein skizzengesteuertes Muster in einem Teil. Es vervielfältigt Features, Flächen oder Körper an die Skizzenpunkte einer Skizze. Welcher Punkt des Ausgangselements auf den Skizzenpunkten landet, legt der Referenzpunkt fest: der Schwerpunkt oder ein gewählter Punkt. Die meisten Befehle gibt es seit SOLIDWORKS 2001.
Zugriff
FeatureManager.CreateDefinitionmitswFmSketchPattern: eine neue Definition fürFeatureManager.CreateFeatureFeature.GetDefinition: bei einem Feature mit dem TypnamenSketchPattern
Beispiel
' Gibt Skizze, Ausgangselemente, Referenzpunkt und Basispunkt des ausgewählten
' skizzengesteuerten Musters aus.
' Vorbedingung: Ein Teil mit einem skizzengesteuerten Muster ist offen, das Muster ist im
' FeatureManager ausgewählt.
' Ergebnis: Die Werte stehen im Direktfenster, das Teil 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.SketchPatternFeatureData
Dim swSketch As SldWorks.Sketch
Dim swSkizzenFeat As SldWorks.Feature
Dim vBasis As Variant
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 <> "SketchPattern" 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"
Debug.Print " " & swDaten.GetPatternFeatureCount & " Features, " & swDaten.GetPatternFaceCount & _
" Flächen, " & swDaten.GetPatternBodyCount & " Körper"
If swDaten.UseCentroid Then
Debug.Print " Referenzpunkt: Schwerpunkt"
Else
Debug.Print " Referenzpunkt: Art " & swDaten.GetReferencePointType
End If
vBasis = swDaten.GetBasePoint
Debug.Print " Basispunkt: " & vBasis(0) * 1000 & ", " & vBasis(1) * 1000 & ", " & vBasis(2) * 1000 & " mm"
swDaten.ReleaseSelectionAccess
End SubBemerkungen
Anlegen: Vor FeatureManager.CreateDefinition wählst du mit ModelDocExtension.SelectByID2 aus: Features mit der Markierung 4, Punkte mit 32, Skizzen mit 64, Flächen mit 128 und Körper mit 256. Danach setzt du die übrigen Werte und legst das Muster mit FeatureManager.CreateFeature an. Das Hilfebeispiel „Get Properties of Sketch Pattern Feature“ wählt ein Feature mit 4 und die Skizze mit 64 aus, setzt GeometryPattern auf False und UseCentroid auf True. In diesem Absatz spricht die Hilfe versehentlich von einem Kreismuster.
Ändern: Nach SketchPatternFeatureData.AccessSelections setzt du die Werte und rufst Feature.ModifyDefinition auf. Änderst du nichts, rufst du SketchPatternFeatureData.ReleaseSelectionAccess auf.
Was gemustert wird: SketchPatternFeatureData.BodyPattern entscheidet zwischen Körpern und Features oder Flächen. Mit SketchPatternFeatureData.GeometryPattern und SketchPatternFeatureData.SetFeatureScope legst du in Mehrkörperteilen fest, welche Körper das Muster beeinflusst.
Einheiten: Die Hilfe nennt keine. Das Hilfebeispiel rechnet den Basispunkt mit 1000 in Millimeter um, also Meter.
Mehr dazu: Die Hilfe verweist auf das Thema „Pattern Features and their Feature Data Objects“ und auf „Sketch Driven Patterns“ in der Hilfe zur Oberfläche.
Eigenschaften und Methoden
Eigenschaften 13, davon 13 beschrieben
| Name | Beschreibung |
|---|---|
| AutoSelect | Liefert, ob das skizzengesteuerte Muster in einem Mehrkörperteil automatisch alle Körper beeinflusst, die es schneidet. |
| BodyPattern | Liest oder setzt, ob das skizzengesteuerte Muster Körper vervielfältigt oder Features und Flächen. |
| FeatureScope | Liefert, ob das skizzengesteuerte Muster in einem Mehrkörperteil nur bestimmte Körper beeinflusst. |
| FeatureScopeBodies | Liefert die Körper eines Mehrkörperteils, die das skizzengesteuerte Muster beeinflusst. |
| GeometryPattern | Liest oder setzt, ob das skizzengesteuerte Muster nur die Geometrie (Flächen und Kanten) der Features vervielfältigt. |
| PatternBodyArray | Liest oder setzt die Körper, die das skizzengesteuerte Muster vervielfältigt. |
| PatternElement | Liest oder setzt, ob das skizzengesteuerte Muster Features und Flächen oder Körper vervielfältigt. |
| PatternFaceArray | Liest oder setzt die Flächen, die das skizzengesteuerte Muster vervielfältigt. |
| PatternFeatureArray | Liest oder setzt die Features, die das skizzengesteuerte Muster vervielfältigt (Ausgangsfeatures). |
| PropagateVisualProperty | Liest oder setzt, ob sichtbare Eigenschaften wie Farben auf alle Instanzen übertragen werden. |
| ReferencePoint | Liest oder setzt den Referenzpunkt des skizzengesteuerten Musters, wenn es nicht den Schwerpunkt nutzt. |
| Sketch | Liest oder setzt die Skizze, an deren Punkte das skizzengesteuerte Muster die Instanzen setzt. |
| UseCentroid | Liest oder setzt, ob das skizzengesteuerte Muster den Schwerpunkt als Referenzpunkt nimmt. |
Methoden 9, davon 9 beschrieben
| Name | Beschreibung |
|---|---|
| AccessSelections | Setzt das Modell vor das skizzengesteuerte Muster zurück, damit du die Auswahlen lesen und ändern kannst, die es festlegen. |
| GetBasePoint | Liefert den Basispunkt, von dem aus das skizzengesteuerte Muster erzeugt wird. |
| GetPatternBodyCount | Liefert die Zahl der Körper, die das skizzengesteuerte Muster vervielfältigt. |
| GetPatternFaceCount | Liefert die Zahl der Flächen, die das skizzengesteuerte Muster vervielfältigt. |
| GetPatternFeatureCount | Liefert die Zahl der Features, die das skizzengesteuerte Muster vervielfältigt. |
| GetReferencePointType | Liefert die Art des Referenzpunkts: Schwerpunkt, geschlossene Kurve, Skizzenpunkt oder Eckpunkt. |
| GetTransform | Liefert die Transformation einer Instanz des skizzengesteuerten Musters. |
| ReleaseSelectionAccess | Hebt den Rücksetz-Zustand nach AccessSelections wieder auf, wenn du das skizzengesteuerte Muster nicht geändert hast. |
| SetFeatureScope | Legt fest, welche Körper eines Mehrkörperteils das skizzengesteuerte 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: ISketchPatternFeatureData in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)
Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.