This method inserts a new table in the text.
TXTextControl.TableInsert Rows, Columns, TextPos [, TableId]
| Parameter | Description | |
| Rows | Specifies the number of rows. | |
| Columns | Specifies the number of columns. | |
| TextPos | Specifies the text position where the new table is to be inserted. It is inserted at the current input position when this parameter is set to -1. | |
| TableId | Optional. Specifies a table identifier. This identifier can be used to access or to alter the table's text and attributes. It must be in the range of 10 to 32,767. |
| Parameter | Description | |
| 0 | An error has occurred or the table could not be inserted. Tables cannot be inserted inside existing tables or when a section of text has been selected. | |
| -1 | The new table has been inserted at the top or at the bottom of an existing table and has been combined with this table. | |
| otherwise | The table's identifier. This is the same value as specified with the TableId parameter or an internal identifier selected by Text Control when the optional TableId parameter has been omitted. |
| Rows: | Integer |
| Columns: | Integer |
| TextPos: | Long |
| TableId: | Integer |
| Return value: | Integer |
