macro Animate_Open (commctrl.h)

Apre una clip AVI e visualizza il primo fotogramma in un controllo di animazione. È possibile utilizzare questa macro o inviare il messaggio di ACM_OPEN in modo esplicito.

Sintassi

BOOL Animate_Open(
   HWND   hwnd,
   LPTSTR szName
);

Parametri

hwnd

Tipo: HWND

Handle per il controllo animazione.

szName

Tipo: LPTSTR

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 nel LOWORD e zero nel HIWORD. Per creare questo valore, utilizzare la macro MAKEINTRESOURCE . Il controllo carica una 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. Il file o la risorsa AVI specificato da szName non deve contenere audio.

Se questo parametro è NULL, il sistema chiude il file AVI aperto in precedenza per il controllo di animazione specificato, se presente.

Valore restituito

Tipo: BOOL

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

Osservazioni

È possibile aprire solo clip AVI silenziose. ACM_OPEN e Animate_Open avranno esito negativo se szName 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.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows Vista [solo app desktop]
server minimo supportato	Windows Server 2003 [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	commctrl.h