Compartilhar via


Método IXpsOMObjectFactory1::CreatePage1 (xpsobjectmodel_1.h)

Cria uma interface IXpsOMPage , que fornece o nó raiz de uma árvore de objetos que representam o conteúdo de uma única página.

Sintaxe

HRESULT CreatePage1(
  const XPS_SIZE *pageDimensions,
  LPCWSTR        language,
  IOpcPartUri    *partUri,
  IXpsOMPage1    **page
);

Parâmetros

pageDimensions

A estrutura XPS_SIZE que especifica o tamanho da página a ser criada.

O tamanho é descrito em unidades XPS. Há 96 unidades XPS por polegada. Por exemplo, as dimensões de uma página de 8,5" por 11,0" são 816 por 1.056 unidades XPS.

language

A cadeia de caracteres que indica o idioma padrão da página criada.

[! ALERTA] Importante A cadeia de caracteres de idioma deve seguir a sintaxe RFC 3066.

partUri

A interface IOpcPartUri que contém o nome da parte a ser atribuída a esse recurso.

page

Um ponteiro para a nova interface IXpsOMPage .

Retornar valor

O método retorna um HRESULT. Os valores possíveis incluem, mas não se limitam, 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 pageDimensions, partUri ou page é NULL.
XPS_E_INVALID_LANGUAGE O idioma não contém uma cadeia de caracteres de idioma válida.
XPS_E_INVALID_PAGE_SIZE pageDimensions contém um tamanho de página inválido ou valores de tamanho de página inválidos.

Requisitos

Requisito Valor
Cabeçalho xpsobjectmodel_1.h

Confira também

IXpsOMObjectFactory1

A IETF (Internet Engineering Task Force) RFC 3066

Especificação de Papel XML

Especificação de Papel XML