commctrl.h


Animate_Open

La macro Animate_Open abre una animación AVI y muestra su primer cuadro en un control de animación. Se puede usar esta macro o enviar explícitamente el mensaje ACM_OPEN.

Definición

BOOL Animate_Open(
    hwnd, 	
    lpszName	
   );

Descripción

hwnd
Manipulador del control de animación.
lpszName
Puntero a un buffer que contiene el camino de un fichero .AVI o el nombre de un recurso AVI. Alternativamente, este parámetro puede ser un identificador de recurso AVI en la palabra de menor peso y cero en la palabra de mayor peso. Para crear este valor, usar la macro MAKEINTRESOURCE. El control carga un recurso AVI desde el módulo especificado por el manipulador de instancia pasado a la función CreateWindow, la macro Animate_Create, o la función de creación del cuadro de diálogo que haya creado el control.
El fichero o recurso AVI especificado por lpszName no debe contener audio. Debe ser silencioss.
Si este parámetro es NULL, el sistema cierra el fichero .AVI que fue previamente abierto para el control de animación especificado, si hay alguno.

Valores de retorno

Si la operación tiene éxito, el valor de retorno es distinto de cero.

Si la operación falla, el valor de retorno es cero.

Observaciones:

Sólo se pueden abrir animaciones AVI silenciosas. Los ficheros o recursos AVI que contengan audio no serán cargados. ACM_OPEN y Animate_Open fallarán su lpszSource especifica una animación AVI no silenciosa.

Se puede usar Animate_Close para cerrar un fichero o recurso AVI que fue previamente abierto para el control de animación especificado.

La macro Animate_Open está definida en COMMCTRL.H.