# Javascript: TXTextControl.TextFrameInsertionMode Enumeration

> Determines how a text frame can be inserted in the text.

- **Product:** DS Server
- **Section:** Reference
- **Kind:** Enumeration
- **Introduced:** 25.0
- **Path:** DS Server > Reference > JavaScript API > Javascript: TXTextControl.TextFrameInsertionMode Enumeration
- **342 words**
- **Web URL:** https://docs.textcontrol.com/ds-server/reference/javascript/txtextcontrol/textframeinsertionmode-enumeration/
- **LLMs URL:** https://docs.textcontrol.com/ds-server/reference/javascript/txtextcontrol/textframeinsertionmode-enumeration/llms.txt
- **LLMs-Full URL:** https://docs.textcontrol.com/ds-server/reference/javascript/txtextcontrol/textframeinsertionmode-enumeration/llms-full.txt

---

### Description

Determines how a text frame can be inserted in the text.

### Members

| Member | Description |
|---|---|
| AboveTheText | The text frame is inserted at a certain geometrical location above the text. This means that the text frame overwrites the text. |
| AsCharacter | The text frame is inserted in the text as a single character. |
| BelowTheText | The text frame is inserted at a certain geometrical location below the text. This means that the text overwrites the text frame. |
| DisplaceCompleteLines | The text frame is inserted at a certain geometrical location. |
| DisplaceText | The text frame is inserted at a certain geometrical location. |

### Examples

The following example uses `TXTextControl.TextFrameInsertionMode.AsCharacter` (the text frame is inserted in the text as a single character.) in a document-editing workflow.

```javascript
function onTxError(error) {
    console.error("TX Text Control error:", error.msg);
    error.handled = true;
}

TXTextControl.textFrames.addWithMouse(TXTextControl.TextFrameInsertionMode.AsCharacter, onTxError);
```

---

## Nearby

- **Previous:** [Javascript: TXTextControl.TextFieldType Enumeration](https://docs.textcontrol.com/ds-server/reference/javascript/txtextcontrol/textfieldtype-enumeration/llms-full.txt)
- **Next:** [Javascript: TXTextControl.textFrameMarkerLines Property](https://docs.textcontrol.com/ds-server/reference/javascript/txtextcontrol/textframemarkerlines-property/llms-full.txt)