IXpsOMPageReference::CollectPartResources method (xpsobjectmodel.h)

Creates a list of all part-based resources that are associated with the page.

Syntax

HRESULT CollectPartResources(
  [out, retval] IXpsOMPartResources **partResources
);

Parameters

[out, retval] partResources

A pointer to the IXpsOMPartResources interface that contains the list of all part-based resources that are associated with the page.

Return value

The method returns an HRESULT. Possible values include, but are not limited to, those in the table that follows. For information about XPS document API return values that are not listed in this table, see XPS Document Errors.

This method calls the Packaging API. For information about the Packaging API return values, see Packaging Errors.

Remarks

If the page is not loaded when this method is called, this method finds the part-based resources that are associated with this page by parsing the relationships part of the page and returns them in the partResources parameter. If the page is loaded, this method traverses the page's object model to find the part-based resources and returns them in partResources.

The list of resource parts that are returned in the IXpsOMPartResources interface is a snapshot of the document structure that is taken when the method is called. Changes made to the document after this call are not reflected in the IXpsOMPartResources interface after it is returned by this method. Likewise, changes made to the IXpsOMPartResources interface that is returned by this method will not be reflected in the document contents.

Requirements

See also

IXpsOMPageReference

IXpsOMPartResources

Packaging Errors

XML Paper Specification

XPS Document Errors