*nix Documentation Project
·  Home
 +   man pages
·  Linux HOWTOs
·  FreeBSD Tips
·  *niX Forums

  man pages->HP-UX 11i man pages -> DtPrintResetConnection (3)              


 DtPrintResetConnection(library call)   DtPrintResetConnection(library call)

 NAME    [Toc]    [Back]
      DtPrintResetConnection - resets the print display connection managed
      by a DtPrintSetupBox

 SYNOPSIS    [Toc]    [Back]
      #include <Print.h>
      XtEnum DtPrintResetConnection(
      Widget wid,
      DtPrintResetConnectionMode mode);

 DESCRIPTION    [Toc]    [Back]
      The DtPrintResetConnection function is a convenience function provided
      by the DtPrintSetupBox widget that allows applications to direct the
      widget to stop managing the X print server connection.  A mode
      parameter is included in order to direct the widget to close the print
      connection by calling XpDestroyPrintContext and XCloseDisplay or to
      simply relinquish control of the connection without closing it.

      DtPrintResetConnection is intended to be used by applications that
      fork a child process to perform the print rendering operation.
      Immediately after the fork is performed, the parent process will close
      its X print server connection, and retain its connection to the video
      X server. The forked child on the other hand will close its video X
      server connection and perform the rendering operation on the X print
      server connection.

 ARGUMENTS    [Toc]    [Back]
      wid       The DtPrintSetupBox widget ID.

      mode      Indicates whether DtPrintResetConnection should close the X
                print server connection, or simply cause the DtPrintSetupBox
                to cease managing the connection.

                Valid values are:

                DtPRINT_CLOSE_CONNECTION    [Toc]    [Back]
                          Set by the parent process when the application
                          forks a child to perform the print rendering. This
                          will cause the DtNclosePrintDisplayCallback list
                          set for the passed DtPrintSetupBox to be called.

                DtPRINT_RELEASE_CONNECTION    [Toc]    [Back]
                          Set when the application wishes to destroy the
                          DtPrintSetupBox widget instance and still perform
                          print rendering using the X print server
                          connection initiated by the widget. For example,
                          the child process of an application that forks to
                          perform print rendering will close the video
                          display connection (thereby destroying the
                          DtPrintSetupBox widget) prior to print rendering.
                          No DtPrintSetupBox callbacks will be called as a

                                    - 1 -       Formatted:  January 24, 2005

 DtPrintResetConnection(library call)   DtPrintResetConnection(library call)

                          result of this operation.

 RETURN VALUE    [Toc]    [Back]
                DtPrintResetConnection was successful.

      DtPRINT_NO_CONNECTION    [Toc]    [Back]
                An open X print server connection is not currently being
                managed by the DtPrintSetupBox.

      DtPRINT_BAD_PARM    [Toc]    [Back]
                The value passed for wid is NULL, or an invalid mode was


 RESOURCES    [Toc]    [Back]



 EXAMPLES    [Toc]    [Back]

 FILES    [Toc]    [Back]

 SEE ALSO    [Toc]    [Back]

                                    - 2 -       Formatted:  January 24, 2005
[ Back ]
 Similar pages
Name OS Title
netprint IRIX Submit lp print job to remote spooler via a network connection
hyperpipeinfo IRIX display information about hyperpipe connection
DtCreatePrintSetupBox HP-UX creates an instance of a DtPrintSetupBox widget
DtCreatePrintSetupDialog HP-UX creates an instance of a dialog containing a DtPrintSetupBox widget
DtPrintSetupProc HP-UX Type definition for DtPrintSetupBox procedure resources.
qlist IRIX display list of print queues on a NetWare server
greset IRIX resets graphics state
DTresetparser IRIX resets a DAT audio data parser
CDresetparser IRIX resets a CD digital audio data parser
XmImMbResetIC HP-UX An input manager function that resets the input context for a widget
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service