SolidWorksMakroprogrammierung

Objekt · SldWorks

LocalSketchPatternFeatureData-Objekt

Die Definition eines skizzengesteuerten Komponentenmusters in einer Baugruppe: Ausgangskomponenten, Skizze mit den Punkten der Instanzen und Referenzpunkt.

Deklaration Dim x As SldWorks.LocalSketchPatternFeatureData · in der englischen .NET-Hilfe: ILocalSketchPatternFeatureData

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

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 Sub

Bemerkungen

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

NameBeschreibung
ForceUseSeedConfigurationLiest oder setzt, ob die gemusterten Komponenten immer dieselbe Konfiguration haben wie die Ausgangskomponente.
PatternComponentArrayLiest oder setzt die Komponenten, die das skizzengesteuerte Komponentenmuster vervielfältigt (Ausgangskomponenten).
ReferencePointLiest oder setzt die Art des Referenzpunkts: Mitte des Begrenzungsrahmens, Ursprung der Komponente oder gewählter Punkt.
SelectedPointLiest oder setzt den gewählten Punkt, wenn der Referenzpunkt des skizzengesteuerten Komponentenmusters ein gewählter Punkt ist.
SketchLiest oder setzt die Skizze, an deren Punkte das skizzengesteuerte Komponentenmuster die Instanzen setzt.
SkippedItemArrayLiest oder setzt die Nummern der Instanzen, die das skizzengesteuerte Komponentenmuster auslässt.

Methoden 7, davon 7 beschrieben

NameBeschreibung
AccessSelectionsSetzt das Modell vor das skizzengesteuerte Komponentenmuster zurück, damit du die Auswahlen lesen und ändern kannst, die es festlegen.
GetBasePointLiefert den Basispunkt, von dem aus das skizzengesteuerte Komponentenmuster erzeugt wird.
GetPatternComponentCountLiefert die Zahl der Komponenten des skizzengesteuerten Komponentenmusters.
GetReferencePointTypeLiefert die Art des Referenzpunkts des skizzengesteuerten Komponentenmusters.
GetSkippedItemCountLiefert, wie viele Instanzen das skizzengesteuerte Komponentenmuster auslässt.
GetTransformLiefert die Transformation einer Instanz des skizzengesteuerten Komponentenmusters.
ReleaseSelectionAccessHebt 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.