Message ACM_OPEN

Ouvre un clip AVI et affiche sa première image dans un contrôle d’animation. Vous pouvez envoyer ce message explicitement, ou utiliser la macro Animate_Open ou Animate_OpenEx. Nous vous recommandons d’utiliser la version Unicode de ce message, ACM_OPENW.

Paramètres

wParam

Version 4.71 et ultérieures. Handle d’instance vers le module à partir duquel la ressource doit être chargée. Définissez cette valeur sur NULL pour que le contrôle utilise la valeur HINSTANCE utilisée pour créer la fenêtre. Notez que si la fenêtre est créée par une DLL, la valeur par défaut de wParam est la valeur HINSTANCE de la DLL, et non de l’application qui appelle la DLL.

lParam

Pointeur vers une mémoire tampon qui contient le chemin d’accès au 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 la 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. Dans la version 4.71 et ultérieures, la ressource est chargée à partir du module spécifié par wParam. Une ressource AVI doit être de type « AVI ». 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 retournée

Retourne une valeur différente de zéro en cas de réussite, ou zéro dans le cas contraire.

Notes

La ressource ou le fichier AVI spécifié par lpszName ne doit pas contenir d’audio.

Nous vous recommandons d’utiliser la version Unicode de ce message, ACM_OPENW.

Vous ne pouvez ouvrir que des clips AVI silencieux. ACM_OPEN et Animate_Open échouent si lParam 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é.

Spécifications

Condition requise	Value
Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
En-tête	Commctrl.h
Noms Unicode et ANSI	ACM_OPENW (Unicode) et ACM_OPENA (ANSI)