Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
DtPrintSetupBox(library	call)			 DtPrintSetupBox(library call)

NAME
       DtPrintSetupBox -- application print setup widget

SYNOPSIS
       #include	<Dt/Print.h>

DESCRIPTION
       DtPrintSetupBox	is  a widget that is typically the initial window used
       to set various options prior to printing	 from  an  application.	  This
       widget is designed primarily for	use by applications that utilize the X
       Print Service. However, it can also be used by  applications  employing
       other printing methods.

       DtPrintSetupBox	is organized based on generic print options and	appli-
       cation specific print options. The sections are clearly demarcated with
       separators to set off the generic section from the application specific
       section(s). By utilizing	the DtNworkAreaLocation	resource, the applica-
       tion developer can choose to utilize an area above the generic section,
       below the generic section, or both above	and below the generic section.

       The four	default	buttons	(Print,	Setup, Cancel, and Help)  are  consid-
       ered  generic  buttons.	Applications can create	additional pushbuttons
       as children of DtPrintSetupBox. These buttons will be laid out  follow-
       ing the Print button.

       The  Printer  Name  combo  box  contains	the X printer specifier	of the
       printer to be used for the print	job. The X  printer  specifier	is  an
       identifier  that	 uniquely  identifies an X printer. The	format of this
       specifier is printerName@host: display.

   Descendants
       DtPrintSetupBox creates the descendants shown in	the  following	table.
       An  application	can use	XtNameToWidget to gain access to the named de-
       scendent. In addition, a	user or	an application can use the  descendant
       name when specifying resource values.

       Named Descendant		 Class		       Identity
       BottomWorkAreaSeparator	 XmSeparatorGadget     Separator  above	the bot-
						       tom work	area
       ButtonSeparator		 XmSeparatorGadget     Separator above the pushbuttons
       Cancel			 XmPushButtonGadget    Cancel button
       Copies			 XmSimpleSpinBox       SpinBox	containing   the
						       number of copies
       CopiesLabel		 XmLabelGadget	       Label for the Copies SpinBox
       DescriptionLabel		 XmLabelGadget	       Label for the printer description
       FileName			 XmTextField	       File name field
       FileNameCheckBox		 XmRowColumn	       Check  box  (includes la-
						       bel) for	file name field
       Help			 XmPushButtonGadget    Help button
       Info			 XmPushButtonGadget    Printer information button
       Name			 XmComboBox	       Printer name
       NameLabel		 XmLabelGadget	       Label for the printer name field
       Print			 XmPushButtonGadget    Print button
       SelectFile		 XmPushButtonGadget    Select File button
       SelectPrinter		 XmPushButtonGadget    Select Printer button
       Setup			 XmPushButtonGadget    Setup button
       TopWorkAreaSeparator	 XmSeparatorGadget     Separator below the top work area

   Classes
       DtPrintSetupBox inherits	behavior and resources from the	Core,  Compos-
       ite, Constraint,	XmManager, and XmBulletinBoard superclasses.

       The class pointer is dtPrintSetupBoxWidgetClass.

       The class name is DtPrintSetupBox.

   Resources
       The following table lists the DtPrintSetupBox resources.

       Name			      Class/Type			    Access	Default	Value
       DtNcancelCallback	      DtCCancelCallback/XtCallbackList	    C		NULL
       DtNclosePrintDisplayCallback   DtCCloseDisplayCall-		    C		NULL
				      back/XtCallbackList
       DtNcopies		      DtCCopies/int			    CSG		1
       DtNdescription		      DtCDescription/XmString		    CSG		dynamic
       DtNfileName		      DtCPrintToFileName/String		    CSG		NULL
       DtNgetAttributesCallback	      DtCGetAttributesCall-		    C		NULL
				      back/XtCallbackList
       DtNminimizeButtons	      DtCminimizeButtons/Boolean	    CSG		False
       DtNprintCallback		      DtCPrintCallback/XtCallbackList	    C		NULL
       DtNprintDestination	      DtCPrintDestination/XtEnum	    CSG		DtPRINT_TO_PRINTER
       DtNprinterInfoProc	      DtCPrinterInfoProc/DtPrintSetupProc   CSG		dynamic
       DtNprinterName		      DtCPrinter/String			    CSG		dynamic
       DtNprintSetupMode	      DtCPrintSetupMode/XtEnum		    CG		DtPRINT_SETUP_XP
       DtNselectFileProc	      DtCSelectFileProc/DtPrintSetupProc    CSG		default	procedure
       DtNselectPrinterProc	      DtCSelectPrinterProc/Dt-		    CSG		dynamic
				      PrintSetupProc
       DtNsetAttributesCallback	      DtCSetAttributesCall-		    C		NULL
				      back/XtCallbackList
       DtNsetupProc		      DtCSetupProc/DtPrintSetupProc	    CSG		dynamic
       DtNsetupProc		      DtCSetupProc/DtPrintSetupProc	    CSG		dynamic
       DtNverifyPrinterProc	      DtCVerifyPrinterProc/Dt-		    CSG		dynamic
				      PrintSetupProc
       DtNworkAreaLocation	      DtCworkAreaLocation/XtEnum	    CSG		DtWORK_AREA_BOTTOM

       The DtPrintSetupBox resources are defined as follows:

       DtNcancelCallback
		 Specifies the list of callbacks that is called	when the  Can-
		 cel   button	is  activated.	The  callback  reason  is  Dt-
		 PRINT_CR_CANCEL.

       DtNclosePrintDisplayCallback
		 When the value	 of  the  DtNprintSetupMode  resource  is  Dt-
		 PRINT_SETUP_XP,  DtPrintSetupBox  will	 manage	the X printing
		 display connection and	print context. As such,	DtNclosePrint-
		 DisplayCallback  is  provided to allow	an application to per-
		 form any desired processing (such as destroying windows  cre-
		 ated  on  the	print display) before DtPrintSetupBox destroys
		 the current print context and closes the current  print  dis-
		 play connection.

		 This callback list will not be	called if the value of the Dt-
		 NprintSetupMode  resource  is	 anything   other   than   Dt-
		 PRINT_SETUP_XP.

		 The callback reason is	DtPRINT_CR_CLOSE_PRINT_DISPLAY.

       DtNcopies The number of copies of the document to print.	This is	a spin
		 box into which	the user may enter a positive integer.

       DtNdescription
		 A description of the printer as provided by the system	admin-
		 istrator.

       DtNfileName
		 Specifies  the	name of	the destination	file. Setting this re-
		 source	will update the	value of the File Name text field.

       DtNgetAttributesCallback
		 Specifies the list of callbacks that is called	 whenever  Dt-
		 PrintSetupBox receives	an XPAttributeNotify event, or immedi-
		 ately after a new X printer connection	is  established.  This
		 callback  list	 will  only  be	called if the value of the Dt-
		 NprintSetupMode resource is DtPRINT_SETUP_XP.

		 This callback is intended to be  used	by  applications  that
		 utilize  X  Print Service attributes directly.	These applica-
		 tions will be interested in changes made to the printing  at-
		 tributes  by  DtPrintSetupBox	or by other processes, such as
		 the Print Dialog Manager (PDM).

		 One of	two callback reason codes will be set for  this	 call-
		 back.	The two	reasons	are of particular interest to applica-
		 tions that elect to present information in their GUI based on
		 X  Print Service attributes. The following indicates how such
		 applications should respond to	each code:

		 DtPRINT_CR_GET_STATIC_ATTRIBUTES
			   The application should update only  those  controls
			   that	cannot be modified by the user.	This reason is
			   set in response to encountering a new  set  of  at-
			   tributes  as	the result of DtPrintSetupBox's	estab-
			   lishing a new X printer  connection.	 Additionally,
			   subsequent  immediate  action  to  be  taken	by Dt-
			   PrintSetupBox's  will  result  in   the   DtNsetAt-
			   tributesCallback  list being	called followed	by ei-
			   ther	the DtNprintCallback list or the DtNsetupProc.
			   If  the application were to update dynamic GUI con-
			   trols within	this DtNgetAttributesCallback, any in-
			   put	the  user  provided would be overridden	by the
			   printer defaults in	the  resulting	print  job  or
			   setup dialog.

		 DtPRINT_CR_GET_ATTRIBUTES
			   The	application  should  update all	static and dy-
			   namic controls. This	reason is set in  response  to
			   DtPrintSetupBox's  receiving	 an  XpAttributeNotify
			   event, or if	a new X	printer	connection was	estab-
			   lished  as  the  result  of the user	activating the
			   Printer Info	button.

       DtNminimizeButtons
		 If false, sets	the dimensions of all of the  buttons  at  the
		 bottom	 of  the  widget to the	width of the widest button and
		 the height of the tallest button. If true, the	dimensions  of
		 the buttons are not altered.

       DtNprintCallback
		 Specifies the list of callbacks that is called	when the Print
		 button	is activated. The callback reason is DtPRINT_CR_PRINT.
		 This callback is used to initiate the print job.

       DtNprintDestination
		 Indicates  where  the	print output should be directed. Valid
		 values	for this resource are:

		 DtPRINT_TO_FILE
			   Direct print	output to a file. The destination file
			   name	is indicated by	the DtNfileName	resource. Set-
			   ting	this value will	cause the Print	To File	check-
			   box	to  be	selected,  enable  the	File Name text
			   field, and enable the Select	File button.

		 DtPRINT_TO_PRINTER
			   Direct print	output to a printer.  The  destination
			   printer  is	indicated  by  the  DtNprinterName re-
			   source. Setting this	value will cause the Print  To
			   File	 checkbox  to  be deselected, disable the File
			   Name	text field, and	disable	the Select  File  but-
			   ton.

       DtNprinterInfoProc
		 This  resource	 specifies  the	procedure that will be used to
		 present printer information in	response to activation of  the
		 Printer Information button. The printer selection dialog pre-
		 sented	by the default	DtNselectPrinterProc  will  also  call
		 this  procedure  in response to activation of its Printer In-
		 formation button.

		 If  the  value	 of  the  DtNprintSetupMode  resource  is  Dt-
		 PRINT_SETUP_XP,  a  default procedure that presents a printer
		 information dialog is used. For other values  of  DtNprintSe-
		 tupMode, the default value of DtNprinterInfoProc is NULL.

		 Typically, this procedure does	not update DtPrintSetupBox re-
		 sources nor X Print Service attributes. The return  value  of
		 this  procedure is ignored by DtPrintSetupBox.	However, it is
		 recommended that the procedure	follow	the  conventions  pre-
		 sented	 in  the  "DtPrintSetupProc"  section to ensure	future
		 compatibility.

       DtNprinterName
		 The name of the printer to send the print job to.

		 If  the  value	 of  the  DtNprintSetupMode  resource  is  Dt-
		 PRINT_SETUP_XP, setting this resource will update the Printer
		 Name field based on the value of  the	XpPrinterNameMode  XRM
		 resource.  See	 the "EXTERNAL INFLUENCES" section in this man
		 page for more information. If the value of the	DtNprintSetup-
		 Mode  resource	 is DtPRINT_SETUP_PLAIN, setting this resource
		 will update the value of the Printer Name text	field with the
		 value of this resource.

       DtNprintSetupMode
		 Instructs the widget as to whether or not it is being used in
		 an application	that utilizes the X Print Service. If so, then
		 the  widget will manage the X printing	display	connection and
		 print context,	and provide defaults for a number of X	print-
		 ing operations, such as printer selection and information di-
		 alogs,	and printer verification. Refer	to individual resource
		 descriptions to determine if and how they are affected	by the
		 value of this resource. Valid values for this resource	are:

		 DtPRINT_SETUP_PLAIN
			   This	widget will be used  by	 an  application  that
			   performs  its  own print document format generation
			   and print job submission.

		 DtPRINT_SETUP_XP
			   This	widget will be used  by	 an  application  that
			   utilizes the	X Print	Service	to perform print docu-
			   ment	format generation and print job	submission.

       DtNselectFileProc
		 This resource specifies the procedure that will  be  used  in
		 response to activation	of the Select File button. The default
		 value for this	resource is a pointer  to  a  procedure	 which
		 will  invoke  an  XmFileSelectionBox  dialog to select	a file
		 name.

		 If the	user cancels the file selection	dialog,	no  DtPrintSe-
		 tupBox	components will	be updated. If the user	selects	a file
		 name, the file	name will be set as the	value for the DtNfile-
		 Name resource.	This procedure communicates the	newly selected
		 file name to DtPrintSetupBox by setting the  DtNfileName  re-
		 source.

		 Since the default procedure presents a	File Selection Dialog,
		 the resource is actually set after the	procedure returns, due
		 to  the asynchronous nature of	widgets	and callbacks. The re-
		 turn value of this procedure is ignored  by  DtPrintSetupBox.
		 However, it is	recommended that the procedure follow the con-
		 ventions presented in the "DtPrintSetupProc" section  to  en-
		 sure future compatibility.

       DtNselectPrinterProc
		 This  resource	 specifies  the	procedure that will be used in
		 response to activation	of the Select Printer button.  If  the
		 value	of the DtNprintSetupMode resource is DtPRINT_SETUP_XP,
		 a default procedure that invokes  a  DtPrinterSelectionDialog
		 is  used. If the user cancels the printer selection dialog no
		 DtPrintSetupBox components will be updated. If	the  user  se-
		 lects a printer, the printer will be set as the value for the
		 DtNprinterName	resource.

		 This procedure	communicates the newly selected	 printer  name
		 to  DtPrintSetupBox  by  setting the DtNprinterName resource.
		 Since the default procedure presents a	Printer	Selection Dia-
		 log,  the  resource  is  actually set after the procedure re-
		 turns,	due to the asynchronous	nature of  widgets  and	 call-
		 backs.

		 If  the  value	 of the	DtNprintSetupMode resource is anything
		 other than DtPRINT_SETUP_XP, the default value	of  DtNselect-
		 PrinterProc is	NULL.

		 The  return  value of this procedure is ignored by DtPrintSe-
		 tupBox. However, it is	recommended that the procedure	follow
		 the  conventions  presented in	the "DtPrintSetupProc" section
		 to ensure future compatibility.

       DtNsetAttributesCallback
		 Specifies the list of callbacks that is called	 whenever  Dt-
		 PrintSetupBox is about	to perform an operation	that will uti-
		 lize X	Print Service attributes. This callback	list will only
		 be  called  if	the value of the DtNprintSetupMode resource is
		 DtPRINT_SETUP_XP.

		 This callback is intended to be  used	by  applications  that
		 utilize  X  Print  Service attributes directly. This callback
		 provides these	applications with a chance to  set  attributes
		 whenever  a subsequent	DtPrintSetupBox	operation will utilize
		 the current set of attributes (for example, prior to  calling
		 the DtNprintCallback list).

		 The callback reason is	DtPRINT_CR_SET_ATTRIBUTES.

       DtNsetupProc
		 This  resource	 specifies  the	procedure that will be used in
		 response to activation	of the Setup button. If	the  value  of
		 the DtNprintSetupMode resource	is DtPRINT_SETUP_XP, a default
		 procedure is provided that will call XpNotifyPDM in order  to
		 present  the  setup  dialog provided by the Print Dialog Man-
		 ager.

		 If the	value of the DtNprintSetupMode	resource  is  anything
		 other	than  DtPRINT_SETUP_XP,	the default value of DtNsetup-
		 Proc is NULL.

		 This procedure	typically updates X Print Service  attributes,
		 and does not set any DtPrintSetupBox resources.

		 The  return  value of this procedure is ignored by DtPrintSe-
		 tupBox. However, it is	recommended that the procedure	follow
		 the  conventions  presented in	the "DtPrintSetupProc" section
		 to ensure future compatibility.

       DtNverifyPrinterProc
		 This resource specifies the procedure that will  be  used  to
		 verify	 the  current value of the DtNprinterName resource be-
		 fore any operation requiring a	valid printer is performed. If
		 the  current  value  of  the DtNprinterName resource is NULL,
		 this procedure	will set a default printer as the value	of the
		 DtNprinterName	resource.

		 If this procedure provides a default printer name, or a fully
		 qualified X printer name, it should communicate the new  name
		 to DtPrintSetupBox by setting the DtNprinterName resource be-
		 fore returning.

		 If  the  value	 of  the  DtNprintSetupMode  resource  is  Dt-
		 PRINT_SETUP_XP,  a default procedure will be set as the value
		 of the	DtNverifyPrinterProc resource. This default  procedure
		 will verify the X printer, and	establish a print display con-
		 nection and print context for the printer. The	procedure com-
		 municates  the	new print display and context to DtPrintSetup-
		 Box   by   updating   the    print_data->print_display	   and
		 print_data->print_context  elements of	the callback structure
		 prior to returning.

		 If the	value of the DtNprintSetupMode	resource  is  anything
		 other	than  DtPRINT_SETUP_XP,	 the default value of DtNveri-
		 fyPrinterProc is NULL.

		 If the	value of the DtNverifyPrinterProc  resource  is	 NULL,
		 the printer name is always considered valid.

		 If  this  procedure  determines  the printer name is valid or
		 sets a	valid printer name (and	X printer connection  informa-
		 tion),	 it should return DtPRINT_SUCCESS. If the printer name
		 is invalid or no valid	default	can be determined, this	proce-
		 dure should return DtPRINT_FAILURE.

       DtNworkAreaLocation
		 Indicates  how	 to position work area children	within the Dt-
		 PrintSetupBox.	Possible values	are:

		 DtWORK_AREA_BOTTOM
			   A single work area child may	be added, and will  be
			   placed  below  the  generic	controls and above the
			   pushbuttons at the bottom of	the window. A  managed
			   separator  will be placed between the work area and
			   the generic controls.  This is the default.

		 DtWORK_AREA_TOP
			   A single work area child may	be added, and will  be
			   placed above	the generic controls and below the top
			   of the window. A managed separator will  be	placed
			   between the work area and the generic controls.

		 DtWORK_AREA_TOP_AND_BOTTOM
			   Two work area children may be added.	The first work
			   area	created	will become the	top work  area,	 posi-
			   tioned with a separator as for DtWORK_AREA_TOP, and
			   the second will become the bottom work area,	 posi-
			   tioned with a separator as for DtWORK_AREA_BOTTOM.

		 The  effect  of adding	more work area children	than indicated
		 by the	value of DtNworkAreaLocation is	undefined.

   Inherited Resources
       DtPrintSetupBox inherits	resources from the XmBulletinBoard, XmManager,
       Constraint,  Composite,	and Core superclasses.	Refer to the reference
       pages for these superclasses for	inherited resources and	their descrip-
       tions.

   Callback And	Procedure Resource Information
       DtPrintSetupBox	defines	 a  new	 structure,  DtPrintSetupData, that is
       passed to callbacks and procedure resource values. For callbacks	 only,
       DtPrintSetupBox defines a new callback structure, DtPrintSetupCallback-
       Struct. Not all fields in these structures are valid for	all  callbacks
       and  procedures.	 For callbacks,	the application	must first look	at the
       reason field, and use only the structure	members	 that  are  valid  for
       that  particular	 reason.   For	each procedure,	the application	should
       only reference structure	members	that are defined  as  valid  for  that
       particular  procedure.  The  DtPrintSetupData and DtPrintSetupCallback-
       Struct structures are defined as	follows:

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

       printer_name
		 Contains the current value of the DtNprinterName resource.

       print_display
		 If DtNprintSetupMode is DtPRINT_SETUP_XP, print_display  con-
		 tains	a  pointer  to the Display structure for the current X
		 Printer. For other values of DtNprintSetupMode, this field is
		 NULL.

       print_context
		 If  DtNprintSetupMode is DtPRINT_SETUP_XP, print_context con-
		 tains the print context handle	for the	current	X Printer. For
		 other values of DtNprintSetupMode, this field is NULL.

       destination
		 Contains  the	current	 value	of the DtNprintDestination re-
		 source.

       dest_info Additional information	about the print	destination  as	 indi-
		 cated by the destination field.

		 If  destination  is  DtPRINT_TO_FILE, this field contains the
		 name of the file to print to.

		 If destination	is DtPRINT_TO_PRINTER, this field contains the
		 name  of  the currently selected printer as determined	by the
		 current value of the XpPrinterNameMode	resource. This is use-
		 ful  for display within dialogs displaying print status, etc.
		 because it is the printer name	as presented to	 the  user  in
		 DtPrintSetupBox.

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

       reason	 Indicates why the callback was	invoked.

       event	 Points	 to  the XEvent	that triggered the callback. It	can be
		 NULL.

       print_data
		 Points	to a DtPrintSetupData structure	containing  additional
		 callback information.

       The following table indicates for each callback reason which DtPrintSe-
       tupCallbackStruct and DtPrintSetupData members are valid.

       Reason				       Valid Fields
       DtPRINT_CR_CANCEL		       reason, event
       DtPRINT_CR_CLOSE_PRINT_DISPLAY	       reason,	       printer_name,
					       print_display, print_context
       DtPRINT_CR_GET_ATTRIBUTES	       reason,	event, printer_name,
					       print_display, print_context
       DtPRINT_CR_GET_STATIC_ATTRIBUTES	       reason, event,  printer_name,
					       print_display, print_context
       DtPRINT_CR_PRINT			       reason,	event, printer_name,
					       print_display, print_context,
					       destination, dest_info
       DtPRINT_CR_SET_ATTRIBUTES	       reason,	event, printer_name,
					       print_display, print_context

       The following table indicates for each  procedure  resource  which  Dt-
       PrintSetupData members are valid:

       Procedure	      Valid Fields
       DtNprinterInfoProc     printer_name,	    print_display,
			      print_context
       DtNselectFileProc      destination, dest_info
       DtNsetupProc	      printer_name,	    print_display,
			      print_context
       DtNverifyPrinterProc   printer_name,	    print_display,
			      print_context

   Translations
       DtPrintSetupBox inherits	translations from XmBulletinBoard.

   Virtual Bindings
       The bindings for	virtual	keys are implementation-dependent. For	infor-
       mation  about  bindings	for virtual buttons and	keys, see VirtualBind-
       ings(3).

EXTERNAL INFLUENCES
       This section specifies application resources and	environment  variables
       that  will  influence  the behavior of DtPrintSetupBox.	If a given re-
       source is defined, it will have precedence over the corresponding envi-
       ronment	variable.  There  is no	corresponding environment variable for
       the XpPrinterNameMode resource.

   XRM Application Resources
       XpPrinter This variable defines the default destination X Printer Spec-
		 ifier	for DtPrintSetupBox. If	the specifier is just a	print-
		 erName, the host:display portion of the specifier is obtained
		 by  checking  if the X	Server to which	the client application
		 is connected is an X Print Server managing printerName.  Oth-
		 erwise,  the first server in the XpServerList or XPSERVERLIST
		 that manages the printer will be used.	If the :display	number
		 is omitted, :0	is assumed.

		 Example:

       Dtmail*XpPrinter: laser_1@callisto:6

       XpPrinterNameMode
		 This  resource	 indicates how an X Printer Specifier shall be
		 shown in the Printer Name combo box text.  Valid  values  for
		 this resource are:

		 DtSHORT_NAME
			   Display  only  the  printerName  portion  of	 the X
			   Printer Specifier.

		 DtMEDIUM_NAME
			   Display the printer name as a  combination  of  the
			   printerName	and the	host portions of the X Printer
			   Specifier with an intervening "at" (@) symbol.  For
			   example:

		 printer@host

		 DtLONG_NAME
			   Display  the	 fully	qualified X Printer Specifier.
			   For example:

		 printer@host:6

		 If this resource is not specified, DtPrintSetupBox  will  as-
		 sume a	default	of DtSHORT_NAME.

       XpPrinterList
		 This resource defines the initial set of X Printer Specifiers
		 shown in the Printer Name combo box list.

		 The resource value is a  whitespace-delimited	list  of  par-
		 tially	or fully specified X Printer Specifiers. When the user
		 selects a specifier from this list, if	the specifier is  just
		 a  printerName,  the host:display portion of the specifier is
		 obtained by checking if the X Server to which the client  ap-
		 plication is connected	is an X	Print Server managing printer-
		 Name. Otherwise the  first  server  in	 the  XpServerList  or
		 XPSERVERLIST  that  manages the printer will be used. If the:
		 display number	is omitted, :0 is assumed.

		 Example:

       *xpPrinterList: laser laser2@argon:3 laser7@xenon

       XpServerList
		 This resource contains	a list of X Print  Server  specifiers.
		 Each  entry  in  the list is of the form host:display,	and is
		 separated from	other entries by  whitespace.  DtPrintSetupBox
		 uses  this list to fully qualify partial X Printer Specifiers
		 consisting of just the	printerName.

		 Example:

       *.XpServerList: hanz:6 franz:6 ahnold:6

   Environment Variables
       PDPRINTER, LPDEST, PRINTER
		 If the	XPRINTER, environment variable and the	XpPrinter  re-
		 source	 are not specified, DtPrintSetupBox will check the en-
		 vironment variables (in order)	PDPRINTER, LPDEST, and PRINTER
		 to  obtain'  a	 printerName that can be used to generate an X
		 Printer Specifier to use for the default X Printer  shown  in
		 the  Printer Name combo box text field. The host:display por-
		 tion of the specifier is obtained by checking if the X	Server
		 to  which  the	 client	application is connected is an X Print
		 Server	managing printerName. If not,  the  list  of  X	 Print
		 Servers  specified  in	 the  XpServerList  or XPSERVERLIST is
		 queried, until	the first X Printer with a  matching  printer-
		 Name is found.

       XPRINTER	 The specification of the XPRINTER environment variable	is the
		 same as the XpPrinter resource.

       XPRINTERLIST
		 The specification of the XPRINTERLIST environment variable is
		 the same as the the XpPrinterList resource.

       XPSERVERLIST
		 The specification of the XPSERVERLIST environment variable is
		 the same as the the XpServerList resource.

EXAMPLES
       Sample code can be found	in the /proj/cde/examples/dtprint directory.

SEE ALSO
       DtPrintSetupProc(3), DtCreatePrintSetupDialog(3),  DtPrintSetupProc(3),
       DtPrinterSelectionDialog(3)

						 DtPrintSetupBox(library call)

NAME | SYNOPSIS | DESCRIPTION | EXTERNAL INFLUENCES | EXAMPLES | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=DtPrintSetupBox&sektion=3&manpath=FreeBSD+12.0-RELEASE+and+Ports>

home | help