Compartilhar via


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

Obtém a parte da imagem de origem a ser usada pelo bloco.

Sintaxe

HRESULT GetViewbox(
  [out, retval] XPS_RECT *viewbox
);

Parâmetros

[out, retval] viewbox

A estrutura XPS_RECT que descreve a área do conteúdo de origem a ser usada pelo bloco.

Retornar valor

Se o método for bem-sucedido, ele retornará S_OK; caso contrário, ele retornará um código de erro HRESULT .

Código de retorno Descrição
S_OK
O método foi bem-sucedido.
E_POINTER
viewbox é NULL.

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) especifique 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, a imagem no centro mostra a caixa de exibição selecionada e a imagem à direita mostra o pincel resultante.

Uma ilustração que mostra um exemplo de caixa de exibição 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 × 4 /96 = 24 pixels da parte superior
SourceWidth = 96 × 24 /96 = 24 pixels de largura
SourceHeight = 96 × 48 /96 = 48 pixels de altura

Requisitos

Requisito Valor
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 Platform Update 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

XPS_RECT