SolidWorksMakroprogrammierung

Objekt · SldWorks

SketchPatternFeatureData-Objekt

Die Definition eines skizzengesteuerten Musters: Ausgangselemente, Skizze mit den Punkten der Instanzen und Referenzpunkt.

Deklaration Dim x As SldWorks.SketchPatternFeatureData · in der englischen .NET-Hilfe: ISketchPatternFeatureData

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

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 Sub

Bemerkungen

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

NameBeschreibung
AutoSelectLiefert, ob das skizzengesteuerte Muster in einem Mehrkörperteil automatisch alle Körper beeinflusst, die es schneidet.
BodyPatternLiest oder setzt, ob das skizzengesteuerte Muster Körper vervielfältigt oder Features und Flächen.
FeatureScopeLiefert, ob das skizzengesteuerte Muster in einem Mehrkörperteil nur bestimmte Körper beeinflusst.
FeatureScopeBodiesLiefert die Körper eines Mehrkörperteils, die das skizzengesteuerte Muster beeinflusst.
GeometryPatternLiest oder setzt, ob das skizzengesteuerte Muster nur die Geometrie (Flächen und Kanten) der Features vervielfältigt.
PatternBodyArrayLiest oder setzt die Körper, die das skizzengesteuerte Muster vervielfältigt.
PatternElementLiest oder setzt, ob das skizzengesteuerte Muster Features und Flächen oder Körper vervielfältigt.
PatternFaceArrayLiest oder setzt die Flächen, die das skizzengesteuerte Muster vervielfältigt.
PatternFeatureArrayLiest oder setzt die Features, die das skizzengesteuerte Muster vervielfältigt (Ausgangsfeatures).
PropagateVisualPropertyLiest oder setzt, ob sichtbare Eigenschaften wie Farben auf alle Instanzen übertragen werden.
ReferencePointLiest oder setzt den Referenzpunkt des skizzengesteuerten Musters, wenn es nicht den Schwerpunkt nutzt.
SketchLiest oder setzt die Skizze, an deren Punkte das skizzengesteuerte Muster die Instanzen setzt.
UseCentroidLiest oder setzt, ob das skizzengesteuerte Muster den Schwerpunkt als Referenzpunkt nimmt.

Methoden 9, davon 9 beschrieben

NameBeschreibung
AccessSelectionsSetzt das Modell vor das skizzengesteuerte Muster zurück, damit du die Auswahlen lesen und ändern kannst, die es festlegen.
GetBasePointLiefert den Basispunkt, von dem aus das skizzengesteuerte Muster erzeugt wird.
GetPatternBodyCountLiefert die Zahl der Körper, die das skizzengesteuerte Muster vervielfältigt.
GetPatternFaceCountLiefert die Zahl der Flächen, die das skizzengesteuerte Muster vervielfältigt.
GetPatternFeatureCountLiefert die Zahl der Features, die das skizzengesteuerte Muster vervielfältigt.
GetReferencePointTypeLiefert die Art des Referenzpunkts: Schwerpunkt, geschlossene Kurve, Skizzenpunkt oder Eckpunkt.
GetTransformLiefert die Transformation einer Instanz des skizzengesteuerten Musters.
ReleaseSelectionAccessHebt den Rücksetz-Zustand nach AccessSelections wieder auf, wenn du das skizzengesteuerte Muster nicht geändert hast.
SetFeatureScopeLegt 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.