Animate_Open macro (commctrl.h)

Abre um clipe de AVI e exibe seu primeiro quadro em um controle de animação. Você pode usar essa macro ou enviar a mensagem ACM_OPEN explicitamente.

Sintaxe

BOOL Animate_Open(
   HWND   hwnd,
   LPTSTR szName
);

Parâmetros

hwnd

Tipo: HWND

Um identificador para o controle de animação.

szName

Tipo: LPTSTR

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 no loword e zero noHIWORD . Para criar esse valor, use a macro MAKEINTRESOURCE. O controle carrega um 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. O arquivo AVI ou recurso especificado por szName não deve conter áudio.

Se esse parâmetro for NULL, o sistema fechará o arquivo AVI que foi aberto anteriormente para o controle de animação especificado, se houver.

Valor de retorno

Tipo: BOOL

Retornará diferente de zero se tiver êxito ou zero de outra forma.

Observações

Você só pode abrir clipes AVI silenciosos. ACM_OPEN e Animate_Open falharão se szName especificar um clipe de AVI que contenha som.

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

Requisitos

Requisito Valor
de cliente com suporte mínimo Windows Vista [somente aplicativos da área de trabalho]
servidor com suporte mínimo Windows Server 2003 [somente aplicativos da área de trabalho]
da Plataforma de Destino Windows
cabeçalho commctrl.h