SolidWorksMakroprogrammierung

Methode · DrawingDoc

InsertTableAnnotation2-Methode (DrawingDoc)

Fügt eine allgemeine Tabelle in die Zeichnung ein, frei positioniert oder am Verankerungspunkt des Blattformats.

Syntax

Function InsertTableAnnotation2( _
   ByVal UseAnchorPoint As Boolean, _
   ByVal X As Double, _
   ByVal Y As Double, _
   ByVal AnchorType As Long, _
   ByVal TableTemplate As String, _
   ByVal Rows As Long, _
   ByVal Columns As Long _
) As TableAnnotation
Set swTable = swDraw.InsertTableAnnotation2(False, 0.02, 0.2, swBOMConfigurationAnchor_TopLeft, "", 4, 2)

Parameter

UseAnchorPointBooleanByVal
True hängt die Tabelle an den Verankerungspunkt für allgemeine Tabellen, X und Y werden dann ignoriert. False setzt die Tabelle an X und Y.
XDoubleByVal
X-Koordinate der Tabelle. Die Hilfe nennt keine Einheit. Vermutlich Blattkoordinaten in Metern, Ursprung links unten.
YDoubleByVal
Y-Koordinate der Tabelle, wie X.
AnchorTypeLongByVal

Welche Ecke der Tabelle am Verankerungspunkt liegt, ein Wert aus swBOMConfigurationAnchorType_e:

  • swBOMConfigurationAnchor_TopLeft (1): obere linke Ecke
  • swBOMConfigurationAnchor_TopRight (2): obere rechte Ecke
  • swBOMConfigurationAnchor_BottomLeft (3): untere linke Ecke
  • swBOMConfigurationAnchor_BottomRight (4): untere rechte Ecke
TableTemplateStringByVal
Vollständiger Pfad einer Tabellenvorlage für allgemeine Tabellen. Leerer Text "" für eine Tabelle ohne Vorlage (siehe Bemerkungen).
RowsLongByVal
Anzahl der Zeilen.
ColumnsLongByVal
Anzahl der Spalten.

Rückgabewert

Die neue Tabelle (TableAnnotation). Was bei einem Fehler zurückkommt, sagt die Hilfe nicht. Prüf das Ergebnis mit Is Nothing.

Beispiel

' swDraw ist die aktive Zeichnung (DrawingDoc), etwa per Set swDraw = swModel.
Dim swTable As SldWorks.TableAnnotation
Set swTable = swDraw.InsertTableAnnotation2(False, 0.02, 0.2, swBOMConfigurationAnchor_TopLeft, "", 4, 2)
If swTable Is Nothing Then
    Debug.Print "Keine Tabelle eingefügt."
Else
    swTable.Text2(0, 0, False) = "Prüfmerkmal"
    swTable.Text2(0, 1, False) = "Wert"
    Debug.Print swTable.RowCount & " Zeilen, " & swTable.ColumnCount & " Spalten"
End If

Bemerkungen

Mit oder ohne Vorlage: Gibst du in TableTemplate eine gültige Vorlage an, nimmt SOLIDWORKS deren Angaben und ignoriert AnchorType und Columns. Ist TableTemplate leer, entsteht die Tabelle nur aus den übrigen Parametern. Rows nennt die Hilfe hier nicht unter den ignorierten Werten. Beim neueren ModelDocExtension.InsertGeneralTableAnnotation steht dagegen, dass mit Vorlage auch Rows ignoriert wird. Probier es aus, wenn du beides zusammen nutzt.

Position: Nach TableAnnotation.Anchored rastet eine verankerte Tabelle mit der Ecke aus AnchorType am Verankerungspunkt ein. Hat das Blattformat keinen Verankerungspunkt für diese Art Tabelle, hat das Verankern keine Wirkung. Ob AnchorType auch bei UseAnchorPoint = False bestimmt, welche Ecke an X und Y liegt, sagt die Hilfe hier nicht. Beim neueren ModelDocExtension.InsertGeneralTableAnnotation gilt AnchorType nur, wenn UseAnchorPoint True ist. Eine verankerte Tabelle kannst du nicht mit Annotation.SetPosition2 verschieben.

Ob die erste Zeile eine Kopfzeile ist und in Rows mitzählt, sagt die Hilfe nicht. Zeilen und Spalten von TableAnnotation.Text2 zählen ab 0. Ersetzt DrawingDoc.InsertTableAnnotation.

Siehe auch

Verfügbarkeit

SOLIDWORKS 2006

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

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