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

# XmTextFieldInsertWcs(3)

A TextField function that inserts a wide character string into a TextField widget

## NAME

**XmTextFieldInsertWcs** — A TextField function that inserts a wide character string into a TextField widget

## SYNOPSIS

```
#include <Xm/TextF.h>
void XmTextFieldInsertWcs(
Widget widget,
XmTextPosition position,
wchar_t *wcstring);
```

## DESCRIPTION

**XmTextFieldInsertWcs** inserts a wide character string into the TextField widget at a specified location. 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 new character string is to be inserted

- *wcstring*

  Specifies the wide character string value to be added to the TextField widget

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

## RELATED

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