Get_XInfo(4)

Get_XInfo(4)	 DEVICES AND NETWORK INTERFACES	     Get_XInfo(4)

NAME
     Get_XInfo request - get a tool's X11 attributes

SYNOPSIS
     Get_XInfo(out string display,
	       out string visual,
	       out integer depth
	       [in messageID commission]);

DESCRIPTION
     The Get_XInfo request reports  the	 X11  attributes  of  the
     optionally	 specified  window,  or	 of  the window	primarily
     associated	with the recipient procid (if no window	is speci-
     fied).

     The display argument is an	X11 display.

     The visual	argument is an X11 visual class	(which determines
     how  a  pixel  will  be displayed as a color).  Valid values
     are:

	  StaticGray
	  GrayScale
	  StaticColor
	  PseudoColor
	  TrueColor
	  DirectColor

     The depth argument	is the number of bits in a pixel.

     The commission argument is	the ID	of  the	 ongoing  request
     with  respect  to	which  X11  attributes	are  being set or
     reported.

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   Get_XInfo	request.    Also,
     Get_XInfo can be sent by ttdt_sender_imprint_on(3).

     Since the handler may be running on a different host, it  is
     almost   always   better	to  return  a  display	value  of
     hostname:n[.n] instead of :n[.n].)

     The commission argument is	useful to  the	extent	that  the
     handler  employs  different  attributes  for  the	different
     operations	it may be carrying out.

EXAMPLES
     The Get_XInfo request can be sent as in the following  exam-
     ple:

Unix System LaboratorLast change: 13 May 1994			1

Get_XInfo(4)	 DEVICES AND NETWORK INTERFACES	     Get_XInfo(4)

	  Tt_message msg = tttk_message_create(0, TT_REQUEST, TT_SESSION,
		      the_recipient_procid, TTDT_GET_XINFO,
		      my_callback);
	  tt_message_arg_add(msg, TT_OUT, Tttk_string, 0);
	  tt_message_arg_add(msg, TT_OUT, Tttk_string, 0);
	  tt_message_iarg_add(msg, TT_OUT, Tttk_integer, 0);
	  tt_message_send(msg);

SEE ALSO
     tt_message_iarg_add(3), tt_message_send(3),
     ttdt_message_accept(3), ttdt_sender_imprint_on(3),
     ttdt_session_join(3).

Unix System LaboratorLast change: 13 May 1994			2