Condividi tramite


Metodo IXpsOMObjectFactory::CreateDocumentStructureResource (xpsobjectmodel.h)

Crea un'interfaccia IXpsOMDocumentStructureResource che consente di accedere al flusso di risorse della struttura del documento.

Sintassi

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

Parametri

[in] acquiredStream

Interfaccia IStream di sola lettura da associare a questa risorsa. Questo parametro non deve essere NULL.

Importante Trattare questo flusso come oggetto Single-Threaded Apartment (STA); non immetterlo nuovamente.
 

[in] partUri

Interfaccia IOpcPartUri contenente il nome della parte da assegnare a questa risorsa. Questo parametro non deve essere NULL.

[out, retval] documentStructureResource

Puntatore alla nuova interfaccia IXpsOMDocumentStructureResource .

Valore restituito

Il metodo restituisce un valore HRESULT. I valori possibili includono, ma non solo, quelli nella tabella che segue. Per informazioni sui valori restituiti dell'API documento XPS non elencati in questa tabella, vedere Errori del documento XPS.

Codice restituito Descrizione
S_OK
Il metodo è riuscito.
E_POINTER
acquiredStream, partUri o documentStructureResource è NULL.

Commenti

La parte DocumentStructure di un documento XPS contiene la struttura del documento, che, con le parti StoryFragments, definisce l'ordine di lettura di ogni elemento visualizzato nelle pagine fisse del documento. Questa interfaccia consente a un programma di leggere il contenuto XML della parte DocumentStructure e di sostituire anche il contenuto XML della parte DocumentStructure.

La parte DocumentStructure contiene il framework del documento e la struttura che descrive l'ordine di lettura complessivo del documento. L'ordine di lettura è organizzato in blocchi semantici denominati storie. Le storie sono unità logiche del documento nello stesso modo in cui gli articoli sono unità in una rivista. Le storie sono costituite da una o più parti StoryFragments.

Le parti StoryFragments contengono markup della struttura del contenuto che definisce i blocchi semantici della storia, ad esempio i paragrafi e le tabelle che costituiscono il contenuto della storia.

Il contenuto delle parti DocumentStructure e StoryFragments è descritto nella specifica xml paper.

Requisiti

   
Client minimo supportato Windows 7, Windows Vista con SP2 e Aggiornamento della piattaforma per Windows Vista [app desktop | App UWP]
Server minimo supportato Windows Server 2008 R2, Windows Server 2008 con SP2 e Platform Update per Windows Server 2008 [app desktop | App UWP]
Piattaforma di destinazione Windows
Intestazione xpsobjectmodel.h

Vedi anche

IOpcPartUri

IXpsOMDocumentStructureResource

IXpsOMObjectFactory

IXpsOMStoryFragmentsResource

XML Paper Specification

Errori del documento XPS