macro Animate_OpenEx (commctrl.h)

Article
08/22/2023

Ouvre un clip AVI à partir d’une ressource dans un module spécifié 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_OpenEx(
   hwnd,
   hInst,
   szName
);

Paramètres

hwnd

Type : HWND

Handle pour le contrôle d’animation.

hInst

Type : HINSTANCE

Un handle instance au 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 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 hinst. 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

Partager via