[ Previous | Next | Contents | Glossary | Home | Search ]
Motif 2.1 Programmer's Reference


XmTextGetString

A Text function that accesses the string value

Format

#include <Xm/Text.h>
char * XmTextGetString
Widget
widget

DESCRIPTION

XmTextGetString accesses the string value of the Text widget. The application is responsible for freeing the storage associated with the string by calling XtFree.

widget
Specifies the Text widget ID

For a complete definition of Text and its associated resources, see XmText (3).

RETURN

Returns a character pointer to the string value of the text widget. This returned value is a copy of the value of the XmNvalue resource. Returns an empty string if the length of the Text widget's string is 0 (zero).

RELATED

XmText (3) and XmTextGetStringWcs (3).


[ Previous | Next | Contents | Glossary | Home | Search ]