Objekt · SldWorks
TablePatternFeatureData-Objekt
Die Definition eines tabellengesteuerten Musters: Ausgangselemente, Koordinatensystem, Bezugspunkt und die Punkte der Instanzen aus der Tabelle.
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
FeatureManager.CreateDefinitionmitswFmTablePattern: eine neue Definition fürFeatureManager.CreateFeatureFeature.GetDefinition: bei einem Feature mit dem TypnamenTablePattern
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 SubBemerkungen
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
| Name | Beschreibung |
|---|---|
| CoordinateSystem | Liest oder setzt das Koordinatensystem, auf das sich die Punkte des tabellengesteuerten Musters beziehen. |
| GeometryPattern | Liest oder setzt, ob das tabellengesteuerte Muster nur die Geometrie der Features kopiert. |
| PatternBodyArray | Liest oder setzt die Körper, die das tabellengesteuerte Muster vervielfältigt. |
| PatternFaceArray | Liest oder setzt die Flächen, die das tabellengesteuerte Muster vervielfältigt. |
| PatternFeatureArray | Liest oder setzt die Features, die das tabellengesteuerte Muster vervielfältigt. |
| PointArray | Liest oder setzt die Punkte, an denen die Instanzen des tabellengesteuerten Musters sitzen. |
| PropagateVisualProperty | Liest oder setzt, ob Farben, Texturen und andere Darstellungseigenschaften auf die Instanzen übertragen werden. |
| ReferencePoint | Liest oder setzt den Bezugspunkt, der auf die Punkte des tabellengesteuerten Musters gelegt wird. |
| SkippedItemArray | Liest oder setzt die Instanzen, die das tabellengesteuerte Muster auslässt. |
| UseCentroid | Liest oder setzt, ob der Schwerpunkt des Ausgangsfeatures als Bezugspunkt dient. |
Methoden 12, davon 12 beschrieben
| Name | Beschreibung |
|---|---|
| AccessSelections | Setzt das Modell vor das tabellengesteuerte Muster zurück, damit du die Auswahlen lesen und ändern kannst, die es festlegen. |
| GetBasePoint | Liefert den Basispunkt des tabellengesteuerten Musters. |
| GetPatternBodyCount | Liefert die Zahl der Körper, die das tabellengesteuerte Muster vervielfältigt. |
| GetPatternFaceCount | Liefert die Zahl der Flächen, die das tabellengesteuerte Muster vervielfältigt. |
| GetPatternFeatureCount | Liefert die Zahl der verschiedenen Features, die das tabellengesteuerte Muster vervielfältigt. |
| GetPointCount | Liefert die Zahl der Punkte, an denen die Instanzen des tabellengesteuerten Musters sitzen. |
| GetReferencePointType | Liefert, ob der Bezugspunkt des tabellengesteuerten Musters eine geschlossene Kurve, ein Skizzenpunkt oder ein Eckpunkt ist. |
| GetSkippedItemCount | Liefert die Zahl der Instanzen, die das tabellengesteuerte Muster auslässt. |
| GetTransform | Liefert die Transformation einer Instanz des tabellengesteuerten Musters. |
| LoadPointsFromFile | Lädt die Punkte des tabellengesteuerten Musters aus einer Datei (*.sldptab). |
| ReleaseSelectionAccess | Hebt den Rücksetz-Zustand nach AccessSelections wieder auf, wenn du das tabellengesteuerte Muster nicht geändert hast. |
| SavePointsToFile | Speichert 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.