[ новости /+++ | форум | теги | ]

NAME
     Print - print a document

SYNOPSIS
     [file] Print(in mediaType contents,
                  in boolean inquisitive,
                  in boolean covert
                  [in title docName]);

DESCRIPTION
     The Print request causes the handler to  print  a  document.
     The  handler  must  act  as if the user had issued, (via the
     handler's  user  interface)  either  a  ``Print   One''   or
     ``Print...'' command, depending on the value of the inquisi-
     tive argument.

     The contents argument is the contents of the  document.   If
     this  argument  is  unset  (in  other  words, has a value of
     (char *)0), then the contents of the  document  are  in  the
     file  named  in the message's file attribute.  The data type
     (mediaType) of  the  contents  argument  should  be  string,
     unless  nulls  are  valid  in the given media type, in which
     case the data type must be bytes.

     The inquisitive  argument  is  a  boolean  value  indicating
     whether  the handler is allowed to block on user input while
     carrying out the request.  However, even if  inquisitive  is
     True, the handler is not required to seek such input.

     The covert argument is a boolean  value  indicating  whether
     the  handler may make itself apparent to the user as it car-
     ries out the request.  If False, the recipient need not make
     itself apparent.

     If both the inquisitive argument and the covert argument are
     True,  the recipient should attempt to limit its presence to
     the minimum needed to receive any user  input  desired;  for
     example, through iconification.

     The docName argument contains the name of the document.   If
     the  docName  argument  is  absent and the file attribute is
     set, the file name is considered to  be  the  title  of  the
     document.   This  string  would be suitable for display in a
     window title bar, for example.

APPLICATION USAGE
     The ttmedia_ptype_declare(3) function can be used to  regis-
     ter for, and help process, this message.

     This message can be sent with the ttmedia_load(3) function.


EXAMPLES
     To print a PostScript document, the application can  send  a
     request of the form:

          Print(in PostScript contents,
                in boolean inquisitive,
                in boolean covert);

     with a first argument whose value is a vector of bytes  such
     as:

          %!\n/inch {72 mul} def...

     The \n in the example represents the newline character.

     To print a PostScript document  contained  in  a  file,  the
     application  can  send  the Print request as above, with the
     file attribute set to the relevant file and with  the  value
     of the first argument not set.

ERRORS
     The ToolTalk service may return one of the following  errors
     in processing the Print request:

        TT_DESKTOP_ENOENT
              The file that was alleged to contain  the  document
              does not exist.

        TT_DESKTOP_ENODATA
              The in-mode contents argument had no value and  the
              file attribute of the message was not set.

        TT_MEDIA_ERR_FORMAT
              The document is not a valid instance of  the  media
              type.

SEE ALSO
     ttmedia_ptype_declare(3), ttmedia_load(3); Intro, Status
     requests.

Партнёры:

Хостинг: