Método IXpsOMTileBrush::SetViewbox (xpsobjectmodel.h)
Establece la parte del contenido de origen que se va a usar como imagen de icono.
Sintaxis
HRESULT SetViewbox(
[in] const XPS_RECT *viewbox
);
Parámetros
[in] viewbox
Estructura XPS_RECT que describe la parte del contenido de origen que se va a usar como imagen de icono.
Valor devuelto
El método devuelve un valor HRESULT. Entre los valores posibles se incluyen, entre otros, los de la tabla siguiente. Para obtener información sobre los valores devueltos de la API de documentos XPS que no aparecen en esta tabla, vea Errores del documento XPS.
| Código devuelto | Descripción |
|---|---|
|
El método se ha llevado a cabo de forma correcta. |
|
viewbox es NULL. |
|
El rectángulo descrito en viewbox no era válido. |
Comentarios
El cuadro de vista del pincel especifica la parte de una imagen de origen o un objeto visual que se va a usar como imagen de mosaico.
Las coordenadas del cuadro de vista del pincel son relativas al contenido de origen, de modo que (0,0) especifica la esquina superior izquierda del contenido de origen. Para las imágenes, las dimensiones especificadas por el cuadro de vista del pincel se expresan en las unidades de 1/96". Las coordenadas de píxeles correspondientes de la imagen de origen se calculan de la siguiente manera:
En la ilustración siguiente, la imagen de la izquierda es un ejemplo de una imagen de origen, mientras que en la derecha es la imagen de origen con el cuadro de vista seleccionado para el pincel que se muestra como un rectángulo rojo. En este ejemplo, la parte de la imagen de origen que se usa como contenido para el pincel de mosaico es el área dentro del rectángulo rojo. El pincel no usa el área sombreada de la imagen.
Si la resolución de la imagen de origen es de 96 por 96 puntos por pulgada y las dimensiones de imagen son de 96 por 96 píxeles, los valores de los campos del parámetro viewbox serían:Los valores de parámetro anteriores corresponden a la imagen de origen como:
- SourceLeft = 96 * 48 / 96 = 48 píxeles del lado izquierdo
- SourceTop = 96 * 24 / 96 = 24 píxeles desde la parte superior
- SourceWidth = 96 * 24 / 96 = 24 píxeles de ancho
- SourceHeight = 96 * 48 / 96 = 48 píxeles de alto
Requisitos
| Cliente mínimo compatible | Windows 7, Windows Vista con SP2 y Platform Update para Windows Vista [aplicaciones de escritorio | Aplicaciones para UWP] |
| Servidor mínimo compatible | Windows Server 2008 R2, Windows Server 2008 con SP2 y Actualización de plataforma para Windows Server 2008 [aplicaciones de escritorio | Aplicaciones para UWP] |
| Plataforma de destino | Windows |
| Encabezado | xpsobjectmodel.h |