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

[Cette méthode n’est pas prise en charge dans Windows Vista ou les versions ultérieures.]

Spécifie un clip Audio-Video entrelacé (AVI) qui s’exécute dans la boîte de dialogue.

Syntaxe

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

Paramètres

[in, optional] hInstAnimation

Type : HINSTANCE

Un handle instance au module à partir duquel la ressource AVI doit être chargée.

idAnimation

Type : UINT

Identificateur de ressource AVI. Pour créer cette valeur, utilisez la macro MAKEINTRESOURCE . Le contrôle charge la ressource AVI à partir du module spécifié par hInstAnimation.

Valeur retournée

Type : HRESULT

Retourne S_OK en cas de réussite, ou une valeur d’erreur dans le cas contraire. Dans Windows Vista et les versions ultérieures, retourne toujours S_OK.

Remarques

IProgressDialog::SetAnimation ne peut pas être appelé avant que la boîte de dialogue de progression soit visible. Tant qu’elle n’est pas affichée, la boîte de dialogue de progression n’a pas de HWND valide. L’existence de ce HWND peut être utilisée pour déterminer si IProgressDialog::SetAnimation peut être appelé.

Cette méthode prend le handle de instance spécifié par hInstAnimation et utilise un contrôle d’animation pour ouvrir et exécuter un clip AVI silencieux. Il existe plusieurs restrictions quant aux types de clips AVI pouvant être utilisés, notamment les suivantes :

• Les clips ne peuvent pas inclure de son.
• La taille du clip AVI ne peut pas dépasser 272 x 60 pixels. Des rectangles plus petits peuvent être utilisés, mais ils peuvent ne pas être correctement centrés.
• Les clips AVI doivent être non compressés ou compressés avec un encodage de longueur d’exécution (BI_RLE8). Si vous essayez d’utiliser un type de compression non pris en charge, aucune animation n’est affichée.

Configuration requise

Voir aussi

IProgressDialog