DtPrintResetConnection(library call) DtPrintResetConnection(library call)
NAMEDtPrintResetConnection — 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 ALSODtPrintSetupBox(3)
DtPrintResetConnection(library call)