Metodo IProgressDialog::StartProgressDialog (shlobj_core.h)

Avvia la finestra di dialogo di avanzamento.

Sintassi

HRESULT StartProgressDialog(
  [in] HWND     hwndParent,
       IUnknown *punkEnableModless,
       DWORD    dwFlags,
       LPCVOID  pvResevered
);

Parametri

[in] hwndParent

Tipo: HWND

Handle nella finestra padre della finestra di dialogo.

punkEnableModless

Tipo: IUnknown*

Riservato. Impostare su NULL.

dwFlags

Tipo: DWORD

Contrassegna che controlla l'operazione della finestra di dialogo di avanzamento. Combinazione dei valori seguenti:

PROGDLG_NORMAL

Comportamento normale della finestra di dialogo stato.

PROGDLG_MODAL

La finestra di dialogo di avanzamento sarà modale alla finestra specificata da hwndParent. Per impostazione predefinita, una finestra di dialogo di stato è senza modalità.

PROGDLG_AUTOTIME

Stimare automaticamente il tempo rimanente e visualizzare la stima sulla riga 3. Se questo flag è impostato, È possibile usare IProgressDialog::SetLine solo per visualizzare il testo nelle righe 1 e 2.

PROGDLG_NOTIME

Non visualizzare il testo "tempo rimanente".

PROGDLG_NOMINIMIZE

Non visualizzare un pulsante a icona nella barra di didascalia della finestra di dialogo.

PROGDLG_NOPROGRESSBAR

Non visualizzare una barra di stato. In genere, un'applicazione può determinare in modo quantitativo la quantità dell'operazione e passare periodicamente tale valore a IProgressDialog::SetProgress. La finestra di dialogo stato usa queste informazioni per aggiornare la barra di avanzamento. Questo flag viene in genere impostato quando l'applicazione chiamante deve attendere il completamento di un'operazione, ma non dispone di informazioni quantitative che può usare per aggiornare la finestra di dialogo.

PROGDLG_MARQUEEPROGRESS

Windows Vista e versioni successive. Imposta la barra di stato su modalità di selezione. In questo modo, la barra di avanzamento viene scorrere orizzontalmente, simile a una visualizzazione del riquadro. Usare questa opzione quando si desidera indicare che lo stato di avanzamento viene eseguito, ma il tempo necessario per l'operazione è sconosciuto.

PROGDLG_NOCANCEL

Windows Vista e versioni successive. Non visualizzare un pulsante annulla. Impossibile annullare l'operazione. Usare questo solo quando è assolutamente necessario.

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 .

Requisiti

Vedi anche

IProgressDialog