MAPI 進行状況インジケーター
適用対象: Outlook 2013 | Outlook 2016
クライアントに対して実行する操作の多くは、完了するまでに長い時間がかかる場合があります。 長い操作の進行状況をクライアントに通知するには、操作の開始から完了までの任意の時点で、操作の完了部分をグラフィカルに表示するインジケーターを表示できます。 進行状況インジケーターには、完了する操作の合計に対する割合が表示されます。
次のメソッドは、長い操作と進行状況インジケーターの表示をサポートしています。
IMAPIFolder::CopyMessages、 IMAPIFolder::CopyFolder、 IMAPIFolder::D eleteMessages、 IMAPIFolder::D eleteFolder、 IMAPIFolder::EmptyFolder、 IMAPIFolder::SetReadFlags。
IMAPISupport::D oCopyProps、 IMAPISupport::D oCopyTo、 IMAPISupport::CopyFolder、 IMAPISupport::CopyMessages。
進行状況インジケーターを表示するために、MAPI は進行状況オブジェクトを定義します。 進行状況オブジェクトは 、IMAPIProgress: IUnknown インターフェイスを実装します。このインターフェイスには、インジケーターの範囲を確立してディスプレイを作成するためのメソッドが含まれています。 MAPI は、一部のクライアントと同様に進行状況オブジェクトの実装を提供します。 クライアントの実装が指定されている場合は、操作を実行するメソッドへの入力パラメーターとして使用する必要があります。 クライアントが進行状況オブジェクトへのポインターではなく NULL を渡す場合は、 IMAPISupport::D oProgressDialog メソッドを呼び出して MAPI の実装を使用します。