


DXmPrintWgtAugmentList(3X)			   DXmPrintWgtAugmentList(3X)



NAME
  DDXXmmPPrriinnttWWggttAAuuggmmeennttLLiisstt - Defines additional print formats and	lets you add
  new options to the print widget option menus.

SYNOPSIS

  uunnssiiggnneedd lloonngg	iinntt DDXXmmPPrriinnttWWggttAAuuggmmeennttLLiisstt ((_p_w,,_l_i_s_t,,_d_a_t_a))
		     WWiiddggeett	_p_w;;
		     iinntt	_l_i_s_t;;
		     XXttPPooiinntteerr	_d_a_t_a;;

PARAMETERS

  _p_w  The print	widget.

  _l_i_s_t
      The print	formats	or options, indicated by the following values:


      ________________________________________________

      Value		    Description

      ________________________________________________

      DXmFILE_BURST_SHEET

			    Specifies the availability
			    and	frequency of printed
			    File Burst Sheets.

      DXmFILE_END_SHEET

			    Specifies the availability
			    and	frequency of printed
			    File End Sheets.

      DXmFILE_START_SHEET

			    Specifies the availability
			    and	frequency of printed
			    File Start Sheets.

      DXmINPUT_TRAY

			    Specifies the input	tray
			    holding the	sheet to be
			    used for the print job.

      DXmMESSAGE_LOG

			    Specifies what is to be
			    done with error messages
			    generated during the print
			    operation.

      DXmOUTPUT_TRAY

			    Specifies the output tray
			    in which the sheet is to
			    be placed.

      DXmPAGE_SIZE

			    Specifies the size of the
			    print image.

      DXmPRINT_FORMAT

			    Specifies the print	for-
			    mat.

      DXmSHEET_SIZE

			    Specifies the size of the
			    sheet.

      DXmSIDES

			    Specifies how many sides
			    of the sheet will be
			    printed.

      ________________________________________________

  _d_a_t_a
      One of the following data	structures:

	oo++
	DDXXmmPPrriinnttFFoorrmmaattSSttrruucctt, which has	the following structure:


	     ttyyppeeddeeff ssttrruucctt __DDXXmmPPrriinnttFFoorrmmaattSSttrruucctt
	     {{
		  XXmmSSttrriinngg   _u_i__s_t_r_i_n_g;;
		  XXmmSSttrriinngg   _o_s__s_t_r_i_n_g;;
		  XXmmSSttrriinngg   _v_a_r__s_t_r_i_n_g;;

	     }} DDXXmmPPrriinnttFFoorrmmaattSSttrruucctt;;

	   _u_i__s_t_r_i_n_g
	       Specifies the label displayed in	the user interface.

	   _o_s__s_t_r_i_n_g
	       Specifies a string that identifies the print format to the
	       operating system.

	   _v_a_r__s_t_r_i_n_g
	       Specifies the UNIX  environment variable	that identifies	the
	       print format.

	oo++
	DDXXmmPPrriinnttOOppttiioonnMMeennuuSSttrruucctt, which	has the	following structure:



	ttyyppeeddeeff	ssttrruucctt __DDXXmmPPrriinnttOOppttiioonnMMeennuuSSttrruucctt {{
	     XXmmSSttrriinngg	_u_i__s_t_r_i_n_g;;
	     XXmmSSttrriinngg	_o_s__s_t_r_i_n_g;;

	}} DDXXmmPPrriinnttOOppttiioonnMMeennuuSSttrruucctt;;

	   _u_i__s_t_r_i_n_g
	       Specifies the label displayed in	the user interface.

	   _o_s__s_t_r_i_n_g
	       Specifies a string that identifies the print option for the
	       operating system.

DESCRIPTION

  The DDXXmmPPrriinnttWWggttAAuuggmmeennttLLiisstt routine defines additional	print formats and
  lets you add new options to the print	widget option menus.  Note that	the
  return value (an integer) is not required when adding	print formats.	How-
  ever,	the Intrinsics routines	XXttGGeettVVaalluueess and	XXttSSeettVVaalluueess use	that integer
  when subsequent calls	are made on the	option menus.



RETURN VALUES

  An integer that represents either the	number of print	formats	known to the
  print	widget or the identifier of a new option added to the print widget
  option menu, depending on the	operation performed.  A	Null return indicates
  that the addition of a print format or option	was unsuccessful.

RELATED	INFORMATION

  DDXXmmCCrreeaatteePPrriinnttBBooxx(3X), DDXXmmCCrreeaatteePPrriinnttDDiiaalloogg(3X), DDXXmmPPrriinnttWWggttPPrriinnttJJoobb(3X)

  _X _W_i_n_d_o_w _S_y_s_t_e_m _T_o_o_l_k_i_t
  _D_E_C_w_i_n_d_o_w_s _M_o_t_i_f _G_u_i_d_e _t_o _A_p_p_l_i_c_a_t_i_o_n	_P_r_o_g_r_a_m_m_i_n_g



























































