Método IXpsOMTileBrush::SetViewbox (xpsobjectmodel.h)

Define a parte do conteúdo de origem a ser usada como a imagem do bloco.

Sintaxe

HRESULT SetViewbox(
  [in] const XPS_RECT *viewbox
);

Parâmetros

[in] viewbox

Uma estrutura XPS_RECT que descreve a parte do conteúdo de origem a ser usada como a imagem do bloco.

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	A caixa de exibição é NULL.
E_INVALIDARG	O retângulo descrito na caixa de exibição não era válido.

Comentários

A caixa de exibição do pincel especifica a parte de uma imagem de origem ou visual a ser usada como a imagem do bloco.

As coordenadas da caixa de exibição do pincel são relativas ao conteúdo de origem, de modo que (0,0) especifica o canto superior esquerdo do conteúdo de origem. Para imagens, as dimensões especificadas pela caixa de exibição do pincel são expressas nas unidades de 1/96". As coordenadas de pixel correspondentes na imagem de origem são calculadas da seguinte maneira:

Na ilustração a seguir, a imagem à esquerda é um exemplo de uma imagem de origem, enquanto que à direita é a imagem de origem com a caixa de exibição selecionada para o pincel mostrado como um retângulo vermelho. Neste exemplo, a parte da imagem de origem usada como o conteúdo do pincel de bloco é a área dentro do retângulo vermelho. A área sombreada da imagem não é usada pelo pincel.

Se a resolução da imagem de origem for de 96 por 96 pontos por polegada e as dimensões de imagem forem de 96 por 96 pixels, os valores dos campos no parâmetro viewbox serão:

Os valores de parâmetro anteriores correspondem à imagem de origem como:

SourceLeft = 96 * 48 / 96 = 48 pixels do lado esquerdo

SourceTop = 96 * 24 / 96 = 24 pixels da parte superior

SourceWidth = 96 * 24 / 96 = 24 pixels de largura

SourceHeight = 96 * 48 / 96 = 48 pixels de altura

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

Confira também

IXpsOMTileBrush

Especificação de Papel XML

Erros de documento XPS

XPS_RECT