Edit

IApplicationDocumentLists interface (shobjidl_core.h)

  • Article

Exposes methods that allow an application to retrieve the contents of the Recent or Frequent categories in a Jump List.

Inheritance

The IApplicationDocumentLists interface inherits from the IUnknown interface. IApplicationDocumentLists also has these types of members:

Methods

The IApplicationDocumentLists interface has these methods.

 
IApplicationDocumentLists::GetList

Retrieves an object that represents the collection of destinations listed in the Recent or Frequent category in a Jump List.
IApplicationDocumentLists::SetAppID

Specifies a unique Application User Model ID (AppUserModelID) for the application whose destination lists are being retrieved. This method is optional.

Remarks

When to Implement

An implementation of this interface is provided in Windows as CLSID_ApplicationDocumentLists. This interface is not implemented by third parties.

When to Use

An application calls the methods of this interface when it wants to retrieve a Jump List's Recent or Frequent list. These lists are generated through calls to SHAddToRecentDocs, either explicitly or by the system when a file is opened through Windows Explorer or the common file dialog is used to open, save, or create a file.

IApplicationDocumentLists is used only with the automatically generated Recent or Frequent categories. It cannot retrieve a list of items that the user has pinned to the Jump List. That list cannot be retrieved programmatically because it cannot be manipulated programmatically; it is strictly under the user's control. IApplicationDocumentLists also cannot access custom categories or the task list.

Requirements

Requirement Value
Minimum supported client Windows 7 [desktop apps only]
Minimum supported server Windows Server 2008 R2 [desktop apps only]
Target Platform Windows
Header shobjidl_core.h (include Shobjidl.h)

See also

Taskbar Extensions