JumpListItem Clase

Definición

Espacio de nombres:

Windows.UI.StartScreen

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

ContractVersionAttribute MarshalingBehaviorAttribute

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.

Consulte también

• Ejemplo de personalización de lista de saltos