]]>
]]>
Set_Mapped
special file
Set_Mapped
set whether a tool is mapped to the screen
Set_Mapped(in boolean mapped
[in messageID commission]);
DESCRIPTION
The
Set_Mapped request
sets the mapped state of the optionally specified
window, or of the window primarily associated with the handling
procid (if no window is specified).
The
mapped argument
is a Boolean value indicating whether the specified window is (to be)
mapped to the screen.
The
commission argument
is the ID of the ongoing request, if any, that resulted in the creation
of the window in question.
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
Set_Mapped request.
EXAMPLES
The
Set_Mapped 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_MAPPED,
my_callback);
tt_message_iarg_add(msg, TT_IN, Tttk_boolean, 1);
tt_message_send(msg);
WARNINGS
Set_Mapped 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
&cdeman.tt.message.iarg.add;, &cdeman.tt.message.send;, &cdeman.ttdt.message.accept;, &cdeman.ttdt.session.join;; Get_Mapped request.