Vcl.JumpList.TCustomJumpList.OnListUpdateError
Delphi
property OnListUpdateError: TCreatingListErrorEvent read FOnListUpdateError write FOnListUpdateError;
C++
__property TCreatingListErrorEvent OnListUpdateError = {read=FOnListUpdateError, write=FOnListUpdateError};
プロパティ
種類 | 可視性 | ソース | ユニット | 親 |
---|---|---|---|---|
event | public | Vcl.JumpList.pas Vcl.JumpList.hpp |
Vcl.JumpList | TCustomJumpList |
説明
アプリケーションのジャンプ リストを更新でエラーがあった場合に、発生します。
ジャンプ リスト コンポーネントは、次の場合にアプリケーションのジャンプ リストを更新します:
- フォームが、ジャンプ リスト コンポーネントを読み込んだ。
- DeleteList または UpdateList を呼び出した。
- AutoRefresh プロパティを
True
に設定した。 - AutoRefresh を有効化してあり、CustomCategories、ShowFrequent、ShowRecent、TasksList の値を変更した。
OnListUpdateError イベントでは、エラーを自分自身で処理し、エラー情報をチェックし、そのエラーを例外を発生させるべきかどうかを判断することができます。
OnListUpdateError のイベント ハンドラは、次のパラメータを受け取ります:
Sender
は、ジャンプ リスト コンポーネントです。WinErrorCode
は、Windows ジャンプ リスト API で定義されているエラー コードです。ErrorDescription
は、エラーの人間が読める形式の説明です。Handled
は、エラーが例外を発生させるべきかどうかを判断します。例外を発生させるには、Handled
をFalse
に設定し、そうでなければ、Handled
をTrue
に発生させます。