Método IDCompositionVisual::SetOffsetY(float) (dcomp.h)
Cambia el valor de la propiedad OffsetY de este objeto visual. La propiedad OffsetY especifica el nuevo desplazamiento del objeto visual a lo largo del eje y, en relación con el objeto visual primario.
Sintaxis
HRESULT SetOffsetY(
[in] float offsetY
);
Parámetros
[in] offsetY
Tipo: float
Nuevo desplazamiento del objeto visual a lo largo del eje Y, en píxeles.
Valor devuelto
Tipo: HRESULT
Si la función se realiza 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
Este método produce un error si el parámetro offsetY es NaN, infinito positivo o infinito negativo.
Al cambiar la propiedad OffsetY, se transforma el sistema de coordenadas de todo el subárbol visual que se basa en este objeto visual. Si se especifica la propiedad Clip de este objeto visual, también se transforma el rectángulo de recorte.
Una transformación especificada por la propiedad Transform se aplica después de la propiedad OffsetY. En otras palabras, el efecto de establecer la propiedad Transform y la propiedad OffsetY es el mismo que establecer solo la propiedad Transform en un objeto de grupo de transformación donde el primer miembro del grupo es un objeto IDCompositionTranslateTransform que tiene el mismo valor OffsetY que offsetY. Sin embargo, debe usar IDCompositionVisual::SetOffsetY siempre que sea posible porque es ligeramente más rápido.
Si las propiedades OffsetX y OffsetY se establecen en 0 y la propiedad Transform se establece en NULL, el sistema de coordenadas del objeto visual es el mismo que el de su elemento primario.
Si la propiedad OffsetY se ha animado anteriormente, este método quita la animación y establece la propiedad en el valor estático especificado.
Ejemplos
Para obtener un ejemplo, vea How to Build a Simple Visual Tree.
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 |