IProgressDialog::SetAnimation-Methode (shlobj_core.h)
[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) |