Animate_Open Makro (commctrl.h)

Öffnet einen AVI-Clip 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_Open(
   HWND   hwnd,
   LPTSTR szName
);

Parameter

hwnd

Typ: HWND-

Ein Handle für das Animationssteuerelement.

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 eine AVI-Ressource aus dem vom Instanzhandle angegebenen Modul, das an die CreateWindow--Funktion, das Animate_Create-Makro oder die Erstellungsfunktion des Dialogfelds übergeben wird, die das Steuerelement erstellt hat. 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