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

Artigo
03/15/2023

Cria uma interface IXpsOMDocumentStructureResource , que fornece acesso ao fluxo de recursos da estrutura do documento.

Sintaxe

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

Parâmetros

[in] acquiredStream

A interface IStream somente leitura a ser associada a esse recurso. Esse parâmetro não deve ser NULL.

Importante Trate esse fluxo como um objeto STA (Single-Threaded Apartment) ; não insira novamente.

[in] partUri

A interface IOpcPartUri que contém o nome da parte a ser atribuída a esse recurso. Esse parâmetro não deve ser NULL.

[out, retval] documentStructureResource

Um ponteiro para a nova interface IXpsOMDocumentStructureResource .

Retornar valor

O método retorna um HRESULT. Os valores possíveis incluem, mas não se limitam a, aqueles na tabela a seguir. Para obter informações sobre valores retornados da API de documento XPS que não estão listados nesta tabela, consulte Erros de documento XPS.

Código de retorno	Descrição
S_OK	O método foi bem-sucedido.
E_POINTER	acquiredStream, partUri ou documentStructureResource é NULL.

Comentários

A parte DocumentStructure de um documento XPS contém a estrutura de tópicos do documento, que, com as partes StoryFragments, define a ordem de leitura de cada elemento que aparece nas páginas fixas do documento. Essa interface permite que um programa leia o conteúdo XML da parte DocumentStructure e também substitua o conteúdo XML da parte DocumentStructure.

A parte DocumentStructure contém a estrutura do documento e a estrutura de tópicos que descreve a ordem de leitura geral do documento. A ordem de leitura é organizada em blocos semânticos chamados histórias. Histórias são unidades lógicas do documento da mesma forma que artigos são unidades em uma revista. As histórias são compostas por uma ou mais partes de StoryFragments.

As partes StoryFragments contêm marcação de estrutura de conteúdo que define os blocos semânticos da história, como os parágrafos e tabelas que compõem o conteúdo da história.

O conteúdo das partes DocumentStructure e StoryFragments é descrito na Especificação de Papel XML.

Requisitos


Cliente mínimo com suporte	Windows 7, Windows Vista com SP2 e Atualização de Plataforma para Windows Vista [aplicativos da área de trabalho \| Aplicativos UWP]
Servidor mínimo com suporte	Windows Server 2008 R2, Windows Server 2008 com SP2 e Atualização de Plataforma para Windows Server 2008 [aplicativos da área de trabalho \| Aplicativos UWP]
Plataforma de Destino	Windows
Cabeçalho	xpsobjectmodel.h