Index for Section 4

Alphabetical listing for P

Bottom of page

Print(4)
CDE
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
  inquisitive 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 carries 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 register 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

Index for Section 4

Alphabetical listing for P

Top of page