]]>]]>
Get_XInfospecial file
Get_XInfo
get a tool's X11 attributes
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 specified).
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:
DirectColor
PseudoColor
StaticGray
GrayScale
StaticColor
TrueColor
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 &cdeman.ttdt.session.join;, and &cdeman.ttdt.message.accept;, functions can be used by Xt applications to register for, and
transparently process, the Get_XInfo request.
Also, Get_XInfo can be sent by &cdeman.ttdt.sender.imprint.on;.
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 example:
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
&cdeman.tt.message.iarg.add;, &cdeman.tt.message.send;, &cdeman.ttdt.message.accept;, &cdeman.ttdt.sender.imprint.on;, &cdeman.ttdt.session.join;.