API:Vcl.JumpList.TJumpList.OnListUpdateError

Delphi

property OnListUpdateError: TCreatingListErrorEvent read FOnListUpdateError write FOnListUpdateError;

C++

__property OnListUpdateError;

種類	可視性	ソース	ユニット	親
event	published	Vcl.JumpList.pas Vcl.JumpList.hpp	Vcl.JumpList	TJumpList

説明

アプリケーションのジャンプリストを更新でエラーがあった場合に、発生します。 {{#multireplace:Vcl.JumpList.TJumpList.OnListUpdateError|H21=!|H25=%|H28=(|H29=)|H2A=*|H2B=+|H2F=/|H3C=<|H3D==|H3E=>|H5B=[|H5D=]|H5E=^|H7C=|}} は {{#multireplace:Vcl.JumpList.TCustomJumpList.OnListUpdateError|H21=!|H25=%|H28=(|H29=)|H2A=*|H2B=+|H2F=/|H3C=<|H3D==|H3E=>|H5B=[|H5D=]|H5E=^|H7C=|}} を継承しています。以下の内容はすべて {{#multireplace:Vcl.JumpList.TCustomJumpList.OnListUpdateError|H21=!|H25=%|H28=(|H29=)|H2A=*|H2B=+|H2F=/|H3C=<|H3D==|H3E=>|H5B=[|H5D=]|H5E=^|H7C=|}} を参照しています。

アプリケーションのジャンプリストを更新でエラーがあった場合に、発生します。

ジャンプリストコンポーネントは、次の場合にアプリケーションのジャンプリストを更新します：

フォームが、ジャンプリストコンポーネントを読み込んだ。
DeleteList または UpdateList を呼び出した。
AutoRefresh プロパティを True に設定した。
AutoRefresh を有効化してあり、CustomCategories、ShowFrequent、ShowRecent、TasksList の値を変更した。

OnListUpdateError イベントでは、エラーを自分自身で処理し、エラー情報をチェックし、そのエラーを例外を発生させるべきかどうかを判断することができます。

OnListUpdateError のイベントハンドラは、次のパラメータを受け取ります：

Sender は、ジャンプリストコンポーネントです。
WinErrorCode は、Windows ジャンプリスト API で定義されているエラーコードです。
ErrorDescription は、エラーの人間が読める形式の説明です。
Handled は、エラーが例外を発生させるべきかどうかを判断します。例外を発生させるには、Handled を False に設定し、そうでなければ、Handled を True に発生させます。