Animate_OpenEx macro (commctrl.h)

Artigo
10/24/2024

Abre um clipe de AVI de um recurso em um módulo especificado 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_OpenEx(
   HWND      hwnd,
   HINSTANCE hInst,
   LPTSTR    szName
);

Parâmetros

hwnd

Tipo: HWND

Um identificador para o controle de animação.

hInst

Tipo: HINSTANCE

Um identificador de instância para o módulo do qual o recurso deve ser carregado. Se esse valor for NULL, o recurso será carregado do módulo que criou 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 o recurso AVI do módulo especificado por hInst. 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

Compartilhar via