Método IProgressDialog::SetAnimation (shlobj_core.h)

[Este método no se admite en Windows Vista ni en versiones posteriores.]

Especifica un clip de Audio-Video intercalado (AVI) que se ejecuta en el cuadro de diálogo.

Sintaxis

HRESULT SetAnimation(
  [in, optional] HINSTANCE hInstAnimation,
                 UINT      idAnimation
);

Parámetros

[in, optional] hInstAnimation

Tipo: HINSTANCE

Identificador de instancia del módulo desde el que se debe cargar el recurso AVI.

idAnimation

Tipo: UINT

Un identificador de recurso AVI. Para crear este valor, use la macro MAKEINTRESOURCE . El control carga el recurso AVI desde el módulo especificado por hInstAnimation.

Valor devuelto

Tipo: HRESULT

Devuelve S_OK si se ejecuta correctamente o un valor de error de lo contrario. En Windows Vista y versiones posteriores, siempre devuelve S_OK.

Comentarios

No se puede llamar a IProgressDialog::SetAnimation antes de que el cuadro de diálogo de progreso esté visible. Hasta que se muestre, el cuadro de diálogo de progreso no tiene un HWND válido. La existencia de ese HWND se puede usar para determinar si se puede llamar a IProgressDialog::SetAnimation .

Este método toma el identificador de instancia especificado por hInstAnimation y usa un control de animación para abrir y ejecutar un clip AVI silencioso. Hay varias restricciones en cuanto a los tipos de clips AVI que se pueden usar, incluidos los siguientes:

• Los clips no pueden incluir sonido.
• El tamaño del clip AVI no puede superar los 272 en 60 píxeles. Se pueden usar rectángulos más pequeños, pero es posible que no estén centrados correctamente.
• Los clips AVI deben estar sin comprimir o comprimirse con codificación de longitud de ejecución (BI_RLE8). Si intenta usar un tipo de compresión no admitido, no se muestra ninguna animación.

Requisitos

Consulte también

IProgressDialog