Método IDCompositionVisual::SetTransformParent (dcomp.h)

Establece la propiedad TransformParent de este objeto visual. La propiedad TransformParent establece el sistema de coordenadas en relación con el que se compone este objeto visual.

Sintaxis

HRESULT SetTransformParent(
  [in, optional] IDCompositionVisual *visual
);

Parámetros

[in, optional] visual

Tipo: IDCompositionVisual*

Nuevo objeto visual que establece el sistema de coordenadas base para este objeto visual. 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

Las propiedades OffsetX, OffsetY y Transform modifican el sistema de coordenadas de un objeto visual. Normalmente, estas propiedades definen el sistema de coordenadas de un objeto visual con respecto a su elemento primario inmediato. Este método especifica el objeto visual en relación con el que se basa el sistema de coordenadas de este objeto visual. El objeto visual especificado debe ser un antecesor del objeto visual actual. Si no es un antecesor, el sistema de coordenadas se basa en el elemento primario inmediato de este objeto visual, como si la propiedad TransformParent estuviera establecida en NULL. Dado que los objetos visuales se pueden reparentar, esta propiedad puede volver a surtir efecto si el objeto visual especificado se convierte en un antecesor del objeto visual de destino mediante una operación de reparente.

Si el parámetro visual es NULL, el sistema de coordenadas siempre se transforma en relación con el elemento primario inmediato del objeto visual. Este es el comportamiento predeterminado si no se usa este método.

Este método produce un error si el parámetro visual es un puntero no válido o si no lo creó la misma interfaz IDCompositionDevice que 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.

Requisitos

Consulte también

IDCompositionVisual