IApplicationDestinations インターフェイス (shobjidl_core.h)
アプリケーションがジャンプ リストの 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 を含む) |