Class definition file: wpprint.idl
Class hierarchy SOMObject
WPObject
WPAbstract
WPPrinter
Description
This is the printer object class. An instance of this class can be created as a Workplace object. An instance of this class is created initially by the system in its template form. It has the title "Printer" and resides in the "Templates" folder. Instances of this class are also created initially by the system for each print configured. Each instance has a title corresponding to the description of the configured queue and printer and resides on the desktop.
Instance methods
The following list shows all the WPPrinter methods:
SOMObject instance methods
The following list shows all the instance methods overridden by the WPObject class. These instance methods are overridden in order to modify the behavior defined by an ancestor class.
WPObject instance methods
The following list shows all the methods overridden by the WPPrinter class. These methods are overridden in order to modify the behavior defined by an ancestor class.
wpSetup override by WPPrint
The following table shows the keyname-value pairs added by the WPPrint class.
ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÂÄÄÄÄÄÄÄÄÄÄÄÄÄÂÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿³KEYNAME ³VALUE ³DESCRIPTION ³ ÃÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ´ ³APPDEFAULT ³YES ³This printer object is to ³ ³ ³ ³become the application's ³ ³ ³ ³default printer object for ³ ³ ³ ³printing. ³ ÃÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ´ ³ ³NO ³This printer object is not ³ ³ ³ ³to become the application's³ ³ ³ ³default printer object for ³ ³ ³ ³printing. ³ ÃÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ´ ³DEFAULTVIEW ³DETAILS ³Default open view for this ³ ³ ³ ³printer object is in ³ ³ ³ ³details view. ³ ÃÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ´ ³ ³ICON ³Default open view for this ³ ³ ³ ³printer object is in icon ³ ³ ³ ³view. ³ ÃÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ´ ³JOBDIALOGBEFOREPRINT ³YES ³The job properties dialog ³ ³ ³ ³is displayed before ³ ³ ³ ³printing. ³ ÃÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ´ ³ ³NO ³The job properties dialog ³ ³ ³ ³is not displayed before ³ ³ ³ ³printing. ³ ÃÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ´ ³JOBPROPERTIES ³filename ³The complete path to a ³ ³ ³ ³binary file containing the ³ ³ ³ ³default job properties for ³ ³ ³ ³this printer object. This ³ ³ ³ ³file can be created by ³ ³ ³ ³saving the ³ ³ ³ ³PRQINFO3->pDriverData data ³ ³ ³ ³to a file; this data can be³ ³ ³ ³obtained by using the ³ ³ ³ ³SplQueryQueue API of the ³ ³ ³ ³spooler. ³ ³ ³ ³For more information about ³ ³ ³ ³spooler functions, see the ³ ³ ³ ³Presentation Manager ³ ³ ³ ³Programming Reference. ³ ÃÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ´ ³OUTPUTTOFILE ³YES ³The output of this printer ³ ³ ³ ³object goes to a file. The³ ³ ³ ³user will be prompted for a³ ³ ³ ³file name each time a print³ ³ ³ ³job is submitted to this ³ ³ ³ ³printer object. ³ ÃÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ´ ³ ³NO ³The output of this printer ³ ³ ³ ³object does not go to a ³ ³ ³ ³file. ³ ÃÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ´ ³PORTNAME ³portname ³The names of already ³ ³ ³ ³installed ports to which ³ ³ ³ ³this printer object is to ³ ³ ³ ³be attached. In the case ³ ³ ³ ³of more than one port, ³ ³ ³ ³specify a comma-separated ³ ³ ³ ³list. ³ ÃÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ´ ³PRINTDRIVER ³driver.device³The complete name of the ³ ³ ³ ³print-driver that this ³ ³ ³ ³printer object is to use. ³ ³ ³ ³For example: 'IBM42XX.IBM ³ ³ ³ ³420 Proprinter III' ³ ³ ³ ³In the case of more than ³ ³ ³ ³one print driver, specify a³ ³ ³ ³comma-separated list. ³ ³ ³ ³These printer drivers must ³ ³ ³ ³already be installed. ³ ÃÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ´ ³PRINTERSPECIFICFORMAT ³YES ³The printer object spools ³ ³ ³ ³print jobs in PM_Q_RAW ³ ³ ³ ³format. ³ ÃÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ´ ³ ³NO ³The printer object spools ³ ³ ³ ³print jobs in PM_Q_STANDARD³ ³ ³ ³format. ³ ÃÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ´ ³PRINTWHILESPOOLING ³YES ³The printing is enabled ³ ³ ³ ³while the job is spooling. ³ ÃÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ´ ³ ³NO ³The printing is disabled ³ ³ ³ ³while the job is spooling. ³ ÃÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ´ ³PRIORITY ³priority ³This sets the priority of ³ ³ ³number (0-9) ³the print queue associated ³ ³ ³ ³with the printer object. ³ ³ ³ ³All print jobs that are ³ ³ ³ ³submitted to the printer ³ ³ ³ ³object will inherit a job ³ ³ ³ ³priority derived from the ³ ³ ³ ³print queue's priority. ³ ³ ³ ³Zero is the highest ³ ³ ³ ³priority and 9 is the ³ ³ ³ ³lowest priority. ³ ÃÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ´ ³QSTARTTIME ³time ³The time when the printer ³ ³ ³ ³object starts printing. ³ ³ ³ ³The time format is HH:MM, ³ ³ ³ ³and the base is a 24-hour ³ ³ ³ ³clock. ³ ÃÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ´ ³QSTOPTIME ³time ³The time when the printer ³ ³ ³ ³object is to stop printing.³ ³ ³ ³The time format is HH:MM, ³ ³ ³ ³and the base is a 24-hour ³ ³ ³ ³clock. ³ ÃÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ´ ³QUEUENAME ³name ³The local queue name for ³ ³ ³ ³the printer object. If a ³ ³ ³ ³queue name is not ³ ³ ³ ³specified, one is created ³ ³ ³ ³by the printer object. ³ ³ ³ ³The QUEUENAME key will be ³ ³ ³ ³ignored if this object has ³ ³ ³ ³already been assigned a ³ ³ ³ ³queue. ³ ÃÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ´ ³QUEUEPARMS ³qparm ³This sets the queue ³ ³ ³ ³parameters, and can be any ³ ³ ³ ³text string. Queue ³ ³ ³ ³parameters are specific ³ ³ ³ ³instructions that are read ³ ³ ³ ³and used by OS/2 print ³ ³ ³ ³drivers, OS/2 queue ³ ³ ³ ³drivers, and the OS/2 ³ ³ ³ ³spooler. ³ ÃÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ´ ³QUEUEDRIVER ³qdrvname ³The queue driver name. The ³ ³ ³ ³queue driver must already ³ ³ ³ ³be installed. ³ ÃÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ´ ³SEPARATORFILE ³filename ³A separator file that ³ ³ ³ ³prints before each print ³ ³ ³ ³job. ³ ÃÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ´ ³SYNCJOBPROP ³YES ³This specifies that the ³ ³ ³ ³default job properties of ³ ³ ³ ³the printer object are to ³ ³ ³ ³be synchronized with the ³ ³ ³ ³network's printer job ³ ³ ³ ³properties. ³ ÃÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ´ ³ ³NO ³This specifies that the ³ ³ ³ ³default job properties will³ ³ ³ ³not be synchronized. ³ ÃÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ´ ³SYNCPRINTERPROP ³YES ³This specifies that the ³ ³ ³ ³printer properties of the ³ ³ ³ ³printer object are to be ³ ³ ³ ³synchronized with the ³ ³ ³ ³network's printer job ³ ³ ³ ³properties. ³ ÃÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ´ ³ ³NO ³This specifies that the ³ ³ ³ ³printer properties will not³ ³ ³ ³be synchronized. ³ ÃÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ´ ³TAKEDEFAULTS ³YES ³This specifies that the ³ ³ ³ ³printer object takes the ³ ³ ³ ³default values when it is ³ ³ ³ ³created. ³ ÃÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ´ ³ ³NO ³This specifies that the ³ ³ ³ ³printer object does not ³ ³ ³ ³take default values when it³ ³ ³ ³is created. This will ³ ³ ³ ³cause the "Create a ³ ³ ³ ³printer" dialog to be ³ ³ ³ ³displayed. ³ ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÁÄÄÄÄÄÄÄÄÄÄÄÄÄÁÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ
Class methods
There are currently no class methods defined for the WPPrinter Workplace class object.
WPObject class methods
The following list shows all the class methods overridden by the WPPrinter class. These methods are overridden to modify the behavior defined by an ancestor class.