Go to main content

man pages section 4: Device and Network Interfaces

Exit Print View

Updated: Wednesday, July 27, 2022
 
 

Raise (4)

Name

Raise - raise a tool's window(s) to the front

Synopsis

Raise([in messageID commission]);

Description

Desktop Services Message Sets                                         Raise(4)



NAME
       Raise - raise a tool's window(s) to the front

SYNOPSIS
       Raise([in messageID commission]);

DESCRIPTION
       The  Raise  request  raises  the window(s) associated with the handling
       procid.  If any optional arguments are present, then it raises only the
       indicated window(s).

       The commission argument is the ID of the message, if any, that resulted
       in the creation of the window(s) that should be raised.

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
       Raise request.

EXAMPLES
       The Raise request can be sent as in the following example:

            Tt_message msg = tttk_message_create(0, TT_REQUEST, TT_SESSION,
                        the_recipient_procid, TTDT_RAISE,
                        my_callback);
            tt_message_send(msg);

WARNINGS
       Raise 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_send(3), ttdt_message_accept(3), ttdt_session_join(3); Lower
       request.




ToolTalk 1.3                     1 March 1996                         Raise(4)