# TextFrameInsertAsChar Method

> Inserts a text frame that is handled as a single character in the text at a text position with a width and height in twips; returns its identifier.

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

---

This method inserts a new text frame, which is then handled as a single character in the text.

Introduced: 12.0.

### Syntax

```vbscript
TXTextControl.TextFrameInsertAsChar TextPos, Width, Height
```

### Parameters

| Parameter | Description |
|---|---|
| TextPos | Specifies a text position where the text frame should be inserted. If TextPos is -1, the text frame is inserted at the current input position. |
| Width | Specifies the width of the text frame in [twips](https://docs.textcontrol.com/tx-text-control-activex/document-editor/viewing/#measure-in-twips). If this parameter is set to zero, a built-in mouse interface is started which enables the end-user to define the size of the text frame through a rectangle, drawn with the mouse. |
| Height | Specifies the height of the text frame in [twips](https://docs.textcontrol.com/tx-text-control-activex/document-editor/viewing/#measure-in-twips). If this parameter is set to zero, a built-in mouse interface is started which enables the end-user to define the size of the text frame through a rectangle, drawn with the mouse. |

### Return Value

The method returns the text frame's identifier, if a new text frame could be inserted. Otherwise, it returns zero. The text frame's identifier can also be obtained with the [ObjectCurrent](https://docs.textcontrol.com/tx-text-control-activex/reference/txtextcontrol/objectcurrent-property/llms-full.txt) property.

### Data Types

| Name | Data type |
|---|---|
| TextPos | Long |
| Width | Integer |
| Height | Integer |
| Return value | Integer |

### See Also

- [TextFrameInsert Method](https://docs.textcontrol.com/tx-text-control-activex/reference/txtextcontrol/textframeinsert-method/llms-full.txt)
- [TextFrameInsertFixed Method](https://docs.textcontrol.com/tx-text-control-activex/reference/txtextcontrol/textframeinsertfixed-method/llms-full.txt)
- [Text frame and object attribute properties](https://docs.textcontrol.com/tx-text-control-activex/reference/categories/images-objects/llms-full.txt)
- [Programming Category: Images, Text Frames, Signature Fields and OLE Objects](https://docs.textcontrol.com/tx-text-control-activex/reference/categories/images-objects/llms-full.txt)

---

## Nearby

- **Previous:** [TextFrameInsert Method](https://docs.textcontrol.com/tx-text-control-activex/reference/txtextcontrol/textframeinsert-method/llms-full.txt)
- **Next:** [TextFrameInsertFixed Method](https://docs.textcontrol.com/tx-text-control-activex/reference/txtextcontrol/textframeinsertfixed-method/llms-full.txt)