ttdt_sender_imprint_on(3) [hpux man page]

ttdt_sender_imprint_on(library call)									      ttdt_sender_imprint_on(library call)

NAME

       ttdt_sender_imprint_on -- act like a child of the specified tool

SYNOPSIS

       #include <Tt/tttk.h>
       Tt_status ttdt_sender_imprint_on(
       const char *handler,
       Tt_message contract,
       char **display,
       int *width,
       int *height,
       int *xoffset,
       int *yoffset,
       XtAppContext app2run,
       int ms_timeout);

DESCRIPTION

       The  ttdt_sender_imprint_on  function  is used to make the calling tool act equivalently to a child of another specified tool.  The calling
       tool adopts the other tool's X11 display, locale, and current working directory.  It also learns the other tool's X11 geometry, so that	it
       may position itself appropriately.

       If the handler argument is non- NULL, the requests are addressed to that procid using TT_HANDLER. If handler is NULL and the contract argu-
       ment is non- NULL, the requests are addressed to the tt_message_sender(3) of the contract, using TT_HANDLER.

       The contract argument is passed to tttk_message_create(3) as the context argument.

       If the display argument is  not	NULL,  ttdt_sender_imprint_on  returns	the  other  tool's  display  in  *display.  If	display  is  NULL,
       ttdt_sender_imprint_on sets the DISPLAY environment variable to the other tool's display.

       If each of the width, height, xoffset, and yoffset arguments are NULL, then ttdt_sender_imprint_on does not send the other tool a Get_Geom-
       etry request.

       The ttdt_sender_imprint_on function passes the app2run and ms_timeout arguments to tttk_block_while(3), blocking  on  the  replies  to  the
       requests it sends.

       If the display argument is not NULL, ttdt_sender_imprint_on sets *display to a string that can be freed with tt_free.

       If for some reason no width or height is returned by the other tool, ttdt_sender_imprint_on sets *width or *height to -1.  If no positional
       information is returned, ttdt_sender_imprint_on sets *xoffset and *yoffset to {INT_MAX}.

RETURN VALUE

       Upon successful completion, the ttdt_sender_imprint_on function returns the status of the operation as one of the following Tt_status  val-
       ues:

       TT_OK	 The operation completed successfully.

       TT_DESKTOP_ETIMEDOUT
		 One or more of the sent requests did not complete within ms_timeout milliseconds.

       TT_ERR_NOMEM
		 There is insufficient memory available to perform the function.

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

       TT_ERR_OVERFLOW
		 The  ToolTalk service has more active messages than it can handle.  (The maximum number of active messages is implementation spe-
		 cific, but is at least 2000.)

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

APPLICATION USAGE

       If both the handler and contract are zero, the requests are addressed to no tool in particular, using  TT_PROCEDURE;  this  is  not  recom-
       mended.

SEE ALSO

       Tt/tttk.h - Tttttk(5), tt_free(3), tt_message_sender(3), tttk_block_while(3), tttk_message_create(3).

													      ttdt_sender_imprint_on(library call)

Check Out this Related Man Page

ttmedia_Deposit(library call)											     ttmedia_Deposit(library call)

NAME

       ttmedia_Deposit -- send a Deposit request to checkpoint a document

SYNOPSIS

       #include <Tt/tttk.h>
       Tt_status ttmedia_Deposit(
       Tt_message load_contract,
       const char *buffer_id,
       const char *media_type,
       const unsigned char *new_contents,
       int new_len,
       const char *pathname,
       XtAppContext app2run,
       int ms_timeout);

DESCRIPTION

       The  ttmedia_Deposit  function  is  used  to perform a checkpoint save on a document that was the subject of a Media Exchange load_contract
       request such as Edit, Compose, or Open. To carry out a checkpoint save, the editor must send the new document contents back to  the  sender
       of load_contract.

       The  ttmedia_Deposit  function  creates	and sends a Deposit request and returns the success or failure of that request.  The load_contract
       argument is the request that caused this editor to load the document.  The buffer_id argument is the identifier of the buffer  this  editor
       created	if  the  document  was	loaded	via  an  Open request.	If buffer_id is NULL, the the ToolTalk service gives the Deposit request a
       Tt_address of TT_HANDLER and sends it directly to the tt_message_sender of load_contract; otherwise, the the ToolTalk service will  address
       it as a TT_PROCEDURE and insert buffer_id into the request to match the pattern registered by the sender of the load_contract.

       The  ttmedia_Deposit  function uses the media_type argument as the vtype of the contents argument of the sent request, and new_contents and
       new_len as its value.  The latter two must be zero if pathname is used to name a temporary file into which the editor will place the check-
       pointed	document.   The  editor  is  free  to remove the temporary file after the reply to the Deposit request is received; that is, after
       ttmedia_Deposit has returned.

       After the request is sent, ttmedia_Deposit passes app2run and ms_timeout to tttk_block_while(3) to wait for the reply.

RETURN VALUE

       Upon successful completion, the ttmedia_Deposit function returns the status of the operation as one of the following Tt_status values:

       TT_OK	 The operation completed successfully.

       TT_DESKTOP_ETIMEDOUT
		 No reply was received within ms_timeout milliseconds.

       TT_ERR_NOMEM
		 There is insufficient memory available to perform the function.

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

       TT_ERR_OVERFLOW
		 The ToolTalk service has more active messages than it can handle.  (The maximum number of active messages is implementation  spe-
		 cific, but is at least 2000.)

       TT_ERR_POINTER
		 The pathname argument was NULL or was a ToolTalk error pointer.

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

SEE ALSO

       Tt/tttk.h - Tttttk(5), ttmedia_load(3), ttmedia_load_reply(3), ttmedia_ptype_declare(3), ttdt_Save(3), tttk_block_while(3).

														     ttmedia_Deposit(library call)

Linux and UNIX Man Pages

ttdt_sender_imprint_on(3) [hpux man page]

Check Out this Related Man Page