DOC HOME SITE MAP MAN PAGES GNU INFO SEARCH PRINT BOOK
 

Set_Iconified(4)




Set_Iconified(4) DEVICES AND NETWORK INTERFACES	 Set_Iconified(4)

NAME
     Set_Iconified request - set a tool's iconic state

SYNOPSIS
     Set_Iconified(out boolean iconic
		   [in messageID commission]);

DESCRIPTION
     The Set_Iconified request	sets  the  iconic  state  of  the
     optionally	 specified  window,  or	 of  the window	primarily
     associated	with the handling procid (if no	window is  speci-
     fied).

     The iconic	argument is a Boolean  value  indicating  whether
     the specified window is (to be) iconified.

     The commission argument is	the ID of the ongoing request, if
     any, that resulted	in the creation	of the window(s) in ques-
     tion.

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	Set_Iconified request.

     If	the handler does not map window-system windows one-to-one
     to	 commissions  or  procids, then	it may interpret ``iconic
     state'' liberally.	 For example, consider a Display  request
     on	 an ISO_Latin_1	file, handled by a gnuemacs instance that
     then devotes an emacs ``window'' to the  file.   ``Windows''
     in	 gnuemacs  are	not  separate  X11  windows,  and are not
     separately	iconifiable.  However,	a  Set_Iconified  request
     issued  with respect to the ongoing Display request could be
     liberally interpreted by gnuemacs to mean it should minimize
     the  screen real estate devoted to	the operation, perhaps by
     ``burying'' the buffer or dividing	its window's real  estate
     among neighboring windows.	 And, if the Display request hap-
     pens to be	the only thing emacs is	working	on at the moment,
     it	could instead take a literal interpretation, and actually
     iconify itself.

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

	  Tt_message msg = tttk_message_create(0, TT_REQUEST, TT_SESSION,
		      the_recipient_procid, TTDT_SET_ICONIFIED,
		      my_callback);
	  tt_message_iarg_add(msg, TT_IN, Tttk_boolean,	1);
	  tt_message_send(msg);

Unix System LaboratorLast change: 13 May 1994			1

Set_Iconified(4) DEVICES AND NETWORK INTERFACES	 Set_Iconified(4)

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

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

Unix System LaboratorLast change: 13 May 1994			2


Man(1) output converted with man2html