ACM_OPEN-Nachricht

Öffnet einen AVI-Clip und zeigt seinen ersten Frame in einem Animationssteuerelement an. Sie können diese Nachricht explizit senden oder das Makro Animate_Open oder Animate_OpenEx verwenden. Wir empfehlen die Verwendung der Unicode-Version dieser Nachricht, „ACM_OPENW“.

Parameter

wParam

Version 4.71 und höher. Ein Instanzhandle für das Modul, aus dem die Ressource geladen werden soll. Legen Sie diesen Wert auf NULL fest, damit das Steuerelement den HINSTANCE-Wert nutzt, der zum Erstellen des Fensters verwendet wurde. Beachten Sie, dass der Standardwert für wParam, wenn das Fenster von einer DLL erstellt wird, der HINSTANCE-Wert der DLL ist und nicht der Anwendung, die die DLL aufruft.

lParam

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 0 (null) im HIWORD bestehen. Verwenden Sie zum Erstellen dieses Werts das Makro MAKEINTRESOURCE. Das Steuerelement lädt die AVI-Ressource aus dem vom Instanzhandle angegebenen Modul, das an die CreateWindow-Funktion, das MakroAnimate_Create oder die Erstellungsfunktion des Dialogfelds übergeben wird, die das Steuerelement erstellt hat. In Version 4.71 und höher wird die Ressource aus dem von wParam angegebenen Modul geladen. Eine AVI-Ressource muss den Typ „AVI“ aufweisen. Wenn dieser Parameter NULL ist, schließt das System die AVI-Datei, die zuvor für das angegebene Animationssteuerelement geöffnet wurde, falls vorhanden.

Rückgabewert

Gibt ungleich 0 (null) zurück, wenn dies erfolgreich war, oder andernfalls 0 (null).

Hinweise

Die von lpszName angegebene AVI-Datei oder -Ressource darf keine Audiodaten enthalten.

Wir empfehlen die Verwendung der Unicode-Version dieser Nachricht, „ACM_OPENW“.

Sie können nur stille AVI-Clips öffnen. ACM_OPEN und Animate_Open schlagen fehl, wenn lParam 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
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Header	Commctrl.h
Unicode- und ANSI-Namen	ACM_OPENW (Unicode) und ACM_OPENA (ANSI)