Index for Section 4

Alphabetical listing for S

Bottom of page

Set_Iconified(4)
CDE
NAME
  Set_Iconified - set a tool's iconic state

SYNOPSIS
  Set_Iconified(in 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 specified).

  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 question.

APPLICATION USAGE
  The ttdt_session_join(3), and ttdt_message_accept(3), functions 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 happens 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);

WARNINGS
  Set_Iconified 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_iarg_add(3), tt_message_send(3), ttdt_message_accept(3),
  ttdt_session_join(3); Get_Iconified request

Index for Section 4

Alphabetical listing for S

Top of page