DtPrintResetConnection man page on HP-UX

Man page or keyword search:  
man Server   10987 pages
apropos Keyword Search (all sections)
Output format
HP-UX logo
[printable version]

DtPrintResetConnection(library call)	  DtPrintResetConnection(library call)

NAME
       DtPrintResetConnection — resets the print display connection managed by
       a DtPrintSetupBox

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

DESCRIPTION
       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  parame‐
       ter  is	included in order to direct the widget to close the print con‐
       nection 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
       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
			   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
			   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  con‐
			   nection  (thereby  destroying  the  DtPrintSetupBox
			   widget) prior to print rendering. No	 DtPrintSetup‐
			   Box	callbacks  will	 be called as a result of this
			   operation.

RETURN VALUE
       DtPRINT_SUCCESS
		 DtPrintResetConnection was successful.

       DtPRINT_NO_CONNECTION
		 An open X print server connection is not currently being man‐
		 aged by the DtPrintSetupBox.

       DtPRINT_BAD_PARM
		 The  value  passed  for  wid  is NULL, or an invalid mode was
		 passed.

ENVIRONMENT VARIABLES
       None.

RESOURCES
       None.

ACTIONS/MESSAGES
       None.

ERRORS/WARNINGS
       None.

EXAMPLES
       None.

FILES
       None.

SEE ALSO
       DtPrintSetupBox(3)

					  DtPrintResetConnection(library call)
[top]

List of man pages available for HP-UX

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net