Condividi tramite


Metodo IProgressDialog::SetLine (shlobj_core.h)

Visualizza un messaggio nella finestra di dialogo di avanzamento.

Sintassi

HRESULT SetLine(
       DWORD   dwLineNum,
  [in] PCWSTR  pwzString,
       BOOL    fCompactPath,
       LPCVOID pvResevered
);

Parametri

dwLineNum

Tipo: DWORD

Numero di riga in cui deve essere visualizzato il testo. Attualmente ci sono tre righe, 1, 2 e 3. Se il flag di PROGDLG_AUTOTIME è stato incluso nel parametro dwFlags quando è stato chiamato IProgressDialog::StartProgressDialog , è possibile usare solo le righe 1 e 2. L'ora stimata verrà visualizzata nella riga 3.

[in] pwzString

Tipo: PCWSTR

Stringa Unicode con terminazione null contenente il testo.

fCompactPath

Tipo: BOOL

TRUE per avere stringhe di percorso compattate se sono troppo grandi per adattarsi a una linea. I percorsi vengono compattati con PathCompactPath.

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

Questa funzione viene in genere usata per visualizzare un messaggio come "Elemento XXX è ora in fase di elaborazione". In genere, i messaggi vengono visualizzati nelle righe 1 e 2, con riga 3 riservata per l'ora stimata.

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)

Vedi anche

IProgressDialog