Interfaccia IActionProgress (shobjidl_core.h)
Rappresenta la classe di base astratta da cui possono ereditare le operazioni guidate dallo stato.
Ereditarietà
L'interfaccia IActionProgress eredita dall'interfaccia IUnknown . IActionProgress include anche questi tipi di membri:
Metodi
L'interfaccia IActionProgress include questi metodi.
|
IActionProgress::Begin Chiamato quando è iniziata un'azione che richiede la visualizzazione dello stato di avanzamento all'utente. |
|
IActionProgress::End Indica che l'azione associata a questa implementazione di stato è terminata. |
|
IActionProgress::QueryCancel Fornisce informazioni sull'annullamento dell'azione. |
|
IActionProgress::ResetCancel Reimposta la finestra di dialogo di stato dopo il completamento di un annullamento. |
|
IActionProgress::UpdateProgress Aggiornamenti lo stato di avanzamento di un'azione nell'interfaccia utente. |
|
IActionProgress::UpdateText Chiamato se il testo descrittivo associato all'azione verrà modificato. |
Commenti
Questa classe è una classe astratta che potrebbe non essere creata un'istanza. Fornisce un framework che le classi derivate possono usare per implementare un callback di stato. Questo callback può essere usato dalle applicazioni per segnalare lo stato di avanzamento delle azioni all'interfaccia utente. In questo caso, "Azioni" si riferisce a operazioni che possono richiedere una quantità significativa di tempo, ad esempio il download o la copia di file e durante la quale sarebbe appropriata un'indicazione di stato visibile.
Le applicazioni in genere non implementano questa interfaccia. Gran parte delle funzionalità con cui gli utenti interagiscono durante le azioni viene fornita dalla classe CProgressDialog (CLSID_ProgressDialog) che implementa IActionProgress e visualizza lo stato di avanzamento in una finestra di dialogo. Se è necessaria una soluzione che richiede un meccanismo diverso da una finestra di dialogo, È possibile usare IActionProgress per fornire funzionalità di indicatore di stato di base.
Dopo l'implementazione, le classi devono chiamare IActionProgress::Begin all'avvio di un'azione. Periodicamente, IActionProgress::UpdateProgress deve essere chiamato per aggiornare l'interfaccia utente con informazioni sullo stato di avanzamento e le informazioni testuali dettagliate devono essere trasmesse all'interfaccia utente chiamando IActionProgress::UpdateText. IActionProgress::QueryCancel e IActionProgress::ResetCancel devono essere chiamati per gestire le richieste di annullamento. Al termine dell'operazione, è necessario chiamare IActionProgress::End .
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows XP [solo app desktop] |
| Server minimo supportato | Windows Server 2003 [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | shobjidl_core.h (include Shobjidl.h) |