Metodo IProgressDialog::SetCancelMsg (shlobj_core.h)
Imposta un messaggio da visualizzare se l'utente annulla l'operazione.
Sintassi
HRESULT SetCancelMsg(
[in] PCWSTR pwzCancelMsg,
LPCVOID pvResevered
);
Parametri
[in] pwzCancelMsg
Tipo: PCWSTR
Puntatore a una stringa Unicode con terminazione null che contiene il messaggio da visualizzare.
pvResevered
Tipo: LPCVOID
Riservato. Impostare su NULL.
Valore restituito
Tipo: HRESULT
Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .
Commenti
Anche se l'utente fa clic su Annulla, l'applicazione non può chiamare immediatamente IProgressDialog::StopProgressDialog per chiudere la finestra di dialogo. L'applicazione deve attendere fino alla successiva chiamata di IProgressDialog::HasUserCancelled per individuare che l'utente ha annullato l'operazione. Poiché questo ritardo potrebbe essere significativo, la finestra di dialogo di avanzamento fornisce all'utente un feedback immediato cancellando le righe di testo 1 e 2 e visualizzando il messaggio di annullamento nella riga 3. Il messaggio è destinato a informare l'utente che il ritardo è normale e che la finestra di dialogo di stato verrà chiusa a breve. In genere è impostato su qualcosa come "Attendere mentre ...".
Requisiti
| Requisito | Valore |
|---|---|
| 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) |