macro Animate_OpenEx (commctrl.h)

Article
10/24/2024

Ouvre un clip AVI à partir d’une ressource dans un module spécifié et affiche son premier frame dans un contrôle d’animation. Vous pouvez utiliser cette macro ou envoyer explicitement le message ACM_OPEN.

Syntaxe

BOOL Animate_OpenEx(
   HWND      hwnd,
   HINSTANCE hInst,
   LPTSTR    szName
);

Paramètres

hwnd

Type : HWND

Handle du contrôle d’animation.

hInst

Type : HINSTANCE

Handle d’instance vers le module à partir duquel la ressource doit être chargée. Si cette valeur est NULL, la ressource est chargée à partir du module qui a créé 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 la LOWORD et zéro dans laHIWORD . Pour créer cette valeur, utilisez la macro MAKEINTRESOURCE. Le contrôle charge la ressource AVI à partir du module spécifié par hInst . 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

Partager via