Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help 
XmtMsgLinePush(3)	    Library Functions Manual	       XmtMsgLinePush(3)

NAME
     XmtMsgLinePush(), XmtMsgLinePop() - save and restore messages in an XmtMsg-
     Line widget.

SYNOPSIS
     #include <Xmt/MsgLine.h>

     void XmtMsgLinePush(Widget w)

     void XmtMsgLinePop(Widget w, int when)

ARGUMENTS
     INPUTS

	  w	 An XmtMsgLine widget.

	  when	 For XmtMsgLinePop(), specifies when the saved message should be
		 restored.

DESCRIPTION
     XmtMsgLinePush()  ``pushes'' the currently displayed message onto an inter-
     nal stack of messages so  that  it  can  be  later  restored  with  XmtMsg-
     LinePop().  The  current  contents  of the message line are not modified by
     this call. The message stack grows dynamically, as needed, so any number of
     messages may be saved on it, and  restored  later	in  a  last-on-first-off
     fashion.

     XmtMsgLinePop()  restores	the message that was most recently saved (with a
     call to XmtMsgLinePush()) in the XmtMsgLine widget w. The message is either
     restored immediately, or at a later time, depending on  the  value  of  the
     when  argument.  If when is XmtMsgLineNow, then the message is restored im-
     mediately. If when is XmtMsgLineOnAction, then the message is restored  the
     next  time  a user action (a key press or mouse click, for example) occurs.
     Otherwise, if when is neither of these constants, then it	is  taken  as  a
     time in milliseconds, the message will be restored after the specified time
     elapses.

     If  you  want a message to be restored either when the user does something,
     or when a specified time interval elapses, call XmtMsgLinePop() twice, once
     with the constant XmtMsgLineOnAction, and once with the time interval. If a
     message line has a pop ``pending'', and the application  calls  some  other
     XmtMsgLine  function  (such  as  XmtMsgLinePush()	again)	then the pending
     ``pop'' will be performed immediately instead of waiting for a user  action
     or for time to pass.

SEE ALSO
     Chapter 22, The Message Line,
     XmtMsgLine, XmtMsgLineAppend(), XmtMsgLineClear(), XmtMsgLineGetChar(),
     XmtMsgLineGetDouble(), XmtMsgLineGetInput(),
     XmtMsgLineGetInt(),XmtMsgLineGetString(), XmtMsgLineGetUnsigned(),
     XmtMsgLinePrintf(), XmtMsgLineSet(), XmtMsgLineSetInput().

Xmt				   Motif Tools		       XmtMsgLinePush(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=XmtMsgLinePush&sektion=3&manpath=FreeBSD+Ports+15.1.quarterly>

home | help