---
name: "XmTextFieldInsert"
section: "3"
platform: "linux"
package: "openmotif"
version: "2.3.8-4"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/XmTextFieldInsert"
---

# XmTextFieldInsert(3)

A TextField function that inserts a character string into a text string

## NAME

**XmTextFieldInsert** — A TextField function that inserts a character string into a text string

## SYNOPSIS

```
#include <Xm/TextF.h>
void XmTextFieldInsert(
Widget widget,
XmTextPosition position,
char * value);
```

## DESCRIPTION

**XmTextFieldInsert** inserts a character string into the text string in the TextField widget. The character positions begin at 0 (zero) and are numbered sequentially from the beginning of the text. For example, to insert a string after the fourth character, the *position* parameter must be 4.

This routine calls the widget's **XmNvalueChangedCallback** and verification callbacks, either **XmNmodifyVerifyCallback** or **XmNmodifyVerifyCallbackWcs**, or both. If both verification callback lists are registered, the procedures of the **XmNmodifyVerifyCallback** list are executed first and the resulting data is passed to the **XmNmodifyVerifyCallbackWcs** callbacks. If the **XmNcursorPosition** resource is greater than or is the same value as *position*, the **XmNmotionVerifyCallback** is called.

- *widget*

  Specifies the TextField widget ID

- *position*

  Specifies the position in the text string where the character string is to be inserted

- *value*

  Specifies the character string value to be added to the text widget

For a complete definition of TextField and its associated resources, see [**XmTextField**(3)](/XmTextField/3.md).

## RELATED

[**XmTextField**(3)](/XmTextField/3.md) and [**XmTextFieldInsertWcs**(3)](/XmTextFieldInsertWcs/3.md).