JumpList (Clase)

Representa una lista de elementos y tareas que se muestra como un menú de un botón de la barra de tareas de Windows 7.

Jerarquía de herencia

System.Object
  Microsoft.Windows.Shell.JumpList

Espacio de nombres:  Microsoft.Windows.Shell
Ensamblado:  Microsoft.Windows.Shell (en Microsoft.Windows.Shell.dll)

Sintaxis

'Declaración
<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

El tipo JumpList expone los siguientes miembros.

Constructores

	Nombre	Descripción
	JumpList()	Inicializa una nueva instancia de la clase JumpList.
	JumpList(IEnumerable<JumpItem>, Boolean, Boolean)	Inicializa una nueva instancia de la clase JumpList con los parámetros especificados.

Arriba

Propiedades

	Nombre	Descripción
	JumpItems	Obtiene la colección de objetos JumpItem que aparecen en la Jump List.
	ShowFrequentCategory	Obtiene o establece un valor que indica si los elementos que se usan con frecuencia aparecen en la Jump List.
	ShowRecentCategory	Obtiene o establece un valor que indica si los elementos usados recientemente aparecen en la Jump List.

Arriba

Métodos

	Nombre	Descripción
	AddToRecentCategory(String)	Agrega la ruta de acceso del elemento especificado a la categoría Reciente de la Jump List.
	AddToRecentCategory(JumpPath)	Agrega la ruta de acceso especificada para el salto a la categoría Reciente de la Jump List.
	AddToRecentCategory(JumpTask)	Agrega la tarea especificada para el salto a la categoría Reciente de la Jump List.
	Apply	Envía JumpList al shell de Windows en su estado actual.
	BeginInit	Infraestructura. Señala el inicio de la inicialización de JumpList.
	EndInit	Infraestructura. Señala el final de la inicialización de JumpList.
	Equals	Determina si el objeto Object especificado es igual al objeto Object actual. (Se hereda de Object).
	Finalize	Permite que un objeto intente liberar recursos y realizar otras operaciones de limpieza antes de ser reclamado por la recolección de elementos no utilizados. (Se hereda de Object).
	GetHashCode	Actúa como función hash para un tipo concreto. (Se hereda de Object).
	GetJumpList	Devuelve el objeto JumpList asociado a una aplicación.
	GetType	Obtiene el objeto Type de la instancia actual. (Se hereda de Object).
	MemberwiseClone	Crea una copia superficial del objeto Object actual. (Se hereda de Object).
	SetJumpList	Establece el objeto JumpList asociado a una aplicación.
	ToString	Devuelve una cadena que representa el objeto actual. (Se hereda de Object).

Arriba

Eventos

	Nombre	Descripción
	JumpItemsRejected	Se produce cuando el shell de Windows no agrega correctamente los elementos de salto a la Jump list.
	JumpItemsRemovedByUser	Se produce cuando el usuario quita de la lista los elementos de salto que anteriormente estaban en la Jump List.

Arriba

Comentarios

La barra de tareas Windows 7 proporciona la funcionalidad mejorada para iniciar programas directamente del botón de la barra de tareas con las Jump List. Las Jump Lists también se usan en el menú Inicio de Windows 7. Puede tener acceso a una Jump List haciendo clic con el botón secundario en un botón de la barra de tareas, o haciendo clic en la flecha junto a un programa en el menú Inicio. Para obtener más información sobre Jump Lists, vea la sección Taskbar de Windows User Experience Interaction Guidelines.

La clase JumpList proporciona un contenedor administrado para la funcionalidad Jump List en la barra de tareas Windows 7 y administra los datos pasados al núcleo Windows. La funcionalidad que expone la clase JumpList no está disponible en versiones de Windows anteriores a Windows 7. Las aplicaciones que usan la clase JumpList se ejecutarán en otras versiones de Windows, pero la Jump List no estará disponible. Para obtener más información sobre el uso del shell de Windows y API de Jump List nativas, vea Taskbar Extensions.

La siguiente ilustración muestra la Jump list del Reproductor de Windows Media, con elementos en las categorías Frecuente y Tareas.

Jump List del Reproductor de Windows Media

Configurar una Jump List

Las Jump Lists pueden contener dos tipos de elementos, JumpTask y JumpPath. Un JumpTask es un vínculo a un programa y un JumpPath es un vínculo a un archivo. Puede separar visualmente los elementos de una Jump List creando un JumpTask que no tenga especificado Title ni CustomCategory. Este JumpTask vacío se mostrará como una línea horizontal en la Jump List.

Nota
Si su aplicación no registra el tipo de archivo especificado en JumpPath, el archivo no aparecerá en la Jump List.Por ejemplo, si agrega un JumpPath que señala a un archivo .txt, su aplicación se debe registrar para administrar archivos .txt.Para obtener más información, vea Introduction to File Associations.

Los elementos de salto se colocan en categorías en JumpList. De manera predeterminada, se muestra un JumpItem en la categoría Tareas. Otra posibilidad consiste en especificar CustomCategory para JumpItem.

Puede especificar si las categorías estándar Reciente y Frecuente se muestran en JumpList estableciendo las propiedades ShowFrequentCategory y ShowRecentCategory. El shell Windows administra el contenido de estas categorías. Dado que estas categorías podrían contener gran parte de los mismos datos, normalmente se muestra uno o el otro en JumpList, pero no ambos. Windows administra automáticamente elementos recientes si se abren a través de un cuadro de diálogo de archivos común o si se usan para abrir una aplicación a través de la asociación del tipo de archivo. Cuando se tiene acceso a un elemento a través de la Jump List, puede notificar al shell Windows para agregar el elemento a la categoría Reciente llamando al método AddToRecentCategory.

Aplicar una Jump List al shell de Windows

No puede obtener acceso directamente a la Jump List del shell o leer su contenido en la clase JumpList. En su lugar, la clase JumpList proporciona una representación de un Jump List con la que puede trabajar y, a continuación, se aplica al shell de Windows. Normalmente, creará JumpList y lo establecerá una vez cuando primero se ejecuta la aplicación. Sin embargo, puede modificar o reemplazar JumpList en tiempo de ejecución.

Al haber establecido las propiedades JumpList, se debe aplicar JumpList al shell de Windows antes de que su contenido aparezca en el barra de tareas Jump List. Automáticamente se hace esto cuando JumpList se adjunta primero a una aplicación, bien en XAML o en una llamada al método SetJumpList. Si modifica el contenido de JumpList en tiempo de ejecución, debe llamar al método Apply para aplicar su contenido actual al shell de Windows.

Establecer una Jump List en XAML

JumpList no se adjunta automáticamente a un objeto Application. Adjunta JumpList a un objeto Application en XAML mediante la sintaxis de propiedad adjunta. La clase JumpList implementa la interfaz ISupportInitialize para admitir declaración de XAML de JumpList. Si JumpList se declara en XAML y se adjunta al Application actual, se aplica automáticamente al shell de Windows cuando se inicializa JumpList.

Establecer y modificar una Jump List en el código

Adjunta JumpList a un objeto Application en código llamando al método SetJumpList estático. Esto también aplica JumpList al shell Windows.

Para modificar JumpList en tiempo de ejecución, llame al método GetJumpList para obtener JumpList que se adjuntan actualmente a Application. Una vez modificadas las propiedades de JumpList, debe llamar al método Apply para aplicar los cambios al shell de Windows.

Nota
Normalmente, crea un JumpList que se adjunta a Application y se aplica al shell Windows.Sin embargo, puede crear varios objetos JumpList.Solo un JumpList se puede aplicar a la vez al núcleo Windows y solo un JumpList puede estar asociado a la vez a Application.El entorno .NET Framework no requiere que éstos sean lo mismo que JumpList.

Nota
Esta clase contiene una petición de vínculo en el nivel de clase que se aplica a todos los miembros.Si el llamador inmediato no dispone de permisos de plena confianza, se produce una excepción SecurityException.Para obtener más información sobre solicitudes de seguridad, vea Peticiones de vínculos y Peticiones de herencia.

Seguridad de .NET Framework

• UIPermission 

  para el acceso total para modificar el shell de Windows. Acción de seguridad: LinkDemand Enumeración asociada: UIPermissionWindow.AllWindows.

Seguridad para subprocesos

Todos los miembros static (Shared en Visual Basic) públicos de este tipo son seguros para la ejecución de subprocesos. No se garantiza que los miembros de instancias sean seguros para la ejecución de subprocesos.

Vea también

Referencia

Microsoft.Windows.Shell (Espacio de nombres)