Método IDCompositionAnimation::End (dcompanimation.h)

  • Artículo

Agrega un segmento final que marca el final de una función de animación.

Sintaxis

HRESULT End(
  [in] double endOffset,
  [in] float  endValue
);

Parámetros

[in] endOffset

Tipo: double

Desplazamiento, en segundos, desde el principio de la función de animación hasta el punto en el que finaliza la función.

[in] endValue

Tipo: float

Valor final de la animación.

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

Cuando se alcanza el desplazamiento especificado, la propiedad o las propiedades afectadas por esta animación se establecen en el valor final especificado y, a continuación, la animación se detiene. Si no se agrega ningún segmento final, el segmento final de la función de animación se ejecuta indefinidamente. Llamar a este método es semánticamente idéntico a convertir el último segmento de la función de animación en un polinomio cúbico donde los coeficientes cúbicos, cuadráticos y lineales son todos ceros, y el coeficiente constante es el valor final deseado.

Dado que los segmentos de animación se deben agregar en orden creciente, este método produce un error si el parámetro endOffset es menor o igual que el parámetro beginOffset del segmento anterior. Este método también produce un error si este es el primer segmento que se va a agregar a la función de animación.

Después de llamar a este método, se produce un error en todos los métodos de este objeto de animación excepto el método IDCompositionAnimation::Reset .

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 dcompanimation.h
Library Dcomp.lib
Archivo DLL Dcomp.dll

Consulte también

IDCompositionAnimation