This method opens a built-in dialog box which offers options to define a new table. When the dialog box is left with OK, the new table is inserted in the text.
Introduced: 19.0.
Syntax
TXTextControl.TableInsertDialog [TableId]
Parameters
| Parameter | Description |
|---|
| 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. |
Return Value
| Value | Description |
|---|
| 0 | An error has occurred or the table could not be inserted. Tables cannot be inserted when text has been selected. |
| -1 | The new table has been inserted at the top or at the bottom of an existing table. In this case the new table is combined with the existing 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. |
Data Types
| Name | Data type |
|---|
| TableId | Integer |
| Return value | Integer |
