dtprintsetupproc(3) [hpux man page]

DtPrintSetupProc(library call)											    DtPrintSetupProc(library call)

NAME

       DtPrintSetupProc -- Type definition for DtPrintSetupBox procedure resources.

SYNOPSIS

       #include <Print.h>
       typedef XtEnum (*DtPrintSetupProc)(
       Widget wid,
       DtPrintSetupData *print_data);

DESCRIPTION

       DtPrintSetupProc  is  the  type	definition  used  for  DtPrintSetupBox	procedure resources. Each procedure is passed the widget ID of the
       DtPrintSetupBox via wid, and a structure containing information needed to perform the particular operation via print_data.

       If a procedure needs to update the DtPrintSetupBox, it should do so by setting resources as indicated by the  procedure	resource  descrip-
       tion.  The only exception to this is when the DtNverifyPrinterProc is used to verify X printers. In this case, the procedure may update the
       print_display and print_context elements of the passed DtPrintSetupData structure.

ARGUMENTS

       wid	 The widget ID of the DtPrintSetupBox.

       print_data
		 A pointer to an existing DtPrintSetupData structure that contains the print setup information relevant to the specific procedure.

RETURN VALUE

       DtPRINT_SUCCESS
		 The procedure completed successfully.

       DtPRINT_FAILURE
		 The procedure encountered an error.

       DtPRINT_BAD_PARM
		 An invalid parameter was passed to the procedure.

SEE ALSO

       DtPrintSetupBox(3)

														    DtPrintSetupProc(library call)

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 parameter 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. Immedi-
       ately 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 connection (thereby destroying the DtPrintSetupBox  widget)  prior
			   to print rendering. No DtPrintSetupBox 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 managed 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)