Metodo IProgressDialog::SetAnimation (shlobj_core.h)

Articolo
08/26/2023

[Questo metodo non è supportato in Windows Vista o versioni successive.]

Specifica un clip Audio-Video Interleaved (AVI) che viene eseguito nella finestra di dialogo.

Sintassi

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

Parametri

[in, optional] hInstAnimation

Tipo: HINSTANCE

Handle di istanza al modulo da cui deve essere caricata la risorsa AVI.

idAnimation

Tipo: UINT

Identificatore di risorsa AVI. Per creare questo valore, usare la macro MAKEINTRESOURCE . Il controllo carica la risorsa AVI dal modulo specificato da hInstAnimation.

Valore restituito

Tipo: HRESULT

Restituisce S_OK se ha esito positivo o un valore di errore in caso contrario. In Windows Vista e versioni successive restituisce sempre S_OK.

Commenti

Impossibile chiamare IProgressDialog::SetAnimation prima che la finestra di dialogo di avanzamento sia visibile. Finché non viene visualizzata, la finestra di dialogo di avanzamento non ha un HWND valido. L'esistenza di tale HWND può essere usata per determinare se è possibile chiamare IProgressDialog::SetAnimation .

Questo metodo accetta l'handle dell'istanza specificato da hInstAnimation e usa un controllo di animazione per aprire ed eseguire una clip AVI invisibile all'utente. Esistono diverse restrizioni per quanto riguarda i tipi di clip AVI, tra cui quanto segue:

Le clip non possono includere suoni.
Le dimensioni della clip AVI non possono superare 272 per 60 pixel. È possibile usare rettangoli più piccoli, ma potrebbero non essere centrati correttamente.
Le clip AVI devono essere non compresse o compresse con codifica run-length (BI_RLE8). Se si tenta di usare un tipo di compressione non supportato, non viene visualizzata alcuna animazione.

Requisiti


Client minimo supportato	Windows 2000 Professional, Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	shlobj_core.h
DLL	Shell32.dll (versione 5.0 o successiva)

Vedi anche

IProgressDialog

Condividi tramite