


DXmCreatePrintDialog(3X)			     DXmCreatePrintDialog(3X)



NAME
  DDXXmmCCrreeaatteePPrriinnttDDiiaalloogg - Creates the print widget with a dialog	box.

SYNOPSIS

  WWiiddggeett DDXXmmCCrreeaatteePPrriinnttDDiiaalloogg ((_p_a_r_e_n_t,, _n_a_m_e,, _a_r_g_l_i_s_t,, _a_r_g_c_o_u_n_t))
	  WWiiddggeett   _p_a_r_e_n_t;;
	  cchhaarr	   **_n_a_m_e;;
	  AArrgglliisstt  _a_r_g_l_i_s_t;;
	  iinntt	   _a_r_g_c_o_u_n_t;;

PARAMETERS

  _w_i_d_g_e_t
      The identifier (widget ID) of the	parent widget.

  _n_a_m_e
      The name of the created widget.

  _a_r_g_l_i_s_t
      The application argument list.

  _a_r_g_c_o_u_n_t
      An integer that represents the number of arguments in the	application
      argument list.

DESCRIPTION

  The DDXXmmCCrreeaatteePPrriinnttDDiiaalloogg routine creates the print widget, which is a	mode-
  less widget that provides applications with a	fast, convenient method	of
  printing one or more files in	multiple formats.

  Resource Information

  You can set the following widget-specific resources in the _a_r_g_l_i_s_t:

       XmString		    DXmNdefaultPrinter;
       Boolean		    DXmNdeleteFile;
       int		    DXmNfileNameCount;
       XmStringTable	    DXmNfileNameList;
       Boolean		    DXmNheader;
       int		    DXmNinputTray;
       XmString		    DXmNjobName;
       XmString		    DXmNlayupDefinition;
       int		    DXmNmessageLog;
       Boolean		    DXmNnotify;
       int		    DXmNnumberCopies;
       int		    DXmNnumberUp;
       XmString		    DXmNoptionsDialogTitle;
       int		    DXmNorientation;
       int		    DXmNoutputTray;
       XmString		    DXmNpageRangeFrom;
       XmString		    DXmNpageRangeTo;
       int		    DXmNpageSize;
       Boolean		    DXmNpassAll;
       XmString		    DXmNprintAfter;
       int		    DXmNprinterCount;
       XmString		    DXmNprinterChoice;
       XmStringTable	    DXmNprinterList;
       XmString		    DXmNprintFormatChoice;
       int		    DXmNprintFormatCount;
       XmStringTable	    DXmNprintFormatList;
       int		    DXmNsheetCount;
       int		    DXmNsheetSize;
       int		    DXmNsides;
       XmString		    DXmNstartSheetComment;
       unsigned	long	    DXmNsuppressOptionsMask;
       Boolean		    DXmNunmanageOnCancel;
       Boolean		    DXmNunmanageOnOk;
       XtCallbackList	    XmNcancelCallback;
       XtCallbackList	    XmNokCallback;

  Resources


  DDXXmmNNaauuttooPPaaggiinnaattiioonn
      A	Boolean	value that, when True, indicates that autopagination (format-
      ting the output into pages based on length or line count)	is turned on.
      When False, autopagination is turned off.	 By default, the value of
      this resource changes when the user switches print formats.  The
      default settings for the print formats are as follows:


      _____________________________________

      Print Format		    Default

      _____________________________________

      Default

				    False

      Text (ANSI Level 0)	    True

      Line Printer (ANSI Level 1)   True

      Terminal			    True

      ANSI2 (ANSI Level	2)	    False

      ANSI (ANSI Level 3)	    False

      PostScript		    False

      ReGIS			    False

      TEK (Tektronix)		    False

      DDIF			    False

      _____________________________________

      Access is	CSG.

  DDXXmmNNddeeffaauullttPPrriinntteerr
      An XmString that allows you to specify a default printer.	 If you	do
      not specify a default printer, the default choice	is either the first
      printer in the list or the printer defined  by the environment variable
      PRINTER.	Access is CSG.

  DDXXmmNNddeelleetteeFFiillee
      A	Boolean	value that controls whether the	file is	deleted	after it is
      printed.	When True, the file is deleted.	 When False, the file is not
      deleted.	The default is False.  The user	must have delete access	to
      the file to delete it.  Access is	CSG.

  DDXXmmNNddoouubblleeSSppaacciinngg
      A	Boolean	value that controls the	state of double-spacing.  When True,
      double-spacing is	turned on.  When False,	double-spacing is turned off.
      The default is False.  Access is CSG.

  DDXXmmNNffiilleeBBuurrssttSShheeeett
      An integer value that allows you to control whether there	will be	a
      File Burst Sheet for your	print job and how frequently it	appears.  The
      possible values are as follows:


      _________________________________________________

      Value		      Description

      _________________________________________________

      DXmFILE_SHEET_DEFAULT

			      Indicates	that you want
			      the default for the queue
			      on which the job is being
			      printed.

      DXmFILE_SHEET_NONE

			      Indicates	that you do not
			      want a Burst Page.

      DXmFILE_SHEET_ONE

			      Indicates	that you want
			      only a single Burst Page
			      that will	precede	the
			      first file printed.

      DXmFILE_SHEET_ALL

			      Indicates	that you want
			      the Burst	Page to	be
			      printed before every file
			      in the print job.

      _________________________________________________

      The default is DXmFILE_SHEET_DEFAULT, or 0.  Access is CSG.

  DDXXmmNNffiilleeEEnnddSShheeeett
      An integer value that allows you to control whether there	will be	a
      File End Sheet for your print job	and how	frequently it is printed.
      The possible values are as follows:


      _________________________________________________

      Value		      Description

      _________________________________________________

      DXmFILE_SHEET_DEFAULT

			      Indicates	that you want
			      the default for the queue
			      on which the job is being
			      printed.

      DXmFILE_SHEET_NONE

			      Indicates	that you do not
			      want a File End Sheet.


      DXmFILE_SHEET_ONE

			      Indicates	that you want
			      only a single File End
			      Sheet to follow the last
			      file printed.


      DXmFILE_SHEET_ALL

			      Indicates	that you want
			      the File End Sheet to be
			      printed after every file
			      in the print job.

      _________________________________________________

      The default is DXmFILE_SHEET_DEFAULT, or 0.  Access is CSG.

  DDXXmmNNffiilleeNNaammeeCCoouunntt
      The number of files specified in the DDXXmmNNffiilleeNNaammeeLLiisstt resource,
      expressed	as an integer value.  The default is 0.	 Access	is CSG.

  DDXXmmNNffiilleeNNaammeeLLiisstt
      An XmStringTable that enables the	print widget to	use the	files speci-
      fied by this resource to make assumptions	about the print	format of the
      files to be printed.  If you set the DDXXmmNNffiilleeNNaammeeLLiisstt resource, you
      must also	set the	value of the DDXXmmNNffiilleeNNaammeeCCoouunntt resource.  The default
      is Null.	Access is CSG.

  DDXXmmNNffiilleeSSttaarrttSShheeeett
      An integer value that allows you to control whether there	will be	a
      File Start Sheet for your	print job and how frequently it	is printed.
      The possible values are as follows:


      __________________________________________________

      Value		      Description

      __________________________________________________

      DXmFILE_SHEET_DEFAULT

			      Indicates	that you want
			      the default for the queue
			      on which the job is being
			      printed.

      DXmFILE_SHEET_NONE

			      Indicates	that you do not
			      want a File Start	Sheet.

      DXmFILE_SHEET_ONE

			      Indicates	that you want
			      only a single File Start
			      Sheet that will precede
			      the first	file.

      DXmFILE_SHEET_ALL

			      Indicates	that you want
			      the File Start Sheet to be
			      printed before every file
			      in the print job.

      __________________________________________________

      The default is DXmFILE_SHEET_DEFAULT, or 0.  Access is CSG.

  DDXXmmNNhheeaaddeerr
      A	Boolean	value that controls whether to print the header.  When True,
      the header is printed.  When False, the header is	not printed.  The
      default is False.	 Access	is CSG.

  DDXXmmNNhhoollddJJoobb
      A	Boolean	value that controls whether the	print job will finish without
      further manual intervention.  If this resource is	True, the print	job
      is held in the print queue servicing the printer until it	is manually
      released by queue	management operations.	The default is False.  Access
      is CSG.

  DDXXmmNNiinnppuuttTTrraayy
      An integer value that allows you to specify the input tray holding the
      medium to	be used	for the	print job.  The	possible values	for DDXXmmNNiinn--
      ppuuttTTrraayy are as follows:


      _________________________________________________

      Value		      Description

      _________________________________________________

      DXmINPUT_TRAY_DEFAULT

			      The default input	tray is
			      that which is specified
			      for the queue.

      DXmINPUT_TRAY_TOP

			      The top input tray is the
			      source of	the medium on
			      which to print.

      DXmINPUT_TRAY_MIDDLE

			      source of	the medium on
			      which to print.

      DXmINPUT_TRAY_BOTTOM

			      source of	the medium on
			      which to print.

      _________________________________________________

      The default is DXmINPUT_TRAY_DEFAULT, or 0.  Access is CSG.

  DDXXmmNNjjoobbNNaammee
      A	pointer	to an XmString that identifies the print job name.  If no job
      name is specified, the job name is derived from the name of the first
      file being printed.  The default is Null.	 Access	is CSG.

  DDXXmmNNllaayyuuppDDeeffiinniittiioonn
      An XmString that allows you  to enter a module name contained in the
      layup library.  This module, in conjunction with the DXmNnumberUp
      resource,	controls how the image is deposited on the medium.  The
      default is Null.	Access is CSG.

  DDXXmmNNmmeessssaaggeeLLoogg
      An integer value that allows you to specify what is to be	done with
      error messages that are created in the course of printing.  The possi-
      ble values for DDXXmmNNmmeessssaaggeeLLoogg are	as follows:


      _________________________________________________________

      Value			      Description

      _________________________________________________________

      DXmMESSAGE_LOG_DEFAULT

				      Accept whatever is speci-
				      fied for the print queue.

      DXmMESSAGE_LOG_IGNORE

				      Nothing is done with the
				      error messages.


      DXmMESSAGE_LOG_PRINT

				      The error	messages are
				      written to the File End
				      Sheet.



      DXmMESSAGE_LOG_KEEP

				      The error	messages are
				      retained in a file.

      DXmMESSAGE_LOG_KEEP_AND_PRINT

				      The error	messages are
				      written to the File End
				      Sheet (or	additional job
				      error sheet) and are
				      retained in a log	file.

      _________________________________________________________

      The default is DXmMESSAGE_LOG_DEFAULT, or	0.  Access is CSG.

  DDXXmmNNnnoottiiffyy
      A	Boolean	value that determines whether the user is notified when	the
      file is printed.	When True, the user is notified.  When False, the
      user is not notified.  The default is True.  Access is CSG.

  DDXXmmNNnnuummbbeerrCCooppiieess
      An integer value that determines the number of copies of the file	to
      print.  The allowable range is from 1 to 255 copies.  The	default	is 0
      (which means to use the system default).	Access is CSG.

  DDXXmmNNnnuummbbeerrUUpp
      An integer value in the range of 0--100 that specifies how many logical
      images are to be printed on one side of a	page.  The default is 0	(one
      logical image, without any adjustments to	how the	image is deposited on
      the medium).  Access is CSG.

  DDXXmmNNooppeerraattoorrMMeessssaaggee
      An XmString that allows you to enter a text field	to be displayed	on
      the operator's console when the job first	starts printing.  DDXXmmNNooppeerraa--
      ttoorrMMeessssaaggee can be	used to	pass messages to the operator concerning the
      handling of the printed output.  The default is Null.  Access is CSG.

  DDXXmmNNooppttiioonnssDDiiaallooggTTiittllee
      Specifies	the title for the secondary dialog box that lists additional
      print options.  The default is "Print: Options".	Access is CSG.

  DDXXmmNNoorriieennttaattiioonn
      An integer value that determines the paper orientation (on printers
      that support this	feature).  The possible	values for orientation are as
      follows:


      _____________________________________________________

      Value			 Description

      _____________________________________________________

      DXmORIENTATION_DEFAULT

				 Allows	you to accept the
				 orientation that is
				 defined for the print
				 queue you have	selected.

      DXmORIENTATION_PORTRAIT

				 Allows	you to force a por-
				 trait orientation to the
				 resulting printout.

      DXmORIENTATION_LANDSCAPE

				 Allows	you to force a
				 landscape orientation to
				 the resulting printout.

      _____________________________________________________

      The default is DXmORIENTATION_DEFAULT, or	0.  Access is CSG.

  DDXXmmNNoouuttppuuttTTrraayy
      An integer value that allows you to specify the output tray in which
      the medium is to be placed after the sheet is printed.  The possible
      values for DXmNoutputTray	are as follows:


      ___________________________________________________

      Value		       Description

      ___________________________________________________

      DXmOUTPUT_TRAY_DEFAULT

			       The default output tray is
			       that which is specified
			       for the queue.

      DXmOUTPUT_TRAY_TOP

			       Allows you to select the
			       top output tray to receive
			       the printed medium.

      DXmOUTPUT_TRAY_SIDE

			       Allows you to select the
			       side output tray	to
			       receive the printed
			       medium.

      DXmOUTPUT_TRAY_FACE_UP

			       Allows you to select the
			       faceup output tray to
			       receive the printed
			       medium.

      DXmOUTPUT_TRAY_UPPER

			       Allows you to select the
			       upper output tray to
			       receive the printed
			       medium.

      DXmOUTPUT_TRAY_LOWER

			       Allows you to select the
			       lower output tray to
			       receive the printed
			       medium.

      ___________________________________________________

      The default is DXmOUTPUT_TRAY_DEFAULT, or	0.  Access is CSG.

  DDXXmmNNppaaggeeRRaannggeeFFrroomm
      A	pointer	to an XmString that identifies the starting page of the	file
      to print.	 The DDXXmmNNppaaggeeRRaannggeeFFrroomm and DDXXmmNNppaaggeeRRaannggeeTToo resources allow
      you to enter a range of pages to be printed if you chose not to print a
      file in its entirety.  When using	this resource, note the	following:

	oo++
	If you want to start printing at the first page	of the file, you may
	leave the DDXXmmNNppaaggeeRRaannggeeFFrroomm resource blank (no value specified).

	oo++
	If you specify a value for the DXmNpageRangeTo resource, the
	DDXXmmNNppaaggeeRRaannggeeFFrroomm resource must	be less	than or	equal to that value.

      The default is Null.  Access is CSG.

  XXmmNNppaaggeeRRaannggeeTToo
      A	pointer	to an XmString that identifies the last	page of	the file to
      print.  The DDXXmmNNppaaggeeRRaannggeeFFrroomm and	DDXXmmNNppaaggeeRRaannggeeTToo	resources allow	you
      to enter a range of pages	to be printed if you chose not to print	a
      file in its entirety.

      The DDXXmmNNppaaggeeRRaannggeeTToo resource may be left blank to	print to the last
      page of the file.	 The default is	Null.  Access is CSG.

  DDXXmmNNppaaggeeSSiizzee
      An integer value that determines the logical (or virtual)	size of	the
      print image.  The	possible values	for page size are as follows:


      __________________________________________________________

      Value			  Size in Inches   Size	in MM

      __________________________________________________________

      DXmSIZE_DEFAULT		  Queue	Default

						   Queue Default

      DXmSIZE_LETTER		  8.5 x	11

						   216 x 279

      DXmSIZE_LEDGER		  11 x 17

						   279 x 432

      DXmSIZE_LEGAL		  8.5 x	14

						   216 x 356

      DXmSIZE_EXECUTIVE		  7.5 x	QQQ10

						   191 x 254

      DXmSIZE_A5		  5.8 x	8.3

						   148 x 210

      DXmSIZE_A4		  8.3 x	11.7

						   210 x 297

      DXmSIZE_A3		  11.7 x 16.5

						   297 x 420

      DXmSIZE_B5		   7.2 x QQQ10.1

						   176 x 250

      DXmSIZE_B4		  10.1 x 14.3

						   250 x 353

      DXmSIZE_C4_ENVELOPE	  9 x 12.8

						   229 x 324

      DXmSIZE_C5_ENVELOPE	  6.4 x	9

						   162 x 229

      DXmSIZE_C56_ENVELOPE	  4.3 x	8.7

						   110 x 220

      DXmSIZE_10X13_ENVELOPE	  10 x 13

						   254 x 330.2

      DXmSIZE_9X12_ENVELOPE	  9 x 12

						   228.6 x 304.8

      DXmSIZE_BUSINESS_ENVELOPE	  4.125	x 9.5

						   104.8 x 241.3

      __________________________________________________________

      The default is DXmSIZE_DEFAULT.  Access is CSG.

  DDXXmmNNppaassssAAllll
      A	Boolean	value that, when True, allows all control characters to	be
      passed to	the printer.  By default, the value of this resource changes
      when the user switches print formats.  The default settings for the
      print formats are	as follows:


      _____________________________________

      Print Format		    Default

      _____________________________________

      Default			    False

      Text (ANSI Level 0)	    False

      Line Printer (ANSI Level 1)   False

      Terminal			    False

      ANSI2 (ANSI Level	2)	    True

      ANSI (ANSI Level 3)	    True

      PostScript		    False

      ReGIS			    False

      TEK (Tektronix)		    True

      DDIF			    True

      _____________________________________

      Access is	CSG.

  DDXXmmNNpprriinnttAAfftteerr
      An XmString that allows you to enter a time and date when	this print
      job first	becomes	eligible to be scheduled for printing.	The XmString
      for the time and date must be the	standard format	for your operating
      system.  Check the aatt(1) reference page to obtain	the proper format.
      If this resource is not specified, the job becomes eligible for immedi-
      ate print	scheduling.  The job also becomes eligible for immediate
      print scheduling if the user specifies this resource but specifies
      either nothing or	"now" as the XmString.	The default is "now".  Access
      is CSG.

  DDXXmmNNpprriinntteerrCChhooiiccee
      An XmString that specifies the printer to	use for	the current print
      format.  Applications usually use	this resource to store information
      about a user's printer preference.

      If you set this resource,	the XmString must exactly match	one of the
      print widget's supported printers, including the character set.  The
      recommended approach is to not specify this resource when	the print
      widget is	first managed.	Then, once the user has	selected a print for-
      mat, call	the XXttGGeettVVaalluueess	routine	to obtain the value and	then XXttSSeettAArrgg
      to set DDXXmmNNpprriinntteerrCChhooiiccee.

      The print	widget sets this resource as follows:

	oo++
	If the user selects a new print	format,	the printer queue box might
	be re-populated	(assuming the user has set up the print	queue logi-
	cals).

	oo++
	If the user has	chosen this print format before	and has	already
	chosen a printer for this format, the print widget identifies this
	printer	as the DDXXmmNNpprriinntteerrCChhooiiccee resource.  The	printer	is automati-
	cally selected,	regardless of the previous queue choice.

	oo++
	If the user has	not previously selected	this print format,  the	print
	widget determines whether there	is a printer that matches the one
	defined	by DDXXmmNNddeeffaauullttPPrriinntteerr.	If that	printer	is available, the
	print widget selects it; otherwise the print widget selects the	first
	printer	in the list.  The default is Null.  Access is CSG.

  DDXXmmNNpprriinntteerrCCoouunntt
      The number of printers specified in the DDXXmmNNpprriinntteerrLLiisstt resource,
      expressed	as an integer.	If your	application requires the value of
      this resource, call the XXttGGeettVVaalluueess routine to obtain the	value.

      You cannot set a value for this resource.	 The default is	0.  Access is
      G.

  DDXXmmNNpprriinntteerrFFoorrmmCChhooiiccee
      An XmString that specifies the printer form to use as the	default.  Use
      this resource when you want your application to record a user's printer
      preference.

      Note that	if you set this	resource, the XmString must exactly match one
      of the operating system's	supported printer forms.  (Use the DDXXmmCCvvttOOSS--
      TTooCCSS routine to convert the string to an XmString.) Digital recommends
      that you do not specify this resource when the print widget is first
      managed.	Instead, after the user	has selected a printer form,  call
      the Intrinsic routines XXttGGeettVVaalluueess to obtain the value and XXttSSeettAArrgg to
      set DDXXmmNNpprriinntteerrFFoorrmmCChhooiiccee.  The default is Null.	Access is CSG.

  DDXXmmNNpprriinntteerrFFoorrmmLLiisstt
      An XmStringTable list of the available printer forms.  If	your applica-
      tion requires the	value of this resource,	call the XXttGGeettVVaalluueess routine
      to obtain	the value.

      You cannot set a value for this resource.	 The default is	Null.  Access
      is G.

  DDXXmmNNpprriinntteerrFFoorrmmCCoouunntt
      The number of printer forms specified in the DDXXmmNNpprriinntteerrFFoorrmmLLiisstt
      resource,	expressed as an	integer	value.	If your	application requires
      the value	of this	resource, call the XtGetValues routine to obtain the
      value.

      You cannot set a value for this resource.	The default is 0.  Access is
      G.

  DDXXmmNNpprriinntteerrLLiisstt
      An XXmmSSttrriinnggTTaabbllee that determines the names to appear in the Printer
      list box.	 If your application requires the value	of this	resource,
      call the XXttGGeettVVaalluueess routine to obtain the value.

      You cannot set a value for this resource.	The default is Null.  Access
      is G.

  DDXXmmNNpprriinnttFFoorrmmaattCChhooiiccee
      An XmString that specifies the print format to use as the	default.  Use
      this resource when you want your application to record a user's print
      format preference.

      Note that	if you set this	resource, the XmString must exactly match one
      of the print widget's supported print formats, including the character
      set.  Digital recommends that you	do not specify this resource when the
      print widget is first managed.  Instead, after the user has selected a
      print format,  call the Intrinsic	routines XXttGGeettVVaalluueess to	obtain the
      value and	XXttSSeettAArrgg to set	DDXXmmNNpprriinnttFFoorrmmaattCChhooiiccee.	The default is Null.
      Access is	CSG.

  DDXXmmNNpprriinnttFFoorrmmaattCCoouunntt
      The number of print formats specified in the DDXXmmNNpprriinnttFFoorrmmaattLLiisstt
      resource,	expressed as an	integer	value.	The default is 0.  Access is
      CSG.

  DDXXmmNNpprriinnttFFoorrmmaattLLiisstt
      An XXmmSSttrriinnggTTaabbllee that determines the print widget's print	format list,
      which is the list	of print formats that are understood by	the print
      widget.  If you set this resource, each XmString in the table must
      exactly match one	of the print widget's supported	print formats.

      The print	widget supports	the following data formats:

	oo++
	Default	(no data type specification is output)

	oo++
	Text (ANSI Level 0)

	oo++
	Line Printer (ANSI Level 1)

	oo++
	Terminal

	oo++
	ANSI2 (ANSI Level 2)

	oo++
	ANSI (ANSI Level 3)

	oo++
	PostScript

	oo++
	ReGIS

	oo++
	Tektronix

	oo++
	DDIF

      The default is Null.  Access is CSG.

  DDXXmmNNpprriioorriittyy
      An integer value that determines the priority of the job (0--255)	in
      the print	queue.	If no priority is specified (a value of	0), the
      default priority for that	queue is used.	The default is 0.  Access is
      CSG.

  DDXXmmNNsseettuupp
      An XmString that allows you to enter the comma-separated names of	one
      or more setup modules to be transmitted to the printer ahead of the
      file to be printed.  The default is Null.	 Access	is CSG.

  DDXXmmNNsshheeeettCCoouunntt
      An integer value in the range of 0--10000	that specifies how many	times
      each sheet is to be printed.  This option	is most	frequently used	with
      PostScript printers, which require only a	single transmission of infor-
      mation to	replicate a complex image (instead of multiple transmissions
      of the same information).	 The default is	0.  Access is CSG.

  DDXXmmNNsshheeeettSSiizzee
      An integer value that determines the size	of the medium on which the
      printing is to take place.  The possible values for sheet	size are as
      follows:


      __________________________________________________________

      Value			  Size in Inches   Size	in MM

      __________________________________________________________

      DXmSIZE_DEFAULT		  Queue	Default

						   Queue Default

      DXmSIZE_LETTER		  8.5 x	11

						   216 x 279

      DXmSIZE_LEDGER		  11 x 17

						   279 x 432

      DXmSIZE_LEGAL		  8.5 x	14

						   216 x 356

      DXmSIZE_EXECUTIVE		  7.5 x	QQQ10

						   191 x 254

      DXmSIZE_A5		  5.8 x	8.3

						   148 x 210

      DXmSIZE_A4		  8.3 x	11.7

						   210 x 297

      DXmSIZE_A3		  11.7 x 16.5

						   297 x 420

      DXmSIZE_B5		   7.2 x QQQ10.1

						   176 x 250

      DXmSIZE_B4		  10.1 x 14.3

						   250 x 353

      DXmSIZE_C4_ENVELOPE	  9 x 12.8

						   229 x 324

      DXmSIZE_C5_ENVELOPE	  6.4 x	9

						   162 x 229

      DXmSIZE_C56_ENVELOPE	  4.3 x	8.7

						   110 x 220

      DXmSIZE_10X13_ENVELOPE	  10 x 13

						   254 x 330.2

      DXmSIZE_9X12_ENVELOPE	  9 x 12

						   228.6 x 304.8

      DXmSIZE_BUSINESS_ENVELOPE	  4.125	x 9.5

						   104.8 x 241.3

      __________________________________________________________

      The default is DXmSIZE_DEFAULT, or 0.  Access is CSG.

  DDXXmmNNssiiddeess
      An integer value that determines	on how many sides of a medium the
      printing is to take place	and the	manner in which	the medium is turned
      when switching from one side to the other.

      The possible values for DXmNsides	are as follows:


      _________________________________________________

      Value		     Description

      _________________________________________________

      DXmSIDES_DEFAULT

			     The default for the queue
			     on	which you are printing.

      DXmSIDES_SIMPLEX_ONE

			     Prints on one side	only.
			     This is also known	as
			     one-sided-simplex.


      DXmSIDES_SIMPLEX_TWO

			     Prints on two sides of the
			     sheet, but	uses the same
			     page layout conventions
			     required for single-sided
			     printing.	The layout
			     reflects margin and page
			     number locations and
			     related specifications.
































































      DXmSIDES_DUPLEX_ONE

			     Prints only on the	first
			     side of each sheet, but
			     retains the page layout
			     intended for duplex print-
			     ing.  The layout reflects
			     margin and	page number
			     locations and related
			     specifications.

      DXmSIDES_DUPLEX_TWO

			     Prints on two sides; the
			     second side is accessed by
			     flipping the page along
			     its left edge, like turn-
			     ing the pages of a	book.
			     This is also known	as
			     two-sided-duplex.

      DXmSIDES_TUMBLE_ONE

			     Prints only on the	first
			     side of each sheet, but
			     retains the page layout
			     intended for tumble print-
			     ing.  The layout reflects
			     margin and	page number
			     locations and related
			     specifications.

      DXmSIDES_TUMBLE_TWO

			     Prints on two sides, and
			     the second	side is	reached
			     by	flipping the page along
			     its top edge, like	turning
			     the pages of a legal docu-
			     ment.  This is also known
			     as	two-sided-tumble.

      _________________________________________________

      The default is DXmSIDES_DEFAULT, or 0.  Access is	CSG.

  DDXXmmNNssttaarrttSShheeeettCCoommmmeenntt
      The XmString to appear on	your File Start	Sheet.	The default is Null.
      Access is	CSG.

  DDXXmmNNssuupppprreessssOOppttiioonnssMMaasskk
      Suppresses certain print widget features,	such as	the number of print
      choices available	to the user.  The possible values for this resource
      are as follows:

	oo++
	DXmSUPPRESS_AUTOMATIC_PAGINATION

	oo++
	DXmSUPPRESS_DELETE_FILE

	oo++
	DXmSUPPRESS_DOUBLE_SPACING

	oo++
	DXmSUPPRESS_FILE_BURST_SHEET

	oo++
	DXmSUPPRESS_FILE_END_SHEET

	oo++
	DXmSUPPRESS_FILE_START_SHEET

	oo++
	DXmSUPPRESS_HEADER

	oo++
	DXmSUPPRESS_HOLD_JOB

	oo++
	DXmSUPPRESS_INPUT_TRAY

	oo++
	DXmSUPPRESS_JOB_NAME

	oo++
	DXmSUPPRESS_LAYUP_DEFINITION

	oo++
	DXmSUPPRESS_MESSAGE_LOG

	oo++
	DXmSUPPRESS_NONE

	oo++
	DXmSUPPRESS_NOTIFY

	oo++
	DXmSUPPRESS_NUMBER_COPIES

	oo++
	DXmSUPPRESS_NUMBER_UP

	oo++
	DXmSUPPRESS_OPERATOR_MESSAGE

	oo++
	DXmSUPPRESS_ORIENTATION

	oo++
	DXmSUPPRESS_OUTPUT_TRAY

	oo++
	DXmSUPPRESS_PAGE_RANGE

	oo++
	DXmSUPPRESS_PAGE_SIZE

	oo++
	DXmSUPPRESS_PASS_ALL

	oo++
	DXmSUPPRESS_PRINT_AFTER

	oo++
	DXmSUPPRESS_PRINT_FORMAT

	oo++
	DXmSUPPRESS_PRINTER

	oo++
	DXmSUPPRESS_PRINTER_FORM

	oo++
	DXmSUPPRESS_PRIORITY

	oo++
	DXmSUPPRESS_SETUP

	oo++
	DXmSUPPRESS_SHEET_COUNT

	oo++
	DXmSUPPRESS_SHEET_SIZE

	oo++
	DXmSUPPRESS_SIDES

	oo++
	DXmSUPPRESS_START_SHEET_COMMENT

      The default value	is dependent upon the print capabilities of the	par-
      ticular operating	system.	 Access	is CSG.

  DDXXmmNNuunnmmaannaaggeeOOnnCCaanncceell
      A	Boolean	value that specifies whether the print widget automatically
      unmanages	itself when the	Cancel button in the primary box is pressed.
      The default is False.  Access is CSG.

  DDXXmmNNuunnmmaannaaggeeOOnnOOkk
      A	Boolean	value that specifies whether the print widget automatically
      unmanages	itself when the	Ok button in the primary box is	pressed.  The
      default is False.	 Access	is CSG.

  XXmmNNccaanncceellCCaallllbbaacckk
      Callback made when the user clicks on the	Cancel pushbutton in the
      print widget primary dialog box.	If the DDXXmmNNuunnmmaannaaggeeOOnnCCaanncceell resource
      is set, the print	widget automatically unmanages itself when the Cancel
      button in	the primary box	is pressed.  The callback reason is
      XXmmCCRR__CCAANNCCEELL.  The	default	is Null.  Access is CSG.

      Your application can use the XXmmNNccaanncceellCCaallllbbaacckk callback to perform
      related functions	as well.

  XXmmNNookkCCaallllbbaacckk
      Callback made when the user clicks on the	Ok pushbutton in the print
      widget primary dialog box.  If the DXmNunmanageOnOk resource is set,
      the print	widget automatically unmanages itself when the Ok button in
      the primary box is pressed.  The callback	reason is XXmmCCRR__OOKK.  The
      default is Null.	Access is CSG.

      Note that	your application can use the XXmmNNookkCCaallllbbaacckk callback to per-
      form other functions, such as calling DDXXmmPPrriinnttWWggttPPrriinnttJJoobb	to submit the
      print job.

  Resource Information


  ttyyppeeddeeff ssttrruucctt {{
	iinntt	_r_e_a_s_o_n;;
	XXEEvveenntt	**_e_v_e_n_t;;	}} XXmmAAnnyyCCaallllbbaacckkSSttrruucctt;;

  CCaallllbbaacckk FFiieelldd DDeessccrriippttiioonnss

  _r_e_a_s_o_n
      An integer set to	the callback reason.  See the Callback Reasons sec-
      tion for the values that are valid for this widget.

  _e_v_e_n_t
      A	pointer	to the X event structure describing the	event that generated
      this callback.

  Callback Reasons


  XXmmCCRR__OOKK
      The user activated the Ok	pushbutton in the print	widget primary dialog
      box.

  XXmmCCRR__CCAANNCCEELL
      The user activated the Cancel pushbutton in the print widget primary
      dialog box.

  Inherited Resources

  DDXXmmCCrreeaatteePPrriinnttDDiiaalloogg inherits	behaviour and resources	from the following
  superclasses:

       Core Resource Set
       Composite Resource Set
       Constraint Resource Set
       XmManager Resource Set
       XmBulletinBoard Resource	Set
       DXmPrintDialog Resource Set

RETURN VALUES

  The identifier (widget ID) of	the created print widget.

RELATED	INFORMATION

  DDXXmmPPrriinnttWWggttAAuuggmmeennttLLiisstt(3X), DDXXmmPPrriinnttWWggttPPrriinnttJJoobb(3X)








































