Partager via


Interface IActionProgress (shobjidl_core.h)

Représente la classe de base abstraite dont les opérations pilotées par la progression peuvent hériter.

Héritage

L’interface IActionProgress hérite de l’interface IUnknown. IActionProgress a également les types de membres suivants :

Méthodes

L’interface IActionProgress possède ces méthodes.

 
IActionProgress ::Begin

Appelé lorsqu’une action a commencé et que sa progression doit être affichée à l’utilisateur.
IActionProgress ::End

Indique que l’action associée à cette implémentation de progression est terminée.
IActionProgress ::QueryCancel

Fournit des informations sur l’annulation de l’action.
IActionProgress ::ResetCancel

Réinitialise la boîte de dialogue de progression une fois l’annulation terminée.
IActionProgress ::UpdateProgress

Mises à jour la progression d’une action dans l’interface utilisateur.
IActionProgress ::UpdateText

Appelé si le texte descriptif associé à l’action est modifié.

Remarques

Cette classe est une classe abstraite qui ne peut pas être instanciée. Il fournit une infrastructure que les classes dérivées peuvent utiliser pour implémenter un rappel de progression. Ce rappel peut être utilisé par les applications pour signaler la progression des actions à l’interface utilisateur. Ici, « Actions » fait référence aux opérations qui peuvent prendre beaucoup de temps, telles que le téléchargement ou la copie de fichiers, et pendant lesquelles une indication de progression visible serait appropriée.

Les applications n’implémentent généralement pas cette interface. La plupart des fonctionnalités avec lesquelles les utilisateurs interagissent pendant les actions sont fournies par la classe CProgressDialog (CLSID_ProgressDialog) qui implémente IActionProgress et affiche la progression dans une boîte de dialogue. Si une solution nécessitant un mécanisme autre qu’une boîte de dialogue est requise, IActionProgress peut être utilisé pour fournir des fonctionnalités d’indicateur de progression de base.

Une fois implémentées, les classes doivent appeler IActionProgress ::Begin lorsqu’une action est démarrée. Régulièrement, IActionProgress ::UpdateProgress doit être appelé pour mettre à jour l’interface utilisateur avec des informations de progression, et des informations textuelles détaillées doivent être transmises à l’interface utilisateur en appelant IActionProgress ::UpdateText. IActionProgress ::QueryCancel et IActionProgress ::ResetCancel doivent être appelés pour gérer les demandes d’annulation. Une fois l’opération terminée, IActionProgress ::End doit être appelé.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2003 [applications de bureau uniquement]
Plateforme cible Windows
En-tête shobjidl_core.h (inclure Shobjidl.h)

Voir aussi

IProgressDialog