Añadir elementos a la lista de acceso rápido de Windows

Una lista de accesos directos es el menú contextual que Windows muestra cuando el usuario hace clic con el botón derecho en el icono de tu aplicación en la barra de tareas o en el menú Inicio. Puede rellenar la lista de accesos directos con tareas (acciones rápidas de toda la aplicación, como redactar un nuevo mensaje o abrir la configuración) y con grupos personalizados de elementos, como proyectos recientes o documentos anclados.

Abra la aplicación Galería de WinUI y vea JumpList en acción.

Importante

La API JumpList requiere la identidad del paquete. Funciona en aplicaciones empaquetadas (MSIX) y aplicaciones empaquetadas con ubicación externa, pero no está disponible en aplicaciones sin empaquetar.

Prerequisites

Cargar la lista de salto actual

Antes de añadir o eliminar elementos, carga la lista de acceso rápido actual de la aplicación llamando a JumpList.LoadCurrentAsync:

using Windows.UI.StartScreen;

var jumpList = await JumpList.LoadCurrentAsync();

Agregar tareas

Las tareas son elementos con una propiedad GroupName vacía. Windows los coloca en una sección integrada llamada Tareas en la parte inferior de la lista de acceso rápido. Use tareas para acciones comunes que siempre sean relevantes independientemente del contexto.

Cree una tarea con JumpListItem.CreateWithArguments, agréguela a la colección Items y, a continuación, guárdela llamando a JumpList.SaveAsync. Cuando el usuario selecciona la tarea, Windows inicia tu aplicación con la cadena de argumentos que proporcionaste, que puedes leer en los argumentos de activación durante el inicio.

var jumpList = await JumpList.LoadCurrentAsync();

var task = JumpListItem.CreateWithArguments("/compose", "New Message");
task.Description = "Compose a new message";
task.Logo = new Uri("ms-appx:///Assets/Tiles/AppList.targetsize-48.png");

jumpList.Items.Add(task);
await jumpList.SaveAsync();

Agregar elementos a un grupo personalizado

Los grupos personalizados le permiten organizar los elementos relacionados bajo un encabezado con nombre. Establezca la propiedad GroupName en una cadena no vacía; todos los elementos que comparten lo mismo GroupName aparecen juntos bajo ese encabezado.

var jumpList = await JumpList.LoadCurrentAsync();

var item = JumpListItem.CreateWithArguments("/project-alpha", "Project Alpha");
item.GroupName = "Projects";
item.Description = "Open Project Alpha";
item.Logo = new Uri("ms-appx:///Assets/Tiles/AppList.targetsize-48.png");

jumpList.Items.Add(item);
await jumpList.SaveAsync();

Borrar todos los elementos

Para quitar todos los elementos que ha agregado, desactive la colección Items antes de guardar:

var jumpList = await JumpList.LoadCurrentAsync();
jumpList.Items.Clear();
await jumpList.SaveAsync();

Windows conserva las secciones administradas por el sistema (como Recientes y Frecuentes), independientemente de esta llamada; solo se borran las tareas y grupos personalizados.

  • Last updated on