TXTextControl.TableInsertDialog Method

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]
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


Parameter 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

TableId:    Integer
Return value:    Integer

See Also