IXpsOMPageReference::SetPage method
Sets the IXpsOMPage interface of the page reference.
Syntax
HRESULT SetPage(
[in] IXpsOMPage *page
);
Parameters
- page [in]
The IXpsOMPage interface pointer of the page.
Return value
If the method succeeds, it returns S_OK; otherwise, it returns an HRESULT error code.
| Return code | Description |
|---|---|
| S_OK | The method succeeded. |
| E_POINTER | page is NULL. |
| XPS_E_NO_CUSTOM_OBJECTS | page does not point to a recognized interface implementation. Custom implementation of XPS Document API interfaces is not supported. |
Remarks
The page added by this method can be empty or fully constructed.
If the incoming page has references to remote dictionary objects, those objects will not be imported into the document object by this call. They must be added in a separate call to the IXpsOMPage::SetDictionaryResource or IXpsOMCanvas::SetDictionaryResource method.
If a page has been set, the calling method must first release that page before calling SetPage with a new page. To explain, once SetPage has been called with a new page, the original page cannot be discarded even if it still exists in the package.
Requirements
Minimum supported client |
Windows 7, Windows Vista with SP2 and Platform Update for Windows Vista [desktop apps | Windows Store apps] |
Minimum supported server |
Windows Server 2008 R2, Windows Server 2008 with SP2 and Platform Update for Windows Server 2008 [desktop apps | Windows Store apps] |
Header |
Xpsobjectmodel.h |
IDL |
XpsObjectModel.idl |