Metodo IOperationsProgressDialog::StartProgressDialog (shobjidl_core.h)

Avvia la finestra di dialogo di stato specificata.

Sintassi

HRESULT StartProgressDialog(
  [in] HWND       hwndOwner,
  [in] OPPROGDLGF flags
);

Parametri

[in] hwndOwner

Tipo: HWND

Handle per la finestra padre.

[in] flags

Tipo: DWORD

Flag che personalizzano l'operazione. Si noti che questi flag vengono dichiarati in Shlobj.h. Combinazione dei valori seguenti:

PROGDLG_NORMAL (0x00000000)

Comportamento predefinito della finestra di dialogo di stato normale.

PROGDLG_MODAL (0x00000001)

Il dialogo è modale con hwndOwner. L'impostazione predefinita è senza modalità.

PROGDLG_AUTOTIME (0x00000002)

Aggiornare il testo "Line3" con il tempo rimanente. Questo flag non deve essere impostato in modo implicito perché i dialoghi di stato avviati da IOperationsProgressDialog::StartProgressDialog visualizzano automaticamente il tempo rimanente.

PROGDLG_NOTIME (0x00000004)

Non visualizzare il tempo rimanente. Non è consigliabile impostare questo flag tramite IOperationsProgressDialog perché va contro lo scopo della finestra di dialogo.

PROGDLG_NOMINIMIZE (0x00000008)

Non visualizzare il pulsante riduci a icona.

PROGDLG_NOPROGRESSBAR (0x00000010)

Non visualizzare l'indicatore di stato.

PROGDLG_MARQUEEPROGRESS (0x00000020)

Questo flag non è valido in questo metodo. Per impostare l'indicatore di stato sulla modalità di selezione, usare i flag in IOperationsProgressDialog::SetMode.

PROGDLG_NOCANCEL (0x00000040)

Non visualizzare un pulsante annulla perché l'operazione non può essere annullata. Usare questo valore solo quando è assolutamente necessario.

OPPROGDLG_DEFAULT (0x00000000)

Windows 7 e versioni successive. Indica il comportamento predefinito della finestra di dialogo di avanzamento dell'operazione normale.

OPPROGDLG_ENABLEPAUSE (0x00000080)

Visualizzare un pulsante di sospensione. Usare questa opzione solo in situazioni in cui l'operazione può essere sospesa.

OPPROGDLG_ALLOWUNDO (0x00000100)

L'operazione può essere annullata tramite la finestra di dialogo. Il pulsante Arresta diventa Annulla. Se premuto, il pulsante Annulla viene ripristinato su Arresta.

OPPROGDLG_DONTDISPLAYSOURCEPATH (0x00000200)

Non visualizzare il percorso del file di origine nella finestra di dialogo di stato.

OPPROGDLG_DONTDISPLAYDESTPATH (0x00000400)

Non visualizzare il percorso del file di destinazione nella finestra di dialogo di stato.

OPPROGDLG_NOMULTIDAYESTIMATES (0x00000800)

Windows 7 e versioni successive. Se il tempo stimato per il completamento è maggiore di un giorno, non visualizzare l'ora.

OPPROGDLG_DONTDISPLAYLOCATIONS (0x00001000)

Windows 7 e versioni successive. Non visualizzare la riga di posizione nella finestra di dialogo di stato.

Valore restituito

Tipo: HRESULT

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

La finestra di dialogo di stato deve essere creata in un thread separato rispetto all'operazione file in cui viene segnalato il dialogo. Se la finestra di dialogo è in esecuzione nello stesso thread dell'operazione file, i messaggi di stato sono, al massimo, inviati solo come risorse consentite. I messaggi di stato sullo stesso thread dell'operazione file potrebbero non essere inviati affatto.

Dopo aver chiamato IOperationsProgressDialog::StartProgressDialog, tale istanza dell'oggetto CLSID_ProgressDialog non può essere accessibile da IProgressDialog, IActionProgressDialog o IActionProgress. Anche se QueryInterface può essere usato per accedere a queste interfacce, la maggior parte dei relativi metodi non può essere richiamata. IOperationsProgressDialog è l'interfaccia usata per visualizzare la nuova finestra di dialogo di stato per Windows Vista e il motore operativo successivo.

Requisiti