Méthode IXpsOMObjectFactory ::CreateDocumentStructureResource (xpsobjectmodel.h)

Article
12/22/2023

Crée une interface IXpsOMDocumentStructureResource , qui fournit l’accès au flux de ressources de structure de document.

Syntaxe

HRESULT CreateDocumentStructureResource(
  [in]          IStream                         *acquiredStream,
  [in]          IOpcPartUri                     *partUri,
  [out, retval] IXpsOMDocumentStructureResource **documentStructureResource
);

Paramètres

[in] acquiredStream

Interface IStream en lecture seule à associer à cette ressource. Ce paramètre ne doit pas être NULL.

Important Traitez ce flux comme un objet sta (Single-Threaded Apartment) ; ne l’entrez pas de nouveau.

[in] partUri

Interface IOpcPartUri qui contient le nom de composant à affecter à cette ressource. Ce paramètre ne doit pas être NULL.

[out, retval] documentStructureResource

Pointeur vers la nouvelle interface IXpsOMDocumentStructureResource .

Valeur retournée

Cette méthode retourne un code HRESULT. Les valeurs possibles incluent, sans s’y limiter, celles du tableau qui suit. Pour plus d’informations sur les valeurs de retour de l’API de document XPS qui ne sont pas répertoriées dans ce tableau, consultez Erreurs de document XPS.

Code de retour	Description
S_OK	S_OK
E_POINTER	acquiredStream, partUri ou documentStructureResource a la valeurNULL.

Remarques

La partie DocumentStructure d’un document XPS contient le plan du document, qui, avec les composants StoryFragments, définit l’ordre de lecture de chaque élément qui apparaît dans les pages fixes du document. Cette interface permet à un programme de lire le contenu XML du composant DocumentStructure et également de remplacer le contenu XML du composant DocumentStructure.

Le composant DocumentStructure contient l’infrastructure du document et le plan qui décrit l’ordre de lecture global du document. L’ordre de lecture est organisé en blocs sémantiques appelés récits. Les articles sont des unités logiques du document de la même façon que les articles sont des unités dans un magazine. Les histoires sont constituées d’une ou plusieurs parties StoryFragments.

Les parties StoryFragments contiennent un balisage de structure de contenu qui définit les blocs sémantiques de l’article, tels que les paragraphes et les tableaux qui composent le contenu de l’article.

Le contenu des composants DocumentStructure et StoryFragments est décrit dans la spécification de papier XML.

Configuration requise


Client minimal pris en charge	Windows 7, Windows Vista avec SP2 et Mise à jour de plateforme pour Windows Vista [applications de bureau \| Applications UWP]
Serveur minimal pris en charge	Windows Server 2008 R2, Windows Server 2008 avec SP2 et Platform Update pour Windows Server 2008 [applications de bureau \| Applications UWP]
Plateforme cible	Windows
En-tête	xpsobjectmodel.h