Objekt · SldWorks
GeneralTableFeature-Objekt
Das Feature einer allgemeinen Tabelle: der Eintrag im FeatureManager und die zugehörigen Tabellen.
Beschreibung
GeneralTableFeature gibt Zugriff auf das Feature einer allgemeinen Tabelle (general table), also einer Tabelle, die du frei mit Text füllst. Das Feature steht im FeatureManager der Zeichnung und verbindet den Eintrag dort (Feature) mit den Tabellen auf dem Blatt (GeneralTableAnnotation). Die Befehle gibt es seit SOLIDWORKS 2006.
Zugriff
So bekommst du das Objekt:
SelectionMgr.GetSelectedObject6: wenn das Feature im FeatureManager der Zeichnung ausgewählt ist, etwa mitModelDocExtension.SelectByID2und dem TypGENERALTABLEFEAT(swSelGENERALTABLEFEAT,swSelectType_e)TableAnnotation.GeneralTableFeature: aus einer Tabelle, etwa ausDrawingDoc.InsertTableAnnotation2GeneralTableAnnotation.GeneralTable: aus einer allgemeinen Tabelle
Beispiel
' Fügt in die aktive Zeichnung eine allgemeine Tabelle mit 2 Zeilen und 2 Spalten ein
' und gibt den Namen ihres Features und die Daten seiner Tabellen aus.
' Vorbedingung: Eine Zeichnung ist offen.
' Ergebnis: Die Tabelle steht auf dem Blatt, die Angaben stehen im
' Direktfenster (Strg+G).
Option Explicit
Sub main()
Dim swApp As SldWorks.SldWorks
Dim swModel As SldWorks.ModelDoc2
Dim swDraw As SldWorks.DrawingDoc
Dim swTabelle As SldWorks.TableAnnotation
Dim swTabFeat As SldWorks.GeneralTableFeature
Dim vTabellen As Variant
Dim i As Long
Set swApp = Application.SldWorks
Set swModel = swApp.ActiveDoc
If swModel Is Nothing Then Exit Sub
If swModel.GetType <> swDocDRAWING Then Exit Sub
Set swDraw = swModel
Set swTabelle = swDraw.InsertTableAnnotation2(False, 0.03, 0.13, swBOMConfigurationAnchor_TopLeft, "", 2, 2)
If swTabelle Is Nothing Then Exit Sub
Set swTabFeat = swTabelle.GeneralTableFeature
If swTabFeat Is Nothing Then Exit Sub
Debug.Print "Feature: " & swTabFeat.GetFeature.Name
Debug.Print swTabFeat.GetTableAnnotationCount & " Tabelle(n)"
vTabellen = swTabFeat.GetTableAnnotations
If IsArray(vTabellen) Then
For i = 0 To UBound(vTabellen)
Set swTabelle = vTabellen(i)
Debug.Print " Tabelle " & i + 1 & ": " & swTabelle.RowCount & " Zeilen, " & _
swTabelle.ColumnCount & " Spalten, verankert: " & swTabelle.Anchored
Next i
End If
End SubBemerkungen
Hilfebeispiele: „Get General Table Feature“ fügt mit DrawingDoc.InsertTableAnnotation2 eine Tabelle ein, wählt das Feature mit ModelDocExtension.SelectByID2 als "General Table1" und Typ GENERALTABLEFEAT aus und weist das Ergebnis von SelectionMgr.GetSelectedObject6 direkt einer Variablen vom Typ GeneralTableFeature zu. Dann gibt es den Namen des Features und für jede Tabelle Verankerung, Ankertyp, Spalten- und Zeilenzahl aus. „Hide and Show Row“ holt die erste Tabelle des ausgewählten Features und blendet mit TableAnnotation.RowHidden ihre dritte Zeile aus und wieder ein.
Tabellen: GeneralTableFeature.GetTableAnnotations liefert allgemeine Tabellen. Beide Hilfebeispiele weisen sie einer Variablen vom Typ TableAnnotation zu und lesen darüber Zeilen und Spalten. Eine allgemeine Tabelle hat den Typ swTableAnnotation_General (swTableAnnotationType_e). Sortieren kannst du sie über GeneralTableAnnotation.
Vorlage: Eine Vorlage für allgemeine Tabellen hat die Endung .sldtbt. SOLIDWORKS liefert für allgemeine Tabellen keine Vorlagen mit. Ohne Vorlage übergibst du bei DrawingDoc.InsertTableAnnotation2 einen leeren Text, so im Hilfebeispiel. Die Lage im Beispiel oben ist in Metern, die Werte sind nur ein Vorschlag.
In Teilen und Baugruppen: Eine allgemeine Tabelle fügst du dort mit ModelDocExtension.InsertGeneralTableAnnotation ein. Ob ihr Feature dort ebenfalls eine GeneralTableFeature ist, sagt die Hilfe nicht. Sie nennt den Zugriff über die Auswahl nur für den FeatureManager der Zeichnung.
Eigenschaften und Methoden
Methoden 3, davon 3 beschrieben
| Name | Beschreibung |
|---|---|
| GetFeature | Liefert das Feature der allgemeinen Tabelle im FeatureManager. |
| GetTableAnnotationCount | Liefert die Zahl der Tabellen, die zu diesem Feature gehören. |
| GetTableAnnotations | Liefert die Tabellen, die zu diesem Feature gehören. |
Nicht aufgeführt sind 1 C++-Varianten (Namen mit I davor, zum Beispiel IGetTableAnnotations). In VBA nimmst du immer den Befehl ohne I.
Siehe auch
Englisches Original: IGeneralTableFeature in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)
Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.