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 TableAnnotationSet swTable = swDraw.InsertTableAnnotation2(False, 0.02, 0.2, swBOMConfigurationAnchor_TopLeft, "", 4, 2)Parameter
UseAnchorPointBooleanByValTruehängt die Tabelle an den Verankerungspunkt für allgemeine Tabellen, X und Y werden dann ignoriert.Falsesetzt 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.
AnchorTypeLongByValWelche Ecke der Tabelle am Verankerungspunkt liegt, ein Wert aus
swBOMConfigurationAnchorType_e:swBOMConfigurationAnchor_TopLeft(1): obere linke EckeswBOMConfigurationAnchor_TopRight(2): obere rechte EckeswBOMConfigurationAnchor_BottomLeft(3): untere linke EckeswBOMConfigurationAnchor_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 IfBemerkungen
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.