Método IDCompositionVisual::SetClip(constD2D_RECT_F&) (dcomp.h)
Establece la propiedad Clip de este objeto visual en el rectángulo especificado. La propiedad Clip restringe la representación del subárbol visual que se basa en este objeto visual en la región rectangular especificada.
Sintaxis
HRESULT SetClip(
[in, ref] const D2D_RECT_F & rect
);
Parámetros
[in, ref] rect
Tipo: const D2D_RECT_F
Rectángulo que se va a usar para recortar este objeto visual. Todas las propiedades del parámetro rect tienen un límite numérico de -2^21 a 2^21. La API acepta números fuera de este intervalo, pero siempre están fijados a este intervalo.
Valor devuelto
Tipo: HRESULT
Si la función se ejecuta correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT. Consulte Códigos de error de DirectComposition para obtener una lista de códigos de error.
Comentarios
Al establecer la propiedad Clip, este objeto visual se recorta junto con todos los objetos visuales del subárbol que se basa en este objeto visual. El clip se transforma mediante las propiedades OffsetX, OffsetY y Transform.
Si la propiedad Clip especificó previamente un objeto clip, el rectángulo de clip recién especificado reemplaza al objeto clip.
Este método produce un error si los miembros de la estructura de rect son NaN, infinito positivo o infinito negativo.
Si el rectángulo del clip está vacío, el objeto visual se recorta completamente; es decir, el objeto visual se incluye en el árbol visual, pero no representa nada. Para excluir un objeto visual determinado de una composición, quite el objeto visual del árbol visual en lugar de establecer un rectángulo de clip vacío. Quitar el objeto visual da como resultado un mejor rendimiento.
Requisitos
| Cliente mínimo compatible | Windows 8 [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2012 [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | dcomp.h |
| Library | Dcomp.lib |
| Archivo DLL | Dcomp.dll |