IApplicationDestinations インターフェイス (shobjidl_core.h)

[アーティクル]
03/02/2024

アプリケーションがジャンプリストの Recent カテゴリまたは Frequent カテゴリから 1 つまたはすべての宛先を削除できるようにするメソッドを公開します。

継承

IApplicationDestinations インターフェイスは、IUnknown インターフェイスから継承されます。 IApplicationDestinations には、 次の種類のメンバーもあります。

メソッド

IApplicationDestinations インターフェイスには、これらのメソッドがあります。


IApplicationDestinations::RemoveAllDestinations アプリケーションのジャンプリストの [最近] カテゴリと [頻度] カテゴリからすべての宛先エントリをクリアします。
IApplicationDestinations::RemoveDestination ジャンプリストの [最近] カテゴリと [頻度] カテゴリから 1 つの宛先を削除します。
IApplicationDestinations::SetAppID タスクバーボタンのジャンプリストからこのインターフェイスのメソッドが宛先を削除するアプリケーションの一意のアプリケーションユーザーモデル ID (AppUserModelID) を指定します。このメソッドは省略可能です。

注釈

実装するタイミング

このインターフェイスの実装は、CLSID_ApplicationDestinationsとして Windows で提供されます。このインターフェイスは、サードパーティによって実装されていません。

使用するタイミング

ジャンプリストの自動的に生成された宛先から項目を削除する場合、アプリケーションはこのインターフェイスのメソッドを呼び出します。これらの宛先は、[最近] カテゴリまたは [頻繁] カテゴリに含まれていますが、SHAddToRecentDocs の呼び出しを通じて生成されます。明示的に、または Windows エクスプローラーを介してファイルを開くか、共通ファイルダイアログを使用してファイルを開く、保存する、または作成するときにシステムによって生成されます。

アプリケーションは、次の状況で IApplicationDestinations メソッドを呼び出す必要があります。

アプリケーションがアンインストールされたとき。
ユーザーが履歴をクリアしたとき。
ユーザーがアプリケーションの [設定] ページまたは [オプション] ページで宛先の追跡を無効にした場合。
ユーザーがアプリケーション内から宛先を削除した場合。これは、ファイルではない宛先の場合に特に重要です。ファイル以外の宛先 (通常は必ずしも IShellLink 項目) の場合は、リストが存在しなくなったことを検出したときに、その宛先をリストから削除するのはアプリケーションの責任です。

ユーザーがアプリケーションのプライバシー設定で使用状況の追跡をオフにした場合、アプリケーションは既存のデータをクリアし、システムが将来そのアイテムの使用状況データを収集するのを停止する必要があります。これを行うには、アプリケーションのすべてのファイルの種類の登録で NoRecentDocs 値を設定します。詳細については、「 FTA_NoRecentDocs 」を参照してください。

IApplicationDestinations メソッドは、自動生成された Recent カテゴリまたは Frequent カテゴリでのみ使用されます。ユーザーがジャンプリストにピン留めした項目は削除されません。これらの項目はプログラムで削除できません。削除できるのはユーザーだけです。これらのメソッドは、カスタムカテゴリやタスクリストにも影響しません。

要件

要件	値
サポートされている最小のクライアント	Windows 7 [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows Server 2008 R2 [デスクトップアプリのみ]
対象プラットフォーム	Windows
ヘッダー	shobjidl_core.h (Shobjidl.h を含む)

こちらもご覧ください

タスクバー拡張機能