Поделиться через

IControlProgressHandler

  • Статья

Этот интерфейс является клиентским обработчиком, который получает обновления при выполнении библиотекой операции. Затем библиотека выполняет синхронные обратные вызовы клиенту, указывающие ход выполнения операции. В зависимости от действия пользователя код возврата клиента указывает библиотеке либо продолжить операцию, либо отменить ее. Этот процесс позволяет пользовательскому интерфейсу показывать пользователю ход выполнения длительных операций, таких как Сохранение. Если пользователь решит отменить операцию, пользовательский интерфейс возвращает соответствующий код в библиотеку.

Синтаксис

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

Функции

В следующей таблице описаны функции, которые предоставляет этот интерфейс.

Функция Описание

OnBegin

Указывает библиотеке начать операцию.

Onupdate

Указывает библиотеке продолжить выполнение операции.

OnEnd

Возвращает код состояния после завершения операции.

Интерфейсы