SolidWorksMakroprogrammierung

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.

Deklaration Dim x As SldWorks.TableAnnotation · in der englischen .NET-Hilfe: ITableAnnotation

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

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 Sub

Bemerkungen

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

NameBeschreibung
AnchoredLiest oder setzt, ob eine Tabelle an ihrem Ankerpunkt im Blattformat hängt.
AnchorTypeLiest oder setzt, mit welcher Ecke eine Tabelle an ihrem Ankerpunkt hängt.
BorderLineWeightLiest oder setzt die Linienstärke des Außenrahmens einer Tabelle.
BorderLineWeightCustomLiest oder setzt eine eigene Linienstärke für den Außenrahmen einer Tabelle, in Millimetern.
CellTextHorizontalJustificationLiest oder setzt die waagrechte Ausrichtung des Texts in einer Zelle einer Tabelle.
CellTextVerticalJustificationLiest oder setzt die senkrechte Ausrichtung des Texts in einer Zelle einer Tabelle.
ColumnCountLiefert die Anzahl der sichtbaren Spalten einer Tabelle.
ColumnHiddenLiest oder setzt, ob eine Spalte einer Tabelle ausgeblendet ist.
DisplayedTextveraltet ersetzt durch TableAnnotation.DisplayedText2
DisplayedText2Liefert den Text, der in einer Zelle einer Tabelle angezeigt wird, mit den Werten verknüpfter Eigenschaften.
GeneralTableFeatureLiefert das Feature einer allgemeinen Tabelle.
GridLineWeightLiest oder setzt die Linienstärke der Innenlinien einer Tabelle.
GridLineWeightCustomLiest oder setzt eine eigene Linienstärke für die Innenlinien einer Tabelle, in Millimetern.
RowCountLiefert die Anzahl der sichtbaren Zeilen einer Tabelle.
RowHiddenLiest oder setzt, ob eine Zeile einer Tabelle ausgeblendet ist.
StopAutoSplittingLiest oder setzt, ob das automatische waagrechte Teilen einer Tabelle angehalten ist.
Textveraltet ersetzt durch TableAnnotation.Text2
Text2Liest oder setzt den Text einer Zelle einer Tabelle, mit Verknüpfungen statt ihrer Werte.
TextHorizontalJustificationLiest oder setzt die waagrechte Ausrichtung des Texts für die ganze Tabelle.
TextVerticalJustificationLiest oder setzt die senkrechte Ausrichtung des Texts für die ganze Tabelle.
TitleLiest oder setzt den Titel einer Tabelle.
TitleVisibleLiest oder setzt, ob der Titel einer Tabelle angezeigt wird.
TotalColumnCountLiefert die Anzahl aller Spalten einer Tabelle, sichtbare und ausgeblendete.
TotalRowCountLiefert die Anzahl aller Zeilen einer Tabelle, sichtbare und ausgeblendete.
TypeLiefert die Art einer Tabelle: allgemeine Tabelle, Stückliste, Bohrungstabelle, Revisionstabelle und mehr.
UpperCaseLiest oder setzt, ob der Text einer Tabelle in Großbuchstaben angezeigt wird. 1 ja, 0 nein.

Methoden 59, davon 49 beschrieben, 10 veraltet

NameBeschreibung
DeleteColumnveraltet ersetzt durch TableAnnotation.DeleteColumn2
DeleteColumn2Löscht eine Spalte einer Tabelle. Bei der letzten Spalte verschwindet die ganze Tabelle.
DeleteRowveraltet ersetzt durch TableAnnotation.DeleteRow2
DeleteRow2Löscht eine Zeile einer Tabelle. Bei der letzten Zeile verschwindet die ganze Tabelle.
EvaluateCellEquationRechnet eine Gleichung in einer Zelle einer Stückliste aus, ohne sie zu setzen, oder entfernt sie.
GetAnnotationLiefert die Beschriftung (Annotation) zu einer Tabelle, mit Lage, Layer und Sichtbarkeit.
GetCellEquationLiefert die Gleichung einer Zelle oder Spalte einer Stückliste und ihr Ergebnis.
GetCellRangeLiefert den Bereich der ausgewählten Zellen einer Tabelle, oder die ganze Tabelle, wenn keine ausgewählt sind.
GetCellTextFormatLiefert das Textformat einer Zelle einer Tabelle.
GetCellTextOrientationLiefert die Textrichtung in einer Zelle oder in allen Zellen einer Tabelle.
GetCellUseDocTextFormatLiefert, ob eine Zelle einer Tabelle das Textformat aus dem Dokument benutzt.
GetColumnTitleveraltet ersetzt durch TableAnnotation.GetColumnTitle2
GetColumnTitle2Liefert die Überschrift einer Spalte einer Tabelle.
GetColumnTypeveraltet ersetzt durch TableAnnotation.GetColumnType3
GetColumnType2veraltet ersetzt durch TableAnnotation.GetColumnType3
GetColumnType3Liefert die Art einer Spalte einer Stückliste, etwa Positionsnummer oder Eigenschaft, mit ihren Angaben.
GetColumnWidthLiefert die Breite einer Spalte einer Tabelle, in Metern.
GetHeaderCountLiefert, wie viele Zeilen oder Spalten der Kopf einer Tabelle hat.
GetHeaderStyleLiefert, ob der Kopf einer Tabelle oben, unten oder gar nicht steht.
GetLockColumnWidthLiefert, ob die Breite einer Spalte einer Tabelle gesperrt ist.
GetLockRowHeightLiefert, ob die Höhe einer Zeile einer Tabelle gesperrt ist.
GetNextLiefert die nächste Tabelle einer Zeichenansicht, für eine Schleife über alle Tabellen.
GetRowHeightLiefert die Höhe einer Zeile einer Tabelle, in Metern.
GetRowVerticalGapLiefert den Abstand zwischen Text und Ober- oder Unterkante einer Zeile einer Tabelle.
GetSplitInformationLiefert, ob und wie eine Tabelle geteilt ist, und welche Zeilen dieses Teilstück enthält.
GetTextFormatLiefert das Textformat einer ganzen Tabelle.
GetUseDocTextFormatLiefert, ob eine Tabelle das Textformat aus dem Dokument benutzt.
HorizontalAutoSplitTeilt eine Tabelle automatisch waagrecht, einmal oder laufend, nach einer Höchstzahl von Zeilen.
InsertColumnveraltet ersetzt durch TableAnnotation.InsertColumn2
InsertColumn2Fügt eine Spalte in eine Tabelle ein, am Anfang, am Ende oder vor oder nach einer Spalte.
InsertRowFügt eine Zeile in eine Tabelle ein, am Anfang, am Ende oder vor oder nach einer Zeile.
IsCellMergedLiefert, ob eine Zelle einer Tabelle mit anderen verbunden ist, und mit welcher.
IsCellTextEditableLiefert, ob sich der Text einer Zelle einer Tabelle ändern lässt.
MergeFügt Teilstücke einer geteilten Tabelle wieder zusammen.
MergeCellsVerbindet die Zellen eines Bereichs einer Tabelle zu einer.
MoveColumnVerschiebt eine Spalte einer Tabelle vor oder hinter eine andere Spalte.
MoveRowVerschiebt eine Zeile einer Tabelle um eine Zeile nach oben oder unten.
SaveAsPDFSpeichert eine Tabelle als PDF-Datei. Eine vorhandene Datei wird überschrieben.
SaveAsTemplateSpeichert das Aussehen einer Tabelle als Tabellenvorlage, etwa .sldbomtbt für Stücklisten.
SaveAsTextveraltet ersetzt durch TableAnnotation.SaveAsText2
SaveAsText2Speichert den Inhalt einer Tabelle als Textdatei, etwa für Excel. Trennzeichen frei wählbar, Vorgabe Tabulator.
SetCellEquationSetzt eine Gleichung in eine Zelle oder Spalte einer Stückliste.
SetCellRangeLegt den aktuellen Zellbereich einer Tabelle fest, für Befehle, die mit swTableCellRange_Current arbeiten.
SetCellTextFormatSetzt das Textformat einer Zelle einer Tabelle, oder stellt es auf die Vorgabe des Dokuments zurück.
SetCellTextOrientationSetzt die Textrichtung in einer Zelle oder in allen Zellen einer Tabelle.
SetColumnTitleveraltet ersetzt durch TableAnnotation.SetColumnTitle2
SetColumnTitle2Setzt die Überschrift einer Spalte einer Tabelle.
SetColumnTypeveraltet ersetzt durch TableAnnotation.SetColumnType3
SetColumnType2veraltet ersetzt durch TableAnnotation.SetColumnType3
SetColumnType3Legt fest, was eine Spalte einer Stückliste zeigt: Positionsnummer, Eigenschaft, Gleichung und mehr.
SetColumnWidthSetzt die Breite einer Spalte, aller Spalten oder des aktuellen Bereichs einer Tabelle. Liefert die tatsächliche Breite.
SetHeaderSetzt den Kopf einer Tabelle: oben, unten oder keiner, mit wie vielen Zeilen.
SetLockColumnWidthSperrt die Breite einer Spalte einer Tabelle oder gibt sie frei.
SetLockRowHeightSperrt die Höhe einer Zeile einer Tabelle oder gibt sie frei.
SetRowHeightSetzt die Höhe einer Zeile, aller Zeilen oder des aktuellen Bereichs einer Tabelle. Liefert die tatsächliche Höhe.
SetRowVerticalGapSetzt den Abstand zwischen Text und Ober- oder Unterkante einer Zeile einer Tabelle.
SetTextFormatSetzt das Textformat einer ganzen Tabelle, oder stellt es auf die Vorgabe des Dokuments zurück.
SplitTeilt eine Tabelle vor oder nach einer Zeile oder Spalte und liefert das neue Teilstück.
UnmergeCellsTrennt 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.