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 |
|---|---|
|
O método foi bem-sucedido. |
|
A caixa de exibição é NULL. |
|
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 |