Método IDCompositionVisual3::SetTransform(IDCompositionTransform3D*) (dcomp.h)
Establece la propiedad Transform de este objeto visual en el objeto de transformación 3D especificado.
Sintaxis
HRESULT SetTransform(
[in, optional] IDCompositionTransform3D *transform
);
Parámetros
[in, optional] transform
Tipo: IDCompositionTransform3D*
Objeto de transformación que se usa para modificar el sistema de coordenadas de este objeto visual. Este parámetro puede apuntar a una interfaz IDCompositionTransform o a una de sus interfaces derivadas. Este parámetro puede ser NULL.
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
Al establecer la propiedad Transform, 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.
Si la propiedad Transform especificó previamente una matriz de transformación, el objeto de transformación recién especificado reemplaza la matriz de transformación.
Una transformación especificada por la propiedad Transform se aplica después de las propiedades OffsetX y OffsetY. En otras palabras, el efecto de establecer la propiedad Transform y las propiedades OffsetX y OffsetY es el mismo que establecer solo la propiedad Transform en un grupo de transformación donde el primer miembro del grupo es un objeto IDCompositionTranslateTransform que tiene esos mismos valores OffsetX y OffsetY. Sin embargo, debe usar los métodos IDCompositionVisual::SetOffsetX y SetOffsetY siempre que sea posible porque son ligeramente más rápidos.
Este método produce un error si la transformación es un puntero no válido o si no lo creó la misma interfaz IDCompositionDevice que creó este objeto visual. La interfaz no puede ser una implementación personalizada; solo se pueden usar interfaces creadas por Microsoft DirectComposition con este método.
Si el parámetro de transformación es NULL, el sistema de coordenadas de este objeto visual solo se transforma mediante sus propiedades OffsetX y OffsetY. Establecer la propiedad Transform en NULL equivale a establecerla en un objeto IDCompositionMatrixTransform donde la matriz especificada es la matriz de identidad. Sin embargo, una aplicación debe establecer la propiedad Transform en NULL siempre que sea posible porque es ligeramente más rápida.
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.
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 |
Consulte también
IDCompositionTranslateTransform