次の方法で共有

IControlProgressHandler

  • [アーティクル]

このインターフェイスは、ライブラリが操作を実行するときに更新を受け取るクライアント側ハンドラーです。 その後、ライブラリは、操作の進行状況を示す同期コールバックをクライアントに対して実行します。 ユーザーの操作に応じて、クライアントのリターン コードは、操作を続行するか、それを取り消すようライブラリに指示します。 このプロセスを使用すると、Save などの時間のかかる操作の進行状況を UI を通じてユーザーに表示できます。 ユーザーが操作の取り消しを選択した場合、対応するコードが UI からライブラリに返されます。

構文

{
  [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

状態コードを操作の終了後に返します。

インターフェイス