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) |