PMSetAdjustedPageRect
Requests a particular page size, adjusted for the current rotation, resolution, or scaling settings.
Declaration
OSStatus PMSetAdjustedPageRect (
PMPageFormat pageFormat,
const PMRect *pageRect
);Parameters
- pageFormat:
The page format object whose page rectangle you want to set.
- pageRect:
A pointer to your Pmrect data structure that specifies the desired size of the page rectangle, in points. The top-left coordinates should be (0,0). See Supporting Printing in Your Carbon Application for more information on page and paper rectangles.
Return Value
A result code. See Result Codes.
Overview
This function is not recommended. You should call this function only if your application provides desktop publishing and the Page Setup dialog does not provide sufficient control. Typically, such applications display their own specialized document format dialog.
If you decide to use this function, you must call the function between the creation and release of a printing session. See the function PMCreateSession. You can use PMSetAdjustedPageRect to set a drawing rectangle without going through the Page Setup dialog or calling other page format accessor functions. This function allows an application to specify the dimensions of the imageable area into which it draws.
If you call this function after initiating a print job, the change is ignored for the current job.