Home Library Learn Downloads Support Community
Sign in | United States - English | |
This topic has not yet been rated Rate this topic

msSiteModeCreateJumpList Method

.NET Framework 3.0
New for Windows Internet Explorer 9

Creates a new group of items on the Jump List.

Syntax

Copy 
window.external.msSiteModeCreateJumpList(bstrHeader)

Parameters

bstrHeader Required. A String that specifies a title for the Jump List group.

Return Value

No return value.

Possible Exceptions

Not implemented (0x80004001) 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.

Applies To

external

See Also

Did you find this helpful?
(1500 characters remaining)
Community Content Add
Annotations FAQ
Only One Jump List
Only one jump list can exist for a pinned site in addition to the default Tasks list. Dynamically created jump lists can have up to 10 items by default, while the Tasks list is limited to 5, by default.
History
Implicit jump list clearing
This function has a side effect of clearing the jump list (despite http://msdn.microsoft.com/en-gb/library/gg491728(v=VS.85).aspx saying otherwise).
There does not appear to be a way to do it only when required.
History