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

# XmTextInsertWcs(3)

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

## NAME

**XmTextInsertWcs** — A Text function that inserts a wide character string into a Text widget

## SYNOPSIS

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

## DESCRIPTION

**XmTextInsertWcs** inserts a wide character string into the Text 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.

Note that, if *value* is a null string, no callbacks will be generated, since no modifications will have been made.

- *widget*

  Specifies the Text 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 Text widget

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

## RELATED

[**XmText**(3)](/XmText/3.md) and [**XmTextInsert**(3)](/XmTextInsert/3.md).