Share via

Método IProgressDialog::SetAnimation (shlobj_core.h)

  • Artigo

[Não há suporte para esse método no Windows Vista ou versões posteriores.]

Especifica um clipe do AVI (Intercalado Audio-Video) que é executado na caixa de diálogo.

Sintaxe

HRESULT SetAnimation(
  [in, optional] HINSTANCE hInstAnimation,
                 UINT      idAnimation
);

Parâmetros

[in, optional] hInstAnimation

Tipo: HINSTANCE

Um identificador de instância para o módulo do qual o recurso AVI deve ser carregado.

idAnimation

Tipo: UINT

Um identificador de recurso AVI. Para criar esse valor, use a macro MAKEINTRESOURCE . O controle carrega o recurso AVI do módulo especificado por hInstAnimation.

Valor retornado

Tipo: HRESULT

Retorna S_OK se tiver êxito ou um valor de erro, caso contrário. No Windows Vista e versões posteriores, sempre retorna S_OK.

Comentários

IProgressDialog::SetAnimation não pode ser chamado antes que a caixa de diálogo de progresso fique visível. Até que seja exibido, a caixa de diálogo de progresso não tem um HWND válido. A existência desse HWND pode ser usada para determinar se IProgressDialog::SetAnimation pode ser chamado.

Esse método usa o identificador de instância especificado por hInstAnimation e usa um controle de animação para abrir e executar um clipe AVI silencioso. Há várias restrições sobre quais tipos de clipes AVI podem ser usados, incluindo o seguinte:

  • Clipes não podem incluir som.
  • O tamanho do clipe AVI não pode exceder 272 por 60 pixels. Retângulos menores podem ser usados, mas podem não ser centralizados corretamente.
  • Os clipes de AVI devem ser descompactados ou compactados com a codificação de comprimento de execução (BI_RLE8). Se você tentar usar um tipo de compactação sem suporte, nenhuma animação será exibida.

Requisitos

   
Cliente mínimo com suporte Windows 2000 Professional, Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho shlobj_core.h
DLL Shell32.dll (versão 5.0 ou posterior)

Confira também

IProgressDialog