Metodo IActionProgress::UpdateText (shobjidl_core.h)

Chiamato se il testo descrittivo associato all'azione verrà modificato.

Sintassi

HRESULT UpdateText(
  [in] SPTEXT  sptext,
  [in] LPCWSTR pszText,
  [in] BOOL    fMayCompact
);

Parametri

[in] sptext

Tipo: SPTEXT

Valore che specifica il tipo di testo visualizzato. Per i valori accettabili, vedere SPTEXT .

[in] pszText

Tipo: LPCWSTR

Puntatore a una stringa di caratteri wide da visualizzare.

[in] fMayCompact

Tipo: BOOL

Valore che specifica se consentire la compattabilità di una stringa di testo per adattare lo spazio disponibile sullo schermo.

Valore restituito

Tipo: HRESULT

Restituisce S_OK se ha esito positivo o un valore di errore in caso contrario.

Commenti

La classe che implementa questo metodo deve interpretare il valore di sptext e fMayCompact nel contesto dell'azione eseguita e dell'interfaccia utente che mostra lo stato di avanzamento dell'utente. Il valore di sptext può essere usato per distinguere tra righe di testo modificabile. Spesso, il valore di fMayCompact fa riferimento al fatto che la stringa di testo possa essere troncata con i puntini di sospensione (...) per risparmiare spazio sullo schermo.

Requisiti

Vedi anche

IActionProgress

SPTEXT