JumpList - класс

Представляет список элементов и задач, отображаемых на кнопке панели задач Windows 7 в виде меню.

Иерархия наследования

System.Object
  Microsoft.Windows.Shell.JumpList

Пространство имен:  Microsoft.Windows.Shell
Сборка:  Microsoft.Windows.Shell (в Microsoft.Windows.Shell.dll)

Синтаксис

'Декларация
<ContentPropertyAttribute("JumpItems")> _
Public NotInheritable Class JumpList _
    Implements ISupportInitialize

[ContentPropertyAttribute("JumpItems")]
public sealed class JumpList : ISupportInitialize

[ContentPropertyAttribute(L"JumpItems")]
public ref class JumpList sealed : ISupportInitialize

[<Sealed>]
[<ContentPropertyAttribute("JumpItems")>]
type JumpList =  
    class
        interface ISupportInitialize
    end

public final class JumpList implements ISupportInitialize

Тип JumpList предоставляет следующие члены.

Конструкторы

	Имя	Описание
	JumpList()	Инициализирует новый экземпляр класса JumpList.
	JumpList(IEnumerable<JumpItem>, Boolean, Boolean)	Инициализирует новый экземпляр класса JumpList заданными параметрами.

В начало страницы

Свойства

	Имя	Описание
	JumpItems	Получает коллекцию объектов JumpItem, отображаемых в списке переходов.
	ShowFrequentCategory	Получает или задает значение, указывающее, отображаются ли часто используемые элементы в списке переходов.
	ShowRecentCategory	Получает или задает значение, указывающее, отображаются ли недавно использовавшиеся элементы в списке переходов.

В начало страницы

Методы

	Имя	Описание
	AddToRecentCategory(String)	Добавляет указанный путь к элементам в категорию Последние списка переходов.
	AddToRecentCategory(JumpPath)	Добавляет указанный путь перехода в категорию Последние списка переходов.
	AddToRecentCategory(JumpTask)	Добавляет указанную задачу перехода в категорию Последние списка переходов.
	Apply	Передает список JumpList в оболочку Windows в текущем состоянии.
	BeginInit	Инфраструктура. Сигнализирует о начале инициализации объекта JumpList.
	EndInit	Инфраструктура. Сигнализирует о завершении инициализации объекта JumpList.
	Equals	Определяет, равен ли заданный объект Object текущему объекту Object. (Унаследовано от Object.)
	Finalize	Позволяет объекту попытаться освободить ресурсы и выполнить другие операции очистки, перед тем как объект будет утилизирован в процессе сборки мусора. (Унаследовано от Object.)
	GetHashCode	Играет роль хэш-функции для определенного типа. (Унаследовано от Object.)
	GetJumpList	Возвращает объект JumpList, связанный с приложением.
	GetType	Возвращает объект Type для текущего экземпляра. (Унаследовано от Object.)
	MemberwiseClone	Создает неполную копию текущего объекта Object. (Унаследовано от Object.)
	SetJumpList	Задает объект JumpList, связанный с приложением.
	ToString	Возвращение строки, представляющей текущий объект. (Унаследовано от Object.)

В начало страницы

События

	Имя	Описание
	JumpItemsRejected	Происходит, когда оболочке Windows не удается добавить элементы в список переходов.
	JumpItemsRemovedByUser	Происходит при удалении пользователем ранее добавленных элементов из списка переходов.

В начало страницы

Заметки

Панель задач Windows 7 предоставляет расширенные функциональные возможности для запуска программ непосредственно из кнопки панели задач с помощью Списка переходов. Списки переходов также используются в меню Windows 7 "Пуск". Доступ к списку переходов осуществляется правым щелчком по кнопке на панели задач или щелчком по стрелке рядом с программой в меню "Пуск". Дополнительные сведения о списках переходов см. в разделе Панель задач рекомендаций Windows User Experience Interaction Guidelines.

Класс JumpList предоставляет управляемую оболочку для функции Списка переходов в панели задач Windows 7 и управляет данными, которые передаются оболочке Windows. Функциональные возможности, предоставляемые классом JumpList, недоступны в версиях Windows, предшествующих Windows 7. Приложения, использующие класс JumpList, будут работать в других версиях Windows, но список переходов не будет доступен. Дополнительные сведения об оболочке Windows и машинных API-интерфейсах списка переходов см. в разделе Taskbar Extensions (на английском языке).

На следующем рисунке показано список переходов для проигрывателя Windows Media с элементами в категориях Задачи и Частота.

Список переходов проигрывателя Windows Media

Настройка списка переходов

Списки переходов могут содержать два типа элементов — JumpTask и JumpPath. JumpTask — это ссылка на программу, а JumpPath — ссылка на файл. Можно визуально разделить элементы в списке переходов путем создания объекта JumpTask, для которого не указаны свойства Title и CustomCategory. Этот пустой JumpTask будет отображаться как горизонтальная линия в списке переходов.

Примечание
Если тип файла, указанного в JumpPath, не зарегистрирован в вашем приложении, файл не появится в списке переходов.Например, если добавить JumpPath, указывающий на файл .txt, ваше приложение должно быть зарегистрировано для обработки файлов с расширением .txt.Дополнительные сведения см. в разделе Introduction to File Associations (на английском языке).

Элементы перехода помещаются в категории в JumpList. По умолчанию JumpItem отображается в категории Задачи. Можно также указать CustomCategory для JumpItem

Можно указать отображение стандартных категорий Недавние и Частые в JumpList, задав свойства ShowRecentCategory и ShowFrequentCategory. Содержимым этих категорий управляет оболочка Windows. Так как эти категории могут содержать много копий одних и тех же данных, обычно в JumpList отображается одна или другая, но не обе одновременно. Windows автоматически управляет последними элементами, если они открываются посредством общего диалогового окна файлов или используется для открытия приложения с помощью сопоставления типов файлов. Когда доступ к элементу осуществляется через список переходов, можно уведомить оболочку Windows для добавления элемента в категорию Недавние, при помощи метода AddToRecentCategory.

Применение списка переходов к оболочке Windows

Нельзя непосредственно получить доступ к списку переходов в оболочке или прочесть его содержимое в классе JumpList. Вместо этого класс JumpList обеспечивает представление списка переходов, с которым можно работать, а затем применить его к оболочке Windows. Обычно при первом запуске приложения создается и получает значение один JumpList. Однако можно изменить или заменить JumpList во время выполнения.

Если для свойств JumpList были указаны значения, необходимо применить JumpList к оболочке Windows перед тем, как ее содержимое отобразится в списке переходов панели задач. Это выполняется автоматически, когда JumpList впервые вкладывается приложение, в XAML или в вызов метода SetJumpList. Если изменить содержимое JumpList во время выполнения, необходимо вызвать метод Apply для применения его текущего содержимого к оболочке Windows.

Установка списка переходов в XAML

Объект JumpList не прикрепляется автоматически к объекту Application. JumpList вкладывается в объект Application в XAML с использованием синтаксиса вложенного свойства. Класс JumpList реализует интерфейс ISupportInitialize для поддержки XAML объявления JumpList. Если JumpList объявлен в XAML и присоединен к текущему Application, он автоматически применяется к оболочке Windows при инициализации JumpList.

Установка и изменение списка переходов в коде

JumpList вкладывается в объект Application в коде путем вызова статического метода SetJumpList. Также применяет JumpList к оболочке Windows.

Чтобы изменить JumpList во время выполнения, следует вызвать метод GetJumpList и получить JumpList, присоединенный к Application. После изменения свойств JumpList необходимо вызвать метод Apply для применения изменений к оболочке Windows.

Примечание
Обычно создается один JumpList , вложен в Application и применяется к оболочке Windows.Однако можно создать несколько объектов JumpList.Только один JumpList одновременно может быть применен к оболочке Windows, и только один JumpList одновременно может быть связан с Application.Платформа .NET Framework не требует, чтобы они были такими же JumpList.

Примечание
Этот класс содержит запрос связывания на уровне класса, относящийся ко всем элементам.Если у непосредственно вызывающего класса нет разрешения полного доверия, выбрасывается исключение SecurityException.Дополнительные сведения о требованиях безопасности см. в разделе Требования связывания и Требования наследования.

Безопасность платформы .NET Framework

• UIPermission 

  для полного доступа с целью изменения оболочки Windows. Действие по обеспечению безопасности: LinkDemand. Связанное перечисление: UIPermissionWindow.AllWindows

Потокобезопасность

Любые открытые члены этого типа, объявленные как static (Shared в Visual Basic), являются потокобезопасными. Потокобезопасность членов экземпляров не гарантируется.

См. также

Ссылки

Microsoft.Windows.Shell - пространство имен