Set_Mapped - set whether a tool is mapped to the screen
Set_Mapped(in boolean mapped [in messageID commission]);
Desktop Services Message Sets Set_Mapped(4)
NAME
Set_Mapped - set whether a tool is mapped to the screen
SYNOPSIS
Set_Mapped(in boolean mapped
[in messageID commission]);
DESCRIPTION
The Set_Mapped request sets the mapped state of the optionally speci-
fied 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 ttdt_session_join(3), and ttdt_message_accept(3), 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.
ATTRIBUTES
See attributes(7) for descriptions of the following attributes:
+---------------+------------------+
|ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+---------------+------------------+
|Availability | library/tooltalk |
+---------------+------------------+
|Stability | Committed |
+---------------+------------------+
SEE ALSO
tt_message_iarg_add(3), tt_message_send(3), ttdt_message_accept(3),
ttdt_session_join(3); Get_Mapped request.
ToolTalk 1.3 1 March 1996 Set_Mapped(4)