Animate_OpenEx Makro (commctrl.h)

Öffnet einen AVI-Clip aus einer Ressource in einem angegebenen Modul und zeigt seinen ersten Frame in einem Animationssteuerelement an. Sie können dieses Makro verwenden oder die ACM_OPEN Nachricht explizit senden.

Syntax

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

Parameter

hwnd

Typ: HWND-

Ein Handle für das Animationssteuerelement.

hInst

Typ: HINSTANCE-

Ein Instanzhandle für das Modul, aus dem die Ressource geladen werden soll. Wenn dieser Wert NULL-ist, wird die Ressource aus dem Modul geladen, das das Animationssteuerelement erstellt hat.

szName

Typ: LPTSTR-

Ein Zeiger auf einen Puffer, der den Pfad der AVI-Datei oder den Namen einer AVI-Ressource enthält. Alternativ kann dieser Parameter aus dem AVI-Ressourcenbezeichner im LOWORD- und Null im HIWORD-bestehen. Verwenden Sie zum Erstellen dieses Werts das MAKEINTRESOURCE Makro. Das Steuerelement lädt die AVI-Ressource aus dem modul, das durch hInstangegeben wird. Die durch szName angegebene AVI-Datei oder Ressource darf keine Audiodaten enthalten.

Wenn dieser Parameter NULL-ist, schließt das System ggf. die AVI-Datei, die zuvor für das angegebene Animationssteuerelement geöffnet wurde.

Rückgabewert

Typ: BOOL-

Gibt "nonzero" zurück, wenn dies erfolgreich ist, oder 0 andernfalls null.

Bemerkungen

Sie können nur unbeaufsichtigte AVI-Clips öffnen. ACM_OPEN und Animate_Open schlagen fehl, wenn szName- einen AVI-Clip angibt, der Sound enthält.

Sie können Animate_Close verwenden, um eine AVI-Datei oder AVI-Ressource zu schließen, die zuvor für das angegebene Animationssteuerelement geöffnet wurde.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows Vista [nur Desktop-Apps]
mindestens unterstützte Server-	Windows Server 2003 [Nur Desktop-Apps]
Zielplattform-	Fenster
Header-	commctrl.h