IPrintPreviewPageCollection::MakePage method

[アーティクル]
10/13/2013

Provides the system with a new page to present in print preview.

Syntax

HRESULT MakePage(
  [in]  UINT32 desiredJobPage,
  [in]  FLOAT width,
  [in]  FLOAT height
);

Parameters

desiredJobPage [in]
The page number.
width [in]
The width of the page.
height [in]
The height of the page.

Return value

If the MakePage method completes successfully, it returns an S_OK. Otherwise it returns an appropriate HRESULT error code.

Remarks

Apps should not assume that the system will cache all retrieved pages. For example, the system may ask for page 1 again without making a call to Paginate first. When the desiredJobPage is JOB_PAGE_APPLICATION_DEFINED the app may return the page to be presented as the next preview page. The page number provided in the next call to IPrintPreviewDxgiPackageTarget::MakePage will be used as the next page to show the user. When a specific page is requested this is the page that is being requested by the preview experience and the app should respond with this page. Page counts are 1-based and desiredJobPage is 1 when requesting the first page of the document.

Requirements

Minimum supported client	Windows 8 [desktop apps \| Windows Store apps]
Minimum supported server	Windows Server 2012 [desktop apps \| Windows Store apps]
IDL	DocumentSource.idl