macro Animate_Open (commctrl.h)

Ouvre un clip AVI et affiche son premier cadre dans un contrôle d’animation. Vous pouvez utiliser cette macro ou envoyer explicitement le message ACM_OPEN.

Syntaxe

BOOL Animate_Open(
   HWND   hwnd,
   LPTSTR szName
);

Paramètres

hwnd

Type : HWND

Handle du contrôle d’animation.

szName

Type : LPTSTR

Pointeur vers une mémoire tampon qui contient le chemin du fichier AVI ou le nom d’une ressource AVI. Ce paramètre peut également se composer de l’identificateur de ressource AVI dans la LOWORD et zéro dans laHIWORD . Pour créer cette valeur, utilisez la macro MAKEINTRESOURCE. Le contrôle charge une ressource AVI à partir du module spécifié par le handle d’instance transmis à la fonction CreateWindow, à la macro Animate_Create ou à la fonction de création de boîte de dialogue qui a créé le contrôle. Le fichier ou la ressource AVI spécifié par szName ne doit pas contenir d’audio.

Si ce paramètre est NULL, le système ferme le fichier AVI précédemment ouvert pour le contrôle d’animation spécifié, le cas échéant.

Valeur de retour

Type : BOOL

Retourne une valeur différente de zéro si elle réussit ou zéro dans le cas contraire.

Remarques

Vous ne pouvez ouvrir que des clips AVI silencieux. ACM_OPEN et Animate_Open échoue si szName spécifie un clip AVI qui contient le son.

Vous pouvez utiliser Animate_Close pour fermer un fichier AVI ou une ressource AVI précédemment ouverte pour le contrôle d’animation spécifié.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows Vista [applications de bureau uniquement]
serveur minimum pris en charge	Windows Server 2003 [applications de bureau uniquement]
plateforme cible	Windows
d’en-tête	commctrl.h