Método IDCompositionVisual::SetOffsetX(float) (dcomp.h)
Cambia el valor de la propiedad OffsetX de este objeto visual. La propiedad OffsetX especifica el nuevo desplazamiento del objeto visual a lo largo del eje X, en relación con el objeto visual primario.
Sintaxis
HRESULT SetOffsetX(
[in] float offsetX
);
Parámetros
[in] offsetX
Tipo: float
Nuevo desplazamiento del objeto visual a lo largo del eje X, 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 offsetX es NaN, infinito positivo o infinito negativo.
Al cambiar la propiedad OffsetX de un objeto visual, se transforma el sistema de coordenadas de todo el subárbol visual que se basa en ese 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 OffsetX. En otras palabras, el efecto de establecer la propiedad Transform y la propiedad OffsetX 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 OffsetX que offsetX. Sin embargo, debe usar IDCompositionVisual::SetOffsetX 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 OffsetX 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 |