Partager via

IControlProgressHandler

  • Article

Cette interface est un gestionnaire côté client qui reçoit des mises à jour lorsque la bibliothèque effectue une opération. La bibliothèque exécute ensuite des rappels synchrones vers le client indiquant la progression de l’opération. Selon l’action de l’utilisateur, le code de retour du client indique à la bibliothèque de continuer l’opération ou de l’annuler. Ce processus permet à l’interface utilisateur de montrer à l’utilisateur la progression des opérations longues telles que Enregistrer. Si l’utilisateur choisit d’annuler l’opération, l’interface utilisateur retourne le code correspondant à la bibliothèque.

Syntaxe

{
  [id(1), helpstring("OnBegin")] HRESULT OnBegin();
  [id(2), helpstring("OnUpdate")] HRESULT OnUpdate
    ([in] ULONG CurrentValuePercent);
  [id(3), helpstring("OnEnd")] HRESULT OnEnd
    ([in] HRESULT hrResult);
};

Fonctions

Le tableau suivant décrit les fonctions que cette interface fournit.

Fonction Description

OnBegin

Indique à la bibliothèque de commencer une opération.

OnUpdate

Indique à la bibliothèque de poursuivre la progression d’une opération.

OnEnd

Retourne un code status après la fin d’une opération.

Interfaces