SolidWorksMakroprogrammierung

Objekt · SldWorks

TablePatternFeatureData-Objekt

Die Definition eines tabellengesteuerten Musters: Ausgangselemente, Koordinatensystem, Bezugspunkt und die Punkte der Instanzen aus der Tabelle.

Deklaration Dim x As SldWorks.TablePatternFeatureData · in der englischen .NET-Hilfe: ITablePatternFeatureData

Beschreibung

TablePatternFeatureData gibt Zugriff auf ein tabellengesteuertes Muster. Es setzt Kopien von Features, Flächen oder Körpern an Punkte, deren Koordinaten in einer Tabelle stehen, bezogen auf ein Koordinatensystem. Welcher Punkt des Ausgangselements an diese Stellen kommt, legt der Bezugspunkt fest. Die Punkte kannst du aus einer Datei (*.sldptab) laden und in eine speichern. Die meisten Befehle gibt es seit SOLIDWORKS 2001.

Zugriff

Beispiel

' Gibt Koordinatensystem, Zahl der Ausgangsfeatures und die Punkte des ausgewählten
' tabellengesteuerten Musters aus.
' Vorbedingung: Ein Teil mit einem tabellengesteuerten Muster ist offen, das Muster ist
'               im FeatureManager ausgewählt (etwa tablepattern.sldprt aus den Beispielen).
' Ergebnis:     Die Angaben 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.TablePatternFeatureData
    Dim swKoord As SldWorks.Feature
    Dim vPunkte As Variant
    Dim i As Long

    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 <> "TablePattern" Then Exit Sub

    Set swDaten = swFeat.GetDefinition
    If False = swDaten.AccessSelections(swModel, Nothing) Then Exit Sub
    Set swKoord = swDaten.CoordinateSystem
    Debug.Print swFeat.Name & ", Koordinatensystem " & swKoord.Name
    Debug.Print "  " & swDaten.GetPatternFeatureCount & " Ausgangsfeature(s), Schwerpunkt als Bezug: " & swDaten.UseCentroid
    vPunkte = swDaten.PointArray
    For i = 0 To (UBound(vPunkte) + 1) \ 3 - 1        ' GetPointCount zählt in 2024 die Koordinaten, nicht die Punkte
        Debug.Print "  Punkt " & i + 1 & ": " & vPunkte(3 * i) * 1000 & ", " & _
                    vPunkte(3 * i + 1) * 1000 & ", " & vPunkte(3 * i + 2) * 1000 & " mm"
    Next i
    swDaten.ReleaseSelectionAccess
End Sub

Bemerkungen

Anlegen: Wähle vor FeatureManager.CreateDefinition aus: die Ausgangsfeatures mit der Markierung 4, das Koordinatensystem mit 16, den Bezugspunkt mit 32, Ausgangsflächen mit 128 und Ausgangskörper mit 256. Dann setzt du die Werte, etwa die Punkte, und legst das Muster mit FeatureManager.CreateFeature an. So macht es das Hilfebeispiel „ITablePatternFeatureData“.

Ändern: Nach TablePatternFeatureData.AccessSelections setzt du die Werte und rufst Feature.ModifyDefinition auf. Änderst du nichts, rufst du TablePatternFeatureData.ReleaseSelectionAccess auf.

Punkte: Die Punkte aus TablePatternFeatureData.PointArray beziehen sich auf das Koordinatensystem des Musters. Das Hilfebeispiel „Get Points of Repeating Elements in Table-driven Pattern“ rechnet sie mit der Transformation des Koordinatensystems um.

Einheiten: Für die Punkte nennt die Hilfe keine Einheit. Vermutlich sind es Meter, das Hilfebeispiel setzt etwa 0.04 und die Beispiele rechnen mit 1000 in Millimeter um.

Mehr dazu: Die Hilfe verweist auf das Thema „Pattern Features and their Feature Data Objects“ und auf „Table Driven Patterns“ in der Hilfe zur Oberfläche.

Eigenschaften und Methoden

Eigenschaften 10, davon 10 beschrieben

NameBeschreibung
CoordinateSystemLiest oder setzt das Koordinatensystem, auf das sich die Punkte des tabellengesteuerten Musters beziehen.
GeometryPatternLiest oder setzt, ob das tabellengesteuerte Muster nur die Geometrie der Features kopiert.
PatternBodyArrayLiest oder setzt die Körper, die das tabellengesteuerte Muster vervielfältigt.
PatternFaceArrayLiest oder setzt die Flächen, die das tabellengesteuerte Muster vervielfältigt.
PatternFeatureArrayLiest oder setzt die Features, die das tabellengesteuerte Muster vervielfältigt.
PointArrayLiest oder setzt die Punkte, an denen die Instanzen des tabellengesteuerten Musters sitzen.
PropagateVisualPropertyLiest oder setzt, ob Farben, Texturen und andere Darstellungseigenschaften auf die Instanzen übertragen werden.
ReferencePointLiest oder setzt den Bezugspunkt, der auf die Punkte des tabellengesteuerten Musters gelegt wird.
SkippedItemArrayLiest oder setzt die Instanzen, die das tabellengesteuerte Muster auslässt.
UseCentroidLiest oder setzt, ob der Schwerpunkt des Ausgangsfeatures als Bezugspunkt dient.

Methoden 12, davon 12 beschrieben

NameBeschreibung
AccessSelectionsSetzt das Modell vor das tabellengesteuerte Muster zurück, damit du die Auswahlen lesen und ändern kannst, die es festlegen.
GetBasePointLiefert den Basispunkt des tabellengesteuerten Musters.
GetPatternBodyCountLiefert die Zahl der Körper, die das tabellengesteuerte Muster vervielfältigt.
GetPatternFaceCountLiefert die Zahl der Flächen, die das tabellengesteuerte Muster vervielfältigt.
GetPatternFeatureCountLiefert die Zahl der verschiedenen Features, die das tabellengesteuerte Muster vervielfältigt.
GetPointCountLiefert die Zahl der Punkte, an denen die Instanzen des tabellengesteuerten Musters sitzen.
GetReferencePointTypeLiefert, ob der Bezugspunkt des tabellengesteuerten Musters eine geschlossene Kurve, ein Skizzenpunkt oder ein Eckpunkt ist.
GetSkippedItemCountLiefert die Zahl der Instanzen, die das tabellengesteuerte Muster auslässt.
GetTransformLiefert die Transformation einer Instanz des tabellengesteuerten Musters.
LoadPointsFromFileLädt die Punkte des tabellengesteuerten Musters aus einer Datei (*.sldptab).
ReleaseSelectionAccessHebt den Rücksetz-Zustand nach AccessSelections wieder auf, wenn du das tabellengesteuerte Muster nicht geändert hast.
SavePointsToFileSpeichert die Punkte des tabellengesteuerten Musters in eine Datei (*.sldptab).

Nicht aufgeführt sind 13 C++-Varianten (Namen mit I davor, zum Beispiel IAccessSelections). In VBA nimmst du immer den Befehl ohne I.

Siehe auch

Englisches Original: ITablePatternFeatureData in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)

Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.