Raise(4)

Raise(4)	 DEVICES AND NETWORK INTERFACES		 Raise(4)

NAME
     Raise request - raise a tool's window(s) to the front

SYNOPSIS
     Raise([in messageID commission]);

DESCRIPTION
     The Raise request raises the window(s) associated	with  the
     handling  procid.	 If  any  optional arguments are present,
     then it raises only the indicated window(s).

     The commission argument is	the ID of the  message,	 if  any,
     that  resulted  in	the creation of	the window(s) that should
     be	raised.

APPLICATION USAGE
     The ttdt_session_join(3), and ttdt_message_accept(3),  func-
     tions  can	 be  used by Xt	applications to	register for, and
     transparently process, the	Raise request.

EXAMPLES
     The Raise request can be sent as in the following example:

	  Tt_message msg = tttk_message_create(0, TT_REQUEST, TT_SESSION,
		      the_recipient_procid, TTDT_RAISE,
		      my_callback);
	  tt_message_send(msg);

WARNINGS
     Raise can also be sent as a multicast notice, as an edict to
     all  tools	in the scope of	the message.  The consequences of
     doing so can be severe and	unexpected.

SEE ALSO
     tt_message_send(3), ttdt_message_accept(3),
     ttdt_session_join(3); Lower request.

Unix System LaboratorLast change: 13 May 1994			1