Objekt · SldWorks
TableAnnotation-Objekt
Steht für eine Tabelle in einer Zeichnung: Stückliste, Bohrungs-, Revisions- oder allgemeine Tabelle. Zellen, Zeilen, Spalten, Format und Export.
Beschreibung
TableAnnotation ist die gemeinsame Sicht auf alle Tabellen: Stücklisten, Bohrungstabellen, Revisionstabellen, allgemeine Tabellen und weitere. Welche Art es ist, liefert TableAnnotation.Type. Hier liest und änderst du Zellen, fügst Zeilen und Spalten ein, formatierst und speicherst die Tabelle. Lage und Sichtbarkeit stehen bei der zugehörigen Annotation (TableAnnotation.GetAnnotation).
Zugriff
View.GetFirstTableAnnotation2und dannTableAnnotation.GetNext: alle Tabellen einer Zeichenansicht oder eines BlattsView.GetTableAnnotations: alle Tabellen einer Zeichenansicht als ArrayDrawingDoc.InsertTableAnnotation2undModelDocExtension.InsertGeneralTableAnnotation: eine neue TabelleModelDocExtension.GetGeneralTableAnnotationundModelDocExtension.InsertTitleBlockTable: allgemeine Tabellen und Schriftfeld-TabellenGeneralTableFeature.GetTableAnnotations: die Tabellen eines Tabellen-FeaturesTableAnnotation.SplitundTableAnnotation.HorizontalAutoSplit: die Teilstücke einer geteilten Tabelle
Beispiel
' Speichert jede Tabelle der aktiven Zeichnung als eigene CSV-Datei neben der Zeichnung.
' Vorbedingung: Eine gespeicherte Zeichnung mit Tabellen ist geöffnet.
' Ergebnis: Je Tabelle eine Datei Zeichnung_Tabelle1.csv usw. im Ordner der Zeichnung.
Option Explicit
Sub main()
Dim swApp As SldWorks.SldWorks
Dim swModel As SldWorks.ModelDoc2
Dim swDraw As SldWorks.DrawingDoc
Dim swView As SldWorks.View
Dim swTable As SldWorks.TableAnnotation
Dim sBasis As String
Dim nNr As Long
Set swApp = Application.SldWorks
Set swModel = swApp.ActiveDoc
If swModel Is Nothing Then Exit Sub
If swModel.GetType <> swDocDRAWING Then Exit Sub
If swModel.GetPathName = "" Then Exit Sub
Set swDraw = swModel
sBasis = Left(swModel.GetPathName, InStrRev(swModel.GetPathName, ".") - 1)
Set swView = swDraw.GetFirstView ' zuerst das Blatt selbst
Do While Not swView Is Nothing
Set swTable = swView.GetFirstTableAnnotation ' ab SOLIDWORKS 2025 SP01: GetFirstTableAnnotation2
Do While Not swTable Is Nothing
nNr = nNr + 1
If swTable.SaveAsText2(sBasis & "_Tabelle" & nNr & ".csv", ";", False) Then
Debug.Print "Gespeichert: Tabelle " & nNr & " (Art " & swTable.Type & ", " & _
swTable.RowCount & " Zeilen)"
End If
Set swTable = swTable.GetNext
Loop
Set swView = swView.GetNextView
Loop
End SubBemerkungen
Nummern von Zeilen und Spalten beginnen überall bei 0. Ob ausgeblendete mitzählen, regelt bei neueren Befehlen der Parameter IncludeHidden. Bei älteren sagt die Hilfe es meist nicht. Die Kopfzeilen zählen mit.
Einheiten: Breiten, Höhen und Abstände sind in Systemeinheiten, also Metern. Ausnahme: Die eigenen Linienstärken TableAnnotation.BorderLineWeightCustom und TableAnnotation.GridLineWeightCustom sind in Millimetern.
Große Tabellen füllen: Nach jeder geänderten Zelle baut sich die Tabelle neu auf. Nach TableAnnotation.Text2 geht es schneller, wenn du sie vorher mit Annotation.Visible ausblendest und danach wieder einblendest.
Löschen: TableAnnotation.DeleteRow2 und TableAnnotation.DeleteColumn2 löschen die ganze Tabelle, wenn es die letzte Zeile oder Spalte ist.
Besondere Tabellen: Für Stücklisten, Bohrungs- und Revisionstabellen gibt es zusätzlich BomTableAnnotation, HoleTableAnnotation und RevisionTableAnnotation mit Befehlen nur für diese Art.
Eigenschaften und Methoden
Eigenschaften 26, davon 24 beschrieben, 2 veraltet
| Name | Beschreibung |
|---|---|
| Anchored | Liest oder setzt, ob eine Tabelle an ihrem Ankerpunkt im Blattformat hängt. |
| AnchorType | Liest oder setzt, mit welcher Ecke eine Tabelle an ihrem Ankerpunkt hängt. |
| BorderLineWeight | Liest oder setzt die Linienstärke des Außenrahmens einer Tabelle. |
| BorderLineWeightCustom | Liest oder setzt eine eigene Linienstärke für den Außenrahmen einer Tabelle, in Millimetern. |
| CellTextHorizontalJustification | Liest oder setzt die waagrechte Ausrichtung des Texts in einer Zelle einer Tabelle. |
| CellTextVerticalJustification | Liest oder setzt die senkrechte Ausrichtung des Texts in einer Zelle einer Tabelle. |
| ColumnCount | Liefert die Anzahl der sichtbaren Spalten einer Tabelle. |
| ColumnHidden | Liest oder setzt, ob eine Spalte einer Tabelle ausgeblendet ist. |
| DisplayedText | veraltet ersetzt durch TableAnnotation.DisplayedText2 |
| DisplayedText2 | Liefert den Text, der in einer Zelle einer Tabelle angezeigt wird, mit den Werten verknüpfter Eigenschaften. |
| GeneralTableFeature | Liefert das Feature einer allgemeinen Tabelle. |
| GridLineWeight | Liest oder setzt die Linienstärke der Innenlinien einer Tabelle. |
| GridLineWeightCustom | Liest oder setzt eine eigene Linienstärke für die Innenlinien einer Tabelle, in Millimetern. |
| RowCount | Liefert die Anzahl der sichtbaren Zeilen einer Tabelle. |
| RowHidden | Liest oder setzt, ob eine Zeile einer Tabelle ausgeblendet ist. |
| StopAutoSplitting | Liest oder setzt, ob das automatische waagrechte Teilen einer Tabelle angehalten ist. |
| Text | veraltet ersetzt durch TableAnnotation.Text2 |
| Text2 | Liest oder setzt den Text einer Zelle einer Tabelle, mit Verknüpfungen statt ihrer Werte. |
| TextHorizontalJustification | Liest oder setzt die waagrechte Ausrichtung des Texts für die ganze Tabelle. |
| TextVerticalJustification | Liest oder setzt die senkrechte Ausrichtung des Texts für die ganze Tabelle. |
| Title | Liest oder setzt den Titel einer Tabelle. |
| TitleVisible | Liest oder setzt, ob der Titel einer Tabelle angezeigt wird. |
| TotalColumnCount | Liefert die Anzahl aller Spalten einer Tabelle, sichtbare und ausgeblendete. |
| TotalRowCount | Liefert die Anzahl aller Zeilen einer Tabelle, sichtbare und ausgeblendete. |
| Type | Liefert die Art einer Tabelle: allgemeine Tabelle, Stückliste, Bohrungstabelle, Revisionstabelle und mehr. |
| UpperCase | Liest oder setzt, ob der Text einer Tabelle in Großbuchstaben angezeigt wird. 1 ja, 0 nein. |
Methoden 59, davon 49 beschrieben, 10 veraltet
| Name | Beschreibung |
|---|---|
| DeleteColumn | veraltet ersetzt durch TableAnnotation.DeleteColumn2 |
| DeleteColumn2 | Löscht eine Spalte einer Tabelle. Bei der letzten Spalte verschwindet die ganze Tabelle. |
| DeleteRow | veraltet ersetzt durch TableAnnotation.DeleteRow2 |
| DeleteRow2 | Löscht eine Zeile einer Tabelle. Bei der letzten Zeile verschwindet die ganze Tabelle. |
| EvaluateCellEquation | Rechnet eine Gleichung in einer Zelle einer Stückliste aus, ohne sie zu setzen, oder entfernt sie. |
| GetAnnotation | Liefert die Beschriftung (Annotation) zu einer Tabelle, mit Lage, Layer und Sichtbarkeit. |
| GetCellEquation | Liefert die Gleichung einer Zelle oder Spalte einer Stückliste und ihr Ergebnis. |
| GetCellRange | Liefert den Bereich der ausgewählten Zellen einer Tabelle, oder die ganze Tabelle, wenn keine ausgewählt sind. |
| GetCellTextFormat | Liefert das Textformat einer Zelle einer Tabelle. |
| GetCellTextOrientation | Liefert die Textrichtung in einer Zelle oder in allen Zellen einer Tabelle. |
| GetCellUseDocTextFormat | Liefert, ob eine Zelle einer Tabelle das Textformat aus dem Dokument benutzt. |
| GetColumnTitle | veraltet ersetzt durch TableAnnotation.GetColumnTitle2 |
| GetColumnTitle2 | Liefert die Überschrift einer Spalte einer Tabelle. |
| GetColumnType | veraltet ersetzt durch TableAnnotation.GetColumnType3 |
| GetColumnType2 | veraltet ersetzt durch TableAnnotation.GetColumnType3 |
| GetColumnType3 | Liefert die Art einer Spalte einer Stückliste, etwa Positionsnummer oder Eigenschaft, mit ihren Angaben. |
| GetColumnWidth | Liefert die Breite einer Spalte einer Tabelle, in Metern. |
| GetHeaderCount | Liefert, wie viele Zeilen oder Spalten der Kopf einer Tabelle hat. |
| GetHeaderStyle | Liefert, ob der Kopf einer Tabelle oben, unten oder gar nicht steht. |
| GetLockColumnWidth | Liefert, ob die Breite einer Spalte einer Tabelle gesperrt ist. |
| GetLockRowHeight | Liefert, ob die Höhe einer Zeile einer Tabelle gesperrt ist. |
| GetNext | Liefert die nächste Tabelle einer Zeichenansicht, für eine Schleife über alle Tabellen. |
| GetRowHeight | Liefert die Höhe einer Zeile einer Tabelle, in Metern. |
| GetRowVerticalGap | Liefert den Abstand zwischen Text und Ober- oder Unterkante einer Zeile einer Tabelle. |
| GetSplitInformation | Liefert, ob und wie eine Tabelle geteilt ist, und welche Zeilen dieses Teilstück enthält. |
| GetTextFormat | Liefert das Textformat einer ganzen Tabelle. |
| GetUseDocTextFormat | Liefert, ob eine Tabelle das Textformat aus dem Dokument benutzt. |
| HorizontalAutoSplit | Teilt eine Tabelle automatisch waagrecht, einmal oder laufend, nach einer Höchstzahl von Zeilen. |
| InsertColumn | veraltet ersetzt durch TableAnnotation.InsertColumn2 |
| InsertColumn2 | Fügt eine Spalte in eine Tabelle ein, am Anfang, am Ende oder vor oder nach einer Spalte. |
| InsertRow | Fügt eine Zeile in eine Tabelle ein, am Anfang, am Ende oder vor oder nach einer Zeile. |
| IsCellMerged | Liefert, ob eine Zelle einer Tabelle mit anderen verbunden ist, und mit welcher. |
| IsCellTextEditable | Liefert, ob sich der Text einer Zelle einer Tabelle ändern lässt. |
| Merge | Fügt Teilstücke einer geteilten Tabelle wieder zusammen. |
| MergeCells | Verbindet die Zellen eines Bereichs einer Tabelle zu einer. |
| MoveColumn | Verschiebt eine Spalte einer Tabelle vor oder hinter eine andere Spalte. |
| MoveRow | Verschiebt eine Zeile einer Tabelle um eine Zeile nach oben oder unten. |
| SaveAsPDF | Speichert eine Tabelle als PDF-Datei. Eine vorhandene Datei wird überschrieben. |
| SaveAsTemplate | Speichert das Aussehen einer Tabelle als Tabellenvorlage, etwa .sldbomtbt für Stücklisten. |
| SaveAsText | veraltet ersetzt durch TableAnnotation.SaveAsText2 |
| SaveAsText2 | Speichert den Inhalt einer Tabelle als Textdatei, etwa für Excel. Trennzeichen frei wählbar, Vorgabe Tabulator. |
| SetCellEquation | Setzt eine Gleichung in eine Zelle oder Spalte einer Stückliste. |
| SetCellRange | Legt den aktuellen Zellbereich einer Tabelle fest, für Befehle, die mit swTableCellRange_Current arbeiten. |
| SetCellTextFormat | Setzt das Textformat einer Zelle einer Tabelle, oder stellt es auf die Vorgabe des Dokuments zurück. |
| SetCellTextOrientation | Setzt die Textrichtung in einer Zelle oder in allen Zellen einer Tabelle. |
| SetColumnTitle | veraltet ersetzt durch TableAnnotation.SetColumnTitle2 |
| SetColumnTitle2 | Setzt die Überschrift einer Spalte einer Tabelle. |
| SetColumnType | veraltet ersetzt durch TableAnnotation.SetColumnType3 |
| SetColumnType2 | veraltet ersetzt durch TableAnnotation.SetColumnType3 |
| SetColumnType3 | Legt fest, was eine Spalte einer Stückliste zeigt: Positionsnummer, Eigenschaft, Gleichung und mehr. |
| SetColumnWidth | Setzt die Breite einer Spalte, aller Spalten oder des aktuellen Bereichs einer Tabelle. Liefert die tatsächliche Breite. |
| SetHeader | Setzt den Kopf einer Tabelle: oben, unten oder keiner, mit wie vielen Zeilen. |
| SetLockColumnWidth | Sperrt die Breite einer Spalte einer Tabelle oder gibt sie frei. |
| SetLockRowHeight | Sperrt die Höhe einer Zeile einer Tabelle oder gibt sie frei. |
| SetRowHeight | Setzt die Höhe einer Zeile, aller Zeilen oder des aktuellen Bereichs einer Tabelle. Liefert die tatsächliche Höhe. |
| SetRowVerticalGap | Setzt den Abstand zwischen Text und Ober- oder Unterkante einer Zeile einer Tabelle. |
| SetTextFormat | Setzt das Textformat einer ganzen Tabelle, oder stellt es auf die Vorgabe des Dokuments zurück. |
| Split | Teilt eine Tabelle vor oder nach einer Zeile oder Spalte und liefert das neue Teilstück. |
| UnmergeCells | Trennt eine verbundene Zelle einer Tabelle wieder in einzelne Zellen. |
Siehe auch
Englisches Original: ITableAnnotation in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)
Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.