CPrintInfo Structure
Stores information about a print or print-preview job.
struct CPrintInfo
Members
Public Methods
Name |
Description |
|---|---|
Returns the number of the first page being printed. |
|
Returns the number of the last page of the document. |
|
Returns the number of the first page of the document. |
|
Returns the number of the pages preceding the first page of a DocObject item being printed in a combined DocObject print job. |
|
Returns the number of the last page being printed. |
|
Sets the number of the last page of the document. |
|
Sets the number of the first page of the document. |
Public Data Members
Name |
Description |
|---|---|
Contains a flag indicating whether the framework should continue the print loop. |
|
Contains a flag indicating whether the document is being printed directly (without displaying the Print dialog box). |
|
Contains a flag indicating whether the document being printed is a DocObject. |
|
Contains a flag indicating whether the document is being previewed. |
|
Specifies DocObject printing operations. |
|
Contains a pointer to a user-created structure. |
|
Identifies the number of the page currently being printed. |
|
Specifies the job number assigned by the operating system for the current print job |
|
Identifies the number of pages displayed in the preview window; either 1 or 2. |
|
Specifies offset of a particular DocObject's first page in a combined DocObject print job. |
|
Contains a pointer to the CPrintDialog object used for the Print dialog box. |
|
Specifies a rectangle defining the current usable page area. |
|
Contains a format string for page-number display. |
Remarks
CPrintInfo is a structure and does not have a base class.
The framework creates an object of CPrintInfo each time the Print or Print Preview command is chosen and destroys it when the command is completed.
CPrintInfo contains information about both the print job as a whole, such as the range of pages to be printed, and the current status of the print job, such as the page currently being printed. Some information is stored in an associated CPrintDialog object; this object contains the values entered by the user in the Print dialog box.
A CPrintInfo object is passed between the framework and your view class during the printing process and is used to exchange information between the two. For example, the framework informs the view class which page of the document to print by assigning a value to the m_nCurPage member of CPrintInfo; the view class retrieves the value and performs the actual printing of the specified page.
Another example is the case in which the length of the document is not known until it is printed. In this situation, the view class tests for the end of the document each time a page is printed. When the end is reached, the view class sets the m_bContinuePrinting member of CPrintInfo to FALSE; this informs the framework to stop the print loop.
CPrintInfo is used by the member functions of CView listed under "See Also." For more information about the printing architecture provided by the Microsoft Foundation Class Library, see Frame Windows and Document/View Architecture and the articles Printing and Printing: Multipage Documents.
Inheritance Hierarchy
CPrintInfo
Requirements
Header: afxext.h