macro Animate_OpenEx (commctrl.h)

Abre un clip avi de un recurso en un módulo especificado y muestra su primer fotograma en un control de animación. Puede usar esta macro o enviar el mensaje ACM_OPEN explícitamente.

Sintaxis

BOOL Animate_OpenEx(
   HWND      hwnd,
   HINSTANCE hInst,
   LPTSTR    szName
);

Parámetros

hwnd

Tipo: HWND

Identificador del control de animación.

hInst

Tipo: HINSTANCE

Identificador de instancia del módulo desde el que se debe cargar el recurso. Si este valor es NULL, el recurso se carga desde el módulo que creó el control de animación.

szName

Tipo: LPTSTR de

Puntero a un búfer que contiene la ruta de acceso del archivo AVI o el nombre de un recurso AVI. Como alternativa, este parámetro puede constar del identificador de recurso AVI en el LOWORD de y cero en la HIWORD. Para crear este valor, use la macro MAKEINTRESOURCE. El control carga el recurso AVI desde el módulo especificado por hInst. El archivo o recurso AVI especificado por szName no debe contener audio.

Si este parámetro es NULL, el sistema cierra el archivo AVI que se abrió anteriormente para el control de animación especificado, si existe.

Valor devuelto

Tipo: BOOL de

Devuelve un valor distinto de cero si se ejecuta correctamente o cero de lo contrario.

Observaciones

Solo puedes abrir clips AVI silenciosos. ACM_OPEN y Animate_Open producirán un error si szName especifica un clip AVI que contiene sonido.

Puede usar Animate_Close para cerrar un archivo AVI o un recurso AVI que se abrió anteriormente para el control de animación especificado.

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows Vista [solo aplicaciones de escritorio]
servidor mínimo admitido	Windows Server 2003 [solo aplicaciones de escritorio]
de la plataforma de destino de	Windows
encabezado de	commctrl.h