Vcl.JumpList.TCustomJumpList.UpdateList

• 親: TCustomJumpList

Delphi

function UpdateList: Boolean;

C++

bool __fastcall UpdateList();

プロパティ

種類	可視性	ソース	ユニット	親
function	public	Vcl.JumpList.pas Vcl.JumpList.hpp	Vcl.JumpList	TCustomJumpList

説明

ジャンプ リスト コンポーネントで定義された情報を表示するよう、アプリケーションのジャンプ リストを更新します。

UpdateList は、更新が成功すれば True を、成功しなければ False を返します。

または、AutoRefresh プロパティを有効にすると、ジャンプ リスト コンポーネントに対するすべての変更をアプリケーションのジャンプ リストと同期させることができます。

例外

UpdateList を呼び出すと、次の例外が発生する可能性があります。

例外	Exception.Message	状況
EJumpListException	ジャンプ リストの例外: エラー <コード> がリストの開始で発生しました	ICustomDestinationList::BeginList でエラー コードが返され、かつ、OnListUpdateError イベントを処理していないかイベント ハンドラでエラーを処理済みにしていない。
	ジャンプ リストの例外: エラー <コード> がリストのコミットで発生しました	ICustomDestinationList::CommitList でエラー コードが返され、かつ、OnListUpdateError イベントを処理していないかイベント ハンドラでエラーを処理済みにしていない。
EJumpListItemException	ジャンプ リスト項目の例外: エラー <コード>: 最近使用したカテゴリの追加	ShowRecent が True であり、かつ、ICustomDestinationList::AppendKnownCategory でエラー コードが返された。
	ジャンプ リスト項目の例外: エラー <コード>: よく使用するカテゴリの追加	ShowFrequent が True であり、かつ、ICustomDestinationList::AppendKnownCategory でエラー コードが返された。
	ジャンプ リスト項目の例外: エラー <コード>: ユーザー タスクの追加	1 つ以上のタスクが既に定義されており、そのタスクの 1 つをアプリケーションのジャンプ リストに追加しようとして ICustomDestinationList::AddUserTasks でエラー コードが返された。
	ジャンプ リスト項目の例外: エラー <コード>: カテゴリ <名前> の追加	1 つ以上のカスタム カテゴリが既に定義されており、そのカテゴリの 1 つをアプリケーションのジャンプ リストに追加しようとして ICustomDestinationList::AppendCategory でエラー コードが返された。

UpdateList の実装で使用している以下のメンバで独自の例外が発生する可能性があります。

• GetObjectArray
• GetAsIShellLink

関連項目

• System.Boolean

• Vcl.JumpList.TCustomJumpList.DeleteList

• Vcl.JumpList.TCustomJumpList.TaskList
• Vcl.JumpList.TCustomJumpList.CustomCategories
• Vcl.JumpList.TCustomJumpList.AutoRefresh

• Vcl.JumpList.TCustomJumpList.ShowFrequent
• Vcl.JumpList.TCustomJumpList.ShowRecent

• Vcl.JumpList.TCustomJumpList.OnItemDeleted
• Vcl.JumpList.TCustomJumpList.OnListUpdateError