GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  XMTMSGLINESETINPUT (3)

NAME

XmtMsgLineSetInput(), XmtMsgLineGetInput() - set or query the editable text in an XmtMsgLine widget.

CONTENTS

SYNOPSIS

   #include <Xmt/MsgLine.h>

   void XmtMsgLineSetInput(Widget w, String s)

   String XmtMsgLineGetInput(Widget w)

ARGUMENTS

INPUTS
w An XmtMsgLine widget.
s For XmtMsgLineSetInput(), the input string to be displayed.

RETURNS

XmtMsgLineGetInput() returns the current editable text displayed in the message line. This text must be freed with XtFree() when no longer needed.

DESCRIPTION

XmtMsgLineSetInput() appends to the text displayed in the XmtMsgLine widget w. This function differs from XmtMsgLineAppend(), however, in that the appended text may be edited by the user in a subsequent call to one of the synchronous input functions XmtMsgLineGetString(), XmtMsgLineGetInt(), XmtMsgLineGetUnsigned(), or XmtMsgLineGetDouble().

Text inserted into the message line with XmtMsgLineSet(), XmtMsgLineAppend(), or XmtMsgLinePrintf() is never editable by the user. Text inserted with XmtMsgLineSetInput() is editable, and becomes the default value for a subsequent call to a synchronous input function. Note that multiple calls to XmtMsgLineSetInput() do not append more editable text to previously editable text; each call sets the entire editable text, replacing any editable text previously displayed in the widget.

XmtMsgLineGetInput() returns any currently editable text in an XmtMsgLine widget. It returns a copy of the editable text in allocated memory which must be freed by the application, by calling XtFree() when it is no longer needed. The only time there is editable text in an XmtMsgLine widget is while one of the synchronous input functions is in progress. At this point, the application is in an internal event loop, and so you must always call XmtMsgLineGetInput() from an action procedure or callback invoked by the XmtMsgLine widget.

Note that XmtMsgLineGetInput() does not return complete user input, as XmtMsgLineGetString() does, but only a snapshot of the current state of the message line. An application might use this partial input to implement ‘‘filename completion’’ with the Tab key, for example, but should not treat input as valid until the user has entered it by striking the Return key.

SEE ALSO

Chapter 22, The Message Line,
XmtMsgLine, XmtMsgLineAppend(), XmtMsgLineClear(), XmtMsgLineGetChar(), XmtMsgLineGetDouble(), XmtMsgLineGetInt(), XmtMsgLineGetString(), XmtMsgLineGetUnsigned(), XmtMsgLinePop(), XmtMsgLinePrintf(), XmtMsgLinePush(), XmtMsgLineSet().
Search for    or go to Top of page |  Section 3 |  Main Index


Xmt XMTMSGLINESETINPUT (3) Motif Tools

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.