Compartir a través de


JumpList Clase

Definición

Proporciona funcionalidad para la lista de accesos directos de una aplicación. Una lista de accesos directos es un menú proporcionado por el sistema que aparece cuando el usuario hace clic con el botón derecho en un programa en la barra de tareas o en el menú Inicio. Se usa para proporcionar acceso rápido a documentos usados recientemente o con frecuencia y ofrecer vínculos directos a la funcionalidad de la aplicación. No todas las familias de dispositivos admiten listas de accesos directos.

public ref class JumpList sealed
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 131072)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class JumpList final
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 131072)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class JumpList
Public NotInheritable Class JumpList
Herencia
Object Platform::Object IInspectable JumpList
Atributos

Requisitos de Windows

Familia de dispositivos
Windows 10 (se introdujo en la versión 10.0.10586.0)
API contract
Windows.Foundation.UniversalApiContract (se introdujo en la versión v2.0)

Ejemplos

En el ejemplo siguiente se muestra cómo quitar la lista de accesos directos de una aplicación, incluidos los elementos personalizados que podrían haberse agregado anteriormente.

private async void DisableSystemJumpListAsync()
{
    // Get the app's jump list.
    var jumpList = await Windows.UI.StartScreen.JumpList.LoadCurrentAsync();

    // Disable the system-managed jump list group.
    jumpList.SystemGroupKind = Windows.UI.StartScreen.JumpListSystemGroupKind.None;

    // Remove any previously added custom jump list items.
    jumpList.Items.Clear();

    // Save the changes to the app's jump list.
    await jumpList.SaveAsync();
}

En el ejemplo siguiente se muestra cómo establecer el tipo de grupo administrado por el sistema que usa la lista de accesos directos de una aplicación, sin que ello afecte a los elementos de lista de accesos directos personalizados existentes.

private async void SetSystemGroupAsync()
{
    // Get the app's jump list.
    var jumpList = await Windows.UI.StartScreen.JumpList.LoadCurrentAsync();

    // Set the system to autogenerate a Frequent group for the app jump list.
    // Alternatively, this property could be set to JumpListSystemGroupKind.Recent to autogenerate a Recent group.
    jumpList.SystemGroupKind = Windows.UI.StartScreen.JumpListSystemGroupKind.Frequent;

    // No changes were made to the jump list Items property, so any custom tasks and groups remain intact.
    await jumpList.SaveAsync();
}

Comentarios

JumpList de una aplicación se recupera mediante el método LoadCurrentAsync . Si una aplicación no personaliza su lista de accesos directos, el sistema proporciona una lista de accesos directos predeterminada. Actualmente, la lista de accesos directos predeterminada muestra los elementos recientes. Asegúrese de que la aplicación se ha registrado para convertirse en el controlador de archivos predeterminado para un determinado tipo de archivo que desea mostrar en la lista de elementos recientes. Para obtener más información, vea Controlar la activación de archivos.

Propiedades

Items

Obtiene la lista de JumpListItem de la lista de accesos directos. Los elementos son de tipo IVector(JumpListItem).

SystemGroupKind

Obtiene o establece el tipo actual del grupo de listas de accesos directos administrados por el sistema.

Métodos

IsSupported()

Obtiene un valor que indica si el sistema admite listas de accesos directos.

Nota

Solo la familia de dispositivos de escritorio admite listas de accesos directos, los cambios realizados en una lista de accesos directos con una familia de dispositivos diferente no se conservarán.

LoadCurrentAsync()

Recupera de forma asincrónica la lista de accesos directos actual y sus elementos.

SaveAsync()

Guarda de forma asincrónica los cambios en la lista de accesos directos y sus elementos.

Se aplica a

Consulte también