IProgressDialog::SetAnimation-Methode (shlobj_core.h)

  • Artikel

[Diese Methode wird in Windows Vista oder höheren Versionen nicht unterstützt.]

Gibt einen Audio-Video interleaved (AVI)-Clip an, der im Dialogfeld ausgeführt wird.

Syntax

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

Parameter

[in, optional] hInstAnimation

Typ: HINSTANCE

Ein instance-Handle für das Modul, aus dem die AVI-Ressource geladen werden soll.

idAnimation

Typ: UINT

Ein AVI-Ressourcenbezeichner. Verwenden Sie zum Erstellen dieses Werts das MAKEINTRESOURCE-Makro . Das Steuerelement lädt die AVI-Ressource aus dem von hInstAnimation angegebenen Modul.

Rückgabewert

Typ: HRESULT

Gibt bei erfolgreicher Ausführung S_OK oder andernfalls einen Fehlerwert zurück. In Windows Vista und höheren Versionen gibt immer S_OK zurück.

Hinweise

IProgressDialog::SetAnimation kann nicht aufgerufen werden, bevor das Statusdialogfeld sichtbar ist. Bis es angezeigt wird, verfügt das Statusdialogfeld über keinen gültigen HWND. Das Vorhandensein dieses HWND kann verwendet werden, um zu bestimmen, ob IProgressDialog::SetAnimation aufgerufen werden kann.

Diese Methode übernimmt das von hInstAnimation angegebene instance-Handle und verwendet ein Animationssteuerelement, um einen unbeaufsichtigten AVI-Clip zu öffnen und auszuführen. Es gibt mehrere Einschränkungen, welche Arten von AVI-Clips verwendet werden können, einschließlich der folgenden:

  • Clips dürfen keinen Sound enthalten.
  • Die Größe des AVI-Clips darf 272 x 60 Pixel nicht überschreiten. Kleinere Rechtecke können verwendet werden, aber sie sind möglicherweise nicht ordnungsgemäß zentriert.
  • AVI-Clips müssen entweder unkomprimiert oder mit BI_RLE8-Codierung komprimiert sein. Wenn Sie versuchen, einen nicht unterstützten Komprimierungstyp zu verwenden, wird keine Animation angezeigt.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows 2000 Professional, Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile shlobj_core.h
DLL Shell32.dll (Version 5.0 oder höher)

Weitere Informationen

IProgressDialog