IShellUIHelper4::msSiteModeCreateJumpList Method

Creates a new group of items on the Jump List.

Syntax

Copy

HRESULT msSiteModeCreateJumpList(
    BSTR bstrHeader
);

Parameters

bstrHeader

[in] A BSTR that specifies a title for the Jump List group.

Return Value

Returns one of the following values.

S_OK	The operation completed successfully.
E_NOTIMPL	This method is not supported on Windows CE.

Remarks

A Jump List contains links into your application and elsewhere. The pinned site allows only one Jump List group at a time, and all items are appended to the same list. (For more information, see msSiteModeAddJumpListItem.)

You create a new Jump List group by calling the msSiteModeCreateJumpList method followed by msSiteModeAddJumpListItem and msSiteModeShowJumpList. The list is cleared only if the name provided in the bstrHeader parameter is different from the current list. If necessary, you can call msSiteModeClearJumpList to start a new list; however, doing so prevents the onmssitemodejumplistitemremoved event from being raised.

To view the Jump List, hover over the pinned site shortcut after pinning it to the Start menu, or right-click the pinned site button in the Windows taskbar.

See Also

IShellUIHelper4::msSiteModeAddJumpListItem, IShellUIHelper4::msSiteModeClearJumpList