Método IXpsOMTileBrush::GetViewbox (xpsobjectmodel.h)
Obtiene la parte de la imagen de origen que va a usar el icono.
Sintaxis
HRESULT GetViewbox(
[out, retval] XPS_RECT *viewbox
);
Parámetros
[out, retval] viewbox
Estructura XPS_RECT que describe el área del contenido de origen que va a usar el icono.
Valor devuelto
Si el método se realiza correctamente, devuelve S_OK; de lo contrario, devuelve un código de error HRESULT .
| Código devuelto | Descripción |
|---|---|
|
El método se ha llevado a cabo de forma correcta. |
|
viewbox es NULL. |
Comentarios
El cuadro de vista del pincel especifica la parte de una imagen de origen o un objeto visual que se usará como imagen de icono.
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. En el caso de 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íxel 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, la imagen del centro muestra el cuadro de vista seleccionado y la imagen de la derecha muestra el pincel resultante.
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 desde el lado izquierdo
- SourceTop = 96 × 4 / 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
| Requisito | Value |
|---|---|
| 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 |