Compartir a través de


JumpListItem Clase

Definición

Proporciona funcionalidad para crear y definir elementos de lista de accesos directos para la lista de accesos directos de una aplicación.

public ref class JumpListItem sealed
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 131072)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class JumpListItem final
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 131072)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class JumpListItem
Public NotInheritable Class JumpListItem
Herencia
Object Platform::Object IInspectable JumpListItem
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 crear una tarea para un JumpList que inicia la aplicación con parámetros de línea de comandos y realiza una acción deseada. La localización no se muestra, pero es posible para displayName, description y logo mediante el uso de los esquemas ms-resource: y ms-appx: URI.

private Windows.UI.StartScreen.JumpListItem CreateJumpListItemTask()
{
    var taskItem = JumpListItem.CreateWithArguments(
                            "/Argument", "DisplayName");

    // Set the description. (Optional.)
    taskItem.Description = "Compose a new message to " + friendName;

    // Set the logo for this jump list item. Must be ms-appx: or ms-appdata:.
    taskItem.Logo = new Uri("ms-appdata:///local/downloads/taskImage.png");

    // If the GroupName is left blank, then the item goes into the Tasks group by default.

    return taskItem;
}

partial class App
{
    protected override void OnLaunched(LaunchActivatedEventArgs e)
    {
        if (e.Kind == ActivationKind.Launch && e.Arguments == "/Argument")
        {
            // Run code relevant to the task that was selected.
        }
    }
}

Comentarios

Se crea un JumpListItem mediante los métodos CreateWithArguments y CreateSeparator . Después de la creación, se pueden agregar a la lista de accesos directos de la aplicación mediante la propiedad Items de la lista de accesos directos y el método SaveAsync . Tenga en cuenta que, en la interfaz de usuario, un usuario puede hacer clic con el botón derecho en un elemento de lista de accesos directos que se encuentra en un grupo personalizado y seleccionar "Quitar de esta lista". Cuando se produce esta acción, el sistema marca el elemento como quitado por el usuario y lo suprime de la interfaz de usuario. La próxima vez que una aplicación cargue la lista de accesos directos, debe comprobar los elementos para ver si la propiedad RemovedByUser del elemento está establecida en True. Si RemovedByUser es True, la aplicación debe actualizar su estado interno para que esté sincronizado con el cambio iniciado por el usuario. Es responsabilidad de las aplicaciones asegurarse de que no se vuelve a agregar un elemento quitado a la lista de accesos directos hasta que se cumplan las condiciones para su adición, por ejemplo, por el usuario que abre el documento asociado de nuevo.

Cuando una aplicación guarda JumpList mediante SaveAsync, el sistema operativo organiza los elementos como se indica a continuación.

  • Se quitan todos los elementos con RemovedByUser igual a True.
  • Los elementos con la misma propiedad GroupName se colocan juntos, conservando su orden relativo.
  • Los grupos se ordenan por la posición original del primer elemento del grupo, con la excepción de que los grupos administrados por el sistema siempre están en la parte superior y el grupo Tareas siempre está en la parte inferior si están presentes. Esto significa que cuando una aplicación carga su JumpList mediante el método LoadCurrentAsync , los elementos se recuperan en su orden organizado, lo que podría no estar de acuerdo con el orden de los elementos de la lista de accesos directos cuando se guardó originalmente.

Propiedades

Arguments

Obtiene los argumentos de la línea de comandos para el elemento de lista de accesos directos.

Description

Obtiene o establece la descripción de la tarea de elemento de lista de accesos directos.

DisplayName

Obtiene o establece el nombre para mostrar del elemento de lista de accesos directos. El nombre para mostrar también se puede especificar como un parámetro mediante el método CreateWithArguments cuando se crea el elemento de lista de accesos directos.

GroupName

Obtiene o establece el nombre del grupo personalizado del elemento de lista de accesos directos. Si no se especifica ningún nombre, el elemento se agregará al grupo Tareas de forma predeterminada.

Kind

Obtiene el JumpListItemKind de un elemento de lista de accesos directos.

Logo

Obtiene o establece el logotipo del elemento de lista de accesos directos.

RemovedByUser

Obtiene un valor booleano que indica si el usuario quitó el elemento de lista de accesos directos de la lista de accesos directos de la aplicación.

Métodos

CreateSeparator()

Crea un elemento de lista de accesos directos que es un separador inert para un grupo personalizado dentro de la lista de accesos directos de la aplicación.

CreateWithArguments(String, String)

Crea un nuevo elemento de lista de accesos directos para la lista de accesos directos de una aplicación.

Se aplica a

Consulte también