ACM_OPEN messaggio

Apre una clip AVI e visualizza il primo fotogramma in un controllo di animazione. È possibile inviare questo messaggio in modo esplicito o utilizzare la macro Animate_Open o Animate_OpenEx. È consigliabile usare la versione Unicode di questo messaggio, ACM_OPENW.

Parametri

wParam

Versione 4.71 e successive. Handle di istanza per il modulo da cui deve essere caricata la risorsa. Impostare questo valore su NULL per fare in modo che il controllo usi il valore HINSTANCE usato per creare la finestra. Si noti che se la finestra viene creata da una DLL, il valore predefinito per wParam è il valore HINSTANCE della DLL, non dell'applicazione che chiama la DLL.

lParam

Puntatore a un buffer contenente il percorso del file AVI o il nome di una risorsa AVI. In alternativa, questo parametro può essere costituito dall'identificatore di risorsa AVI in LOWORD e zero nell'HIWORD. Per creare questo valore, utilizzare la macro MAKEINTRESOURCE. Il controllo carica la risorsa AVI dal modulo specificato dall'handle di istanza passato alla funzione CreateWindow , alla macro Animate_Create o alla funzione di creazione della finestra di dialogo che ha creato il controllo. Nella versione 4.71 e successive la risorsa viene caricata dal modulo specificato da wParam. Una risorsa AVI deve avere il tipo "AVI". Se questo parametro è NULL, il sistema chiude il file AVI aperto in precedenza per il controllo di animazione specificato, se presente.

Valore restituito

Restituisce un valore diverso da zero se ha esito positivo o zero in caso contrario.

Osservazioni:

Il file AVI o la risorsa specificata da lpszName non deve contenere audio.

È consigliabile usare la versione Unicode di questo messaggio, ACM_OPENW.

È possibile aprire solo clip AVI silenziose. ACM_OPEN e Animate_Open hanno esito negativo se lParam specifica una clip AVI che contiene suoni.

Puoi usare Animate_Close per chiudere un file AVI o una risorsa AVI aperta in precedenza per il controllo di animazione specificato.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Intestazione	Commctrl.h
Nomi Unicode e ANSI	ACM_OPENW (Unicode) e ACM_OPENA (ANSI)