# TableInsertDialog Method

> Opens the built-in dialog box for defining a new table and inserts the table when it is closed with OK; returns the table identifier, 0 or -1.

- **Product:** TX Text Control ActiveX
- **Section:** Documentation
- **Kind:** Method
- **Path:** TX Text Control ActiveX > API Reference > TXTextControl > TableInsertDialog Method
- **390 words**
- **Web URL:** https://docs.textcontrol.com/tx-text-control-activex/reference/txtextcontrol/tableinsertdialog-method/
- **LLMs URL:** https://docs.textcontrol.com/tx-text-control-activex/reference/txtextcontrol/tableinsertdialog-method/llms.txt
- **LLMs-Full URL:** https://docs.textcontrol.com/tx-text-control-activex/reference/txtextcontrol/tableinsertdialog-method/llms-full.txt

---

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

```vbscript
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 |

### See Also

- [Formatting Text by using Number Formats](https://docs.textcontrol.com/tx-text-control-activex/document-editor/tables/number-formats/llms-full.txt)
- [Tables](https://docs.textcontrol.com/tx-text-control-activex/document-editor/tables/llms-full.txt)
- [Using Formulas in Table Cells](https://docs.textcontrol.com/tx-text-control-activex/document-editor/tables/formulas/llms-full.txt)
- [TableCanInsert Property](https://docs.textcontrol.com/tx-text-control-activex/reference/txtextcontrol/tablecaninsert-property/llms-full.txt)
- [Programming Category: Tables](https://docs.textcontrol.com/tx-text-control-activex/reference/categories/tables/llms-full.txt)
- [Programming Category: Built-in Dialog Boxes](https://docs.textcontrol.com/tx-text-control-activex/reference/categories/dialog-boxes/llms-full.txt)

---

## Nearby

- **Previous:** [TableInsertColumn Method](https://docs.textcontrol.com/tx-text-control-activex/reference/txtextcontrol/tableinsertcolumn-method/llms-full.txt)
- **Next:** [TableInsertLines Method](https://docs.textcontrol.com/tx-text-control-activex/reference/txtextcontrol/tableinsertlines-method/llms-full.txt)