Mensagem ACM_OPEN

Abre um clipe AVI e exibe seu primeiro quadro em um controle de animação. Você pode enviar essa mensagem explicitamente ou usar a macro Animate_Open ou Animate_OpenEx. Recomendamos usar a versão Unicode dessa mensagem, ACM_OPENW.

Parâmetros

wParam

Versão 4.71 e posterior. Um identificador de instância para o módulo a partir do qual o recurso deve ser carregado. Defina esse valor como NULO para que o controle use o valor HINSTANCE utilizado para criar a janela. Observe que, se a janela for criada por uma DLL, o valor padrão de wParam será o valor HINSTANCE da DLL, não do aplicativo que chama a DLL.

lParam

Um ponteiro para um buffer que contém o caminho do arquivo AVI ou o nome de um recurso AVI. Como alternativa, esse parâmetro pode consistir no identificador de recurso AVI em LOWORD e zero em HIWORD. Para criar esse valor, use a macro MAKEINTRESOURCE. O controle carrega o recurso AVI do módulo especificado pelo identificador de instância passado para a função CreateWindow, a macro Animate_Create ou a função de criação da caixa de diálogo que criou o controle. Na Versão 4.71 e posteriores, o recurso é carregado a partir do módulo especificado por wParam. Um recurso AVI deve ter o tipo "AVI". Se esse parâmetro for NULLO, o sistema fechará o arquivo AVI que foi aberto anteriormente para o controle de animação especificado, se houver.

Valor retornado

Retorna diferente de zero se tiver êxito; caso contrário, zero.

Comentários

O arquivo ou recurso AVI especificado por lpszName não deve conter áudio.

Recomendamos usar a versão Unicode dessa mensagem, ACM_OPENW.

Você só pode abrir clipes AVI silenciosos. ACM_OPEN e Animate_Open falham se lParam especificar um clipe AVI que contenha som.

Você pode usar Animate_Close para fechar um arquivo AVI ou um recurso AVI que tenha sido aberto anteriormente para o controle de animação especificado.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Cabeçalho	Commctrl.h
Nomes Unicode e ANSI	ACM_OPENW (Unicode) e ACM_OPENA (ANSI)