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 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:

    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), functions 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 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
tt_message_iarg_add(3), tt_message_send(3), ttdt_message_accept(3), ttdt_sender_imprint_on(3), ttdt_session_join(3).