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) |