DXmCSTextReplace(3X) — Subroutines

NAME

DXmCSTextReplace − Replaces a specified segment of text in a compound string text widget.

SYNOPSIS

DXmCSTextStatus DXmCSTextReplace(
        Widget widget,
        int from_pos,
        int to_pos,
        XmString value );

PARAMETERS

widget
The identifier (widget ID) of the compound string text widget.

from_pos
An integer that represents the first character position of the text being replaced.

to_pos
An integer that represents the last character position of the text being replaced.

value
Replacement text for part of the current text in the compound string text widget, or additional text to be inserted into the compound string text widget.

DESCRIPTION

The DXmCSTextReplace routine replaces part of the text in the compound string text widget. Within the widget, positions are numbered starting at 0 and increasing sequentially. For example, to replace the second and third characters in the text, from_pos should be 1 and to_pos should be 3. To insert text after the fourth character, from_pos and to_pos should both be 4.

RETURN VALUES

A value that represents the status (success or failure) of the replace operation, as follows:

Value	Description
DXmCSTextStatusEditDone	Text replaced successfully.
DXmCSTextStatusEditError	Text not replaced (failure).

Museum