20
December 15, 1997
Communication with the Print Dialog
20
Communication with the Print Dialog Manager
Release 6.4
X Version 11
4
Communication with the Print Dialog Manager
Print Dialog Managers (PDMs) provide users with a graphical interface to specify printer-specific and
spooler-specific information. This section describes the interaction between X Print Service and PDMs.
For each server wanting to use print dialog services, a Print Dialog Manager acquires ownership of a selec-
tion named PDM_MANAGER on the default root window (a different name can be used, as long as it is
known to both the client and the PDM). Print Dialog Managers should comply with the conventions for
"Manager Selections" described in section 2.8 of the Inter-Client Communication Conventions Manual
(ICCCM). A printing client establishes a print context, and then requests services of the Print Dialog Man-
ager by issuing conversion requests on this selection.
Print Dialog Managers should support conversion of the following targets on their manager selection:
The PDM_START Selection Target
The PDM_START target is parametized (ICCCM section 2.2), and the property named in the ConvertSelec-
tion
request contains the following list of information:
The PDM_START target has a side effect (ICCCM, section 2.6.3). The PDM interprets the parameters listed
above and provides a user interface dialog on behalf of the client in which the user can modify attributes on
the print-context on the print-display provided.
The PDM will use the video-display, video-window, and locale parameters to configure and manage its user
interface.
The selection reply is placed in the property provided, where type is ATOM, format is 32, and the data con-
sists of a single ATOM element:
ATOM
DATA RECEIVED
PDM_START
Request that a dialog be managed for a particular print context
PARAMETER
FORMAT
DESCRIPTION
video-display
"host:port[.screen]"
X display of video server
video-window
"0x12345678"
Window to act as parent of PDM dialog
print-display
"host:port[.screen]"
X display of print server
print-window
"0x12345678"
Window on print server for subsequent
communication
print-context
"0x12345678"
Context of print job
locale
"C"
Hint to PDM regarding the locale
ATOM
DESCRIPTION
PDM_START_OK
The PDM was started successfully
PDM_START_VXAUTH
The PDM was not authorized to connect to video-display