Go to main content

man pages section 3: Library Interfaces and Headers

Exit Print View

Updated: Thursday, June 13, 2019
 
 

ttdt_subcontract_manage (3)

Name

ttdt_subcontract_manage - manage an outstanding request

Synopsis

#include <Tt/tttk.h>
Tt_pattern *ttdt_subcontract_manage(Tt_message subcontract,
Ttdt_contract_cb cb,
Widget shell,
void *clientdata);

Description

ToolTalk Functions                                  ttdt_subcontract_manage(3)



NAME
       ttdt_subcontract_manage - manage an outstanding request

SYNOPSIS
       #include <Tt/tttk.h>
       Tt_pattern *ttdt_subcontract_manage(Tt_message subcontract,
                                           Ttdt_contract_cb cb,
                                           Widget shell,
                                           void *clientdata);

DESCRIPTION
       The ttdt_subcontract_manage() function allows a requester to manage the
       standard Desktop interactions  with  the  tool  that  is  handling  the
       request.   The  ttdt_subcontract_manage()  function  registers  in  the
       default session  for  TT_HANDLER-addressed  requests  Get_Geometry  and
       Get_XInfo, and Status notices.

       If shell is not NULL, the ToolTalk service handles the Get_Geometry and
       Get_XInfo, and Status notices transparently; otherwise, it passes  them
       to cb.

       See  ttdt_session_join(3) for a description of a Ttdt_contract_cb call-
       back.

       If subcontract is destroyed by tttk_message_destroy(),  then  the  pat-
       terns  will also be destroyed; otherwise, the caller is responsible for
       iterating over the array and destroying each pattern.

RETURN VALUE
       Upon  successful  completion,  the  ttdt_subcontract_manage()  function
       returns  a  null-terminated  array  of  Tt_pattern, and associates this
       array with subcontract; otherwise, it returns an  error  pointer.   The
       application  can  use  tt_ptr_error(3)  to extract one of the following
       Tt_status values from the returned handle:

          TT_DESKTOP_EINVAL
                  Both the shell and cb arguments were NULL.

          TT_ERR_NOMEM
                  There is insufficient memory available to perform the  func-
                  tion.

          TT_ERR_NOMP
                  The  ttsession(1)  process  is  not running and the ToolTalk
                  service cannot restart it.

          TT_ERR_POINTER
                  The subcontract argument was not a valid Tt_message.

          TT_ERR_PROCID
                  The specified process identifier is out of date or invalid.

ATTRIBUTES
       See attributes(7) for descriptions of the following attributes:


       +---------------+------------------+
       |ATTRIBUTE TYPE | ATTRIBUTE VALUE  |
       +---------------+------------------+
       |Availability   | library/tooltalk |
       +---------------+------------------+
       |Stability      | Committed        |
       +---------------+------------------+
SEE ALSO
       tttk(5), ttdt_session_join(3), tttk_message_destroy(3).




ToolTalk 1.3                     1 March 1996
                                                    ttdt_subcontract_manage(3)