Dt/Print.h(file formats)

NAME
Dt/Print.h — print definitions

SYNOPSIS

#include &<Dt/Print.h>

DESCRIPTION

The Dt/Print.h header defines resource names, resource values, callback reasons, callback structures, and function prototypes for the Print widget class.

The Dt/Print.h header defines the following resource names:

DtNcancelCallback
    cancelCallback

DtNclosePrintDisplayCallback
    closePrintDisplayCallback

DtNcopies
    copies

DtNdescription
    description

DtNdestroyContextCallback
    destroyContextCallback

DtNfileName
    fileName

DtNminimizeButtons
    minimizeButtons (if not otherwise named)

DtNoptionCount
    optionCount

DtNoptions
    options

DtNprintCallback
    printCallback

DtNprintDestination
    printDestination

DtNprinterInfoProc
    printerInfoProc

DtNprinterName
    printerName

DtNprintSetupMode
    printSetupMode

DtNselectFileProc
    selectFileProc

DtNselectPrinterProc
    selectPrinterProc

DtNsetupCallback
    setupCallback

DtNverifyPrinterProc
    verifyPrinterProc

DtNworkAreaLocation
    workAreaLocation

DtCCancelCallback
    CancelCallback

DtCClosePrintDisplayCallback
    ClosePrintDisplayCallback

DtCCopies
    Copies

DtCDescription
    Description

DtCDestroyContextCallback
    DestroyContextCallback

DtCFileName
    FileName

DtCMinimizeButtons
    MinimizeButtons (if not otherwise named)

DtCOptionCount
    OptionCount

DtCOptions
    Options

DtCPrintCallback
    PrintCallback

DtCPrintDestination
    PrintDestination

DtCPrinterInfoProc
    PrinterInfoProc

DtCPrinterName
    PrinterName

DtCPrintSetupMode
    PrintSetupMode

DtCSelectFileProc
    SelectFileProc

DtCSelectPrinterProc
    SelectPrinterProc

DtCSetupCallback
    SetupCallback

DtCVerifyPrinterProc
    VerifyPrinterProc

DtCWorkAreaLocation
    WorkAreaLocation

DtRPrintSetupProc
    PrintSetupProc

The Dt/Print.h header declares the following values for the DtNsetupMode resource:

DtPRINT_SETUP_PLAIN
DtPRINT_SETUP_XP

The Dt/Print.h header declares the following values for the DtNworkAreaLocation resource:

DtWORK_AREA_NONE
DtWORK_AREA_TOP
DtWORK_AREA_TOP_AND_BOTTOM
DtWORK_AREA_BOTTOM

The Dt/Print.h header declares the following values for the DtNprintDestination resource:

DtPRINT_NO_DESTINATION
DtPRINT_TO_PRINTER
DtPRINT_TO_FILE

The Dt/Print.h header declares the following values for the DtNprinterNameMode resource:

DtSHORT_NAME
DtMEDIUM_NAME
DtLONG_NAME

The Dt/Print.h header declares the following mode values for DtPrintSetupBoxResetConnection():

typedef enum {
    DtPRINT_CLOSE_CONNECTION,
    DtPRINT_RELEASE_CONNECTION
} DtPrintResetConnectionMode;

The Dt/Print.h header declares the following callback reasons:

DtPRINT_CR_NONE
DtPRINT_CR_CANCEL
DtPRINT_CR_CLOSE_PRINT_DISPLAY
DtPRINT_CR_PRINT
DtPRINT_CR_SETUP

The Dt/Print.h header declares the following return values for the DtPrint procedure:

DtPRINT_SUCCESS,
DtPRINT_BAD_PARM,
DtPRINT_FAILURE,
DtPRINT_INVALID_DISPLAY,
DtPRINT_NOT_XP_DISPLAY,
DtPRINT_NO_CONNECTION,
DtPRINT_NO_DEFAULT,
DtPRINT_NO_DEFAULT_DISPLAY,
DtPRINT_NO_PRINTER,
DtPRINT_PRINTER_MISSING

DtPRINT_SUCCESS
    The X printer connection was successfully obtained.

DtPRINT_BAD_PARM
    The value passed for print_data is NULL, or the value of the DtNprintSetupMode resource for wid is not DtPRINT_SETUP_XP.

DtPRINT_FAILURE
    The X printer connection failed.

DtPRINT_INVALID_DISPLAY
    The indicated X print server could not be found.

DtPRINT_NOT_XP_DISPLAY
    The indicated X server does not support the X Printing Extension.

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

DtPRINT_NO_PRINTER
    The indicated printer could not be found on the X print server, or a default printer could not be determined.

The Dt/Print.h header declares the following class record constants:

WidgetClass dtPrintSetupBoxWidgetClass;
_DtPrintSetupBoxClassRec * DtPrintSetupBoxWidgetClass;
_DtPrintSetupBoxRec      * DtPrintSetupBoxWidget;

The header defines the following callback prototypes:

typedef struct _DtPrintSetupData
{
    String 	printer_name;
    Display 	*print_display;
    XPContext 	print_context;
    XtEnum 	destination;
    String 	dest_info;
} DtPrintSetupData;

typedef struct _DtPrintSetupCallbackStruct
{
    int 		reason;
    XEvent 		*event;
    DtPrintSetupData 	*print_data;
} DtPrintSetupCallbackStruct;

The header defines the following functions:

Widget DtCreatePrintSetupBox(
			     Widget   p,
			     String   name,
			     ArgList  args,
			     Cardinal n);

Widget DtCreatePrintSetupDialog(
				Widget   ds_p,
				String   name,
				ArgList  sb_args,
				Cardinal sb_n);

DtPrintSetupData* DtPrintCopySetupData(
				       DtPrintSetupData*        target,
				       const DtPrintSetupData*  source);

XtEnum DtPrintFillSetupData(
			    Widget 		psub,
			    DtPrintSetupData*   print_data);

void DtPrintFreeSetupData(
			  DtPrintSetupData* target);

XtEnum DtPrintResetConnection(
			      Widget                     psub,
			      DtPrintResetConnectionMode m);

SEE ALSO

DtCreatePrintSetupBox(3), DtCreatePrintSetupDialog(3), DtPrintCopySetupData(3), DtPrintFillSetupData(3), DtPrintFreeSetupData(3), DtPrintResetConnection(3), DtPrintSetupBox(3), Print(4), and dtprintinfo(1).