IApplicationDestinations 接口 (shobjidl_core.h)

公开允许应用程序从跳转列表中的 “最近” 或“ 常用 ”类别中删除一个或所有目标的方法。

继承

IApplicationDestinations 接口继承自 IUnknown 接口。 IApplicationDestinations 还具有以下类型的成员:

方法

IApplicationDestinations 接口包含以下方法。

 
IApplicationDestinations::RemoveAllDestinations

从应用程序的跳转列表中“最近”和“常用”类别中清除所有目标条目。
IApplicationDestinations::RemoveDestination

从跳转列表中的“最近”和“常用”类别中删除单个目标。
IApplicationDestinations::SetAppID

指定应用程序的唯一应用程序用户模型 ID (AppUserModelID) ,此接口的方法将从其任务栏按钮的跳转列表中删除目标。 此方法是可选的。

注解

何时实现

此接口的实现在 Windows 中作为CLSID_ApplicationDestinations提供。 此接口不由第三方实现。

何时使用

当应用程序想要从跳转列表自动生成的目标中删除项时,它会调用此接口的方法。 这些目标(位于 “最近” 或“ 常用 ”类别中)是通过调用 SHAddToRecentDocs 生成的,当通过 Windows 资源管理器打开文件或使用通用文件对话框打开、保存或创建文件时,由系统显式调用生成。

在以下情况下,应用程序应调用 IApplicationDestinations 方法:

  • 卸载应用程序时。
  • 当用户清除历史记录时。
  • 当用户在应用程序的“设置”或“选项”页中禁用目标跟踪时。
  • 当用户从应用程序中删除目标时。 对于不是文件的目标,这一点尤其重要。 对于非文件目标(通常(虽然并非总是是 IShellLink 项)而言,当检测到目标不再存在时,应用程序应负责从列表中删除该目标。

如果用户在应用程序的隐私设置中关闭使用情况跟踪,则应用程序负责清除现有数据,并阻止系统将来收集该项目的使用情况数据。 这是通过在应用程序的所有文件类型注册中设置 NoRecentDocs 值来完成的。 有关详细信息 ,请参阅FTA_NoRecentDocs

IApplicationDestinations 方法仅用于自动生成的“ 最近” 或“ 常用 ”类别。 它们不会删除用户已固定到跳转列表的项目。 无法以编程方式删除这些项;只有用户可以删除它们。 这些方法也不会影响 自定义类别 或任务列表。

要求

要求
最低受支持的客户端 Windows 7 [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 R2 [仅限桌面应用]
目标平台 Windows
标头 shobjidl_core.h (包括 Shobjidl.h)

另请参阅

任务栏扩展