Share via

Метод IProgressDialog::SetAnimation (shlobj_core.h)

  • Статья

[Этот метод не поддерживается в Windows Vista и более поздних версиях.]

Указывает клип Audio-Video с чередованием (AVI), который выполняется в диалоговом окне.

Синтаксис

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

Параметры

[in, optional] hInstAnimation

Тип: HINSTANCE

Дескриптор экземпляра для модуля, из которого должен быть загружен ресурс AVI.

idAnimation

Тип: UINT

Идентификатор ресурса AVI. Чтобы создать это значение, используйте макрос MAKEINTRESOURCE . Элемент управления загружает ресурс AVI из модуля, указанного в hInstAnimation.

Возвращаемое значение

Тип: HRESULT

Возвращает S_OK в случае успешного выполнения или значение ошибки в противном случае. В Windows Vista и более поздних версиях всегда возвращает S_OK.

Комментарии

IProgressDialog::SetAnimation не может быть вызван до того, как откроется диалоговое окно хода выполнения. Пока он не отобразится, в диалоговом окне хода выполнения отсутствует допустимый HWND. Существование этого HWND можно использовать для определения возможности вызова IProgressDialog::SetAnimation .

Этот метод принимает дескриптор экземпляра, заданный hInstAnimation , и использует элемент управления анимацией для открытия и запуска автоматического клипа AVI. Существует несколько ограничений на то, какие типы клипов AVI можно использовать, в том числе следующие:

  • Клипы не могут включать звук.
  • Размер клипа AVI не может превышать 272 х 60 пикселей. Можно использовать небольшие прямоугольники, но они могут быть неправильно центрированы.
  • Клипы AVI должны быть несжаты или сжаты с помощью кодировки продолжительности выполнения (BI_RLE8). При попытке использовать неподдерживаемый тип сжатия анимация не отображается.

Требования

   
Минимальная версия клиента Windows 2000 Professional, Windows XP [только классические приложения]
Минимальная версия сервера Windows Server 2003 [только классические приложения]
Целевая платформа Windows
Header shlobj_core.h
DLL Shell32.dll (версия 5.0 или более поздняя)

См. также раздел

IProgressDialog