Animate_Open macro (commctrl.h)

Ouvre un clip AVI et affiche sa première image dans un contrôle d’animation. Vous pouvez utiliser cette macro ou envoyer le message ACM_OPEN explicitement.

Syntaxe

void Animate_Open(
   hwnd,
   szName
);

Paramètres

hwnd

Type : HWND

Handle pour le 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 loWORD et de zéro dans HIWORD. Pour créer cette valeur, utilisez la macro MAKEINTRESOURCE . Le contrôle charge une ressource AVI à partir du module spécifié par le handle de instance passé à 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 AVI ou la ressource spécifié par lpszName ne doit pas contenir d’audio.

Si ce paramètre a la valeur 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

None

Remarques

Vous pouvez uniquement ouvrir des clips AVI silencieux. ACM_OPEN et Animate_Open échouent si lpszName spécifie un clip AVI qui contient du son.

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

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	commctrl.h