Interfaz ICustomDestinationList (shobjidl_core.h)

  • Artículo

Expone métodos que permiten a una aplicación proporcionar una lista de accesos directos personalizada, incluidos destinos y tareas, para mostrarlos en la barra de tareas.

Herencia

La interfaz ICustomDestinationList hereda de la interfaz IUnknown . ICustomDestinationList también tiene estos tipos de miembros:

Métodos

La interfaz ICustomDestinationList tiene estos métodos.

 
ICustomDestinationList::AbortList

Interrumpe una sesión de compilación de Jump List iniciada por ICustomDestinationList::BeginList sin confirmar ningún cambio.
ICustomDestinationList::AddUserTasks

Especifica los elementos que se van a incluir en la categoría Tareas de una lista de accesos directos personalizada.
ICustomDestinationList::AppendCategory

Define una categoría personalizada y los destinos que contiene, para su inclusión en una lista de accesos directos personalizada.
ICustomDestinationList::AppendKnownCategory

Especifica que la categoría Frecuente o Reciente debe incluirse en una lista de accesos directos personalizada.
ICustomDestinationList::BeginList

Inicia una sesión de creación para una lista de accesos directos personalizada.
ICustomDestinationList::CommitList

Declara que la lista de accesos directos iniciada por una llamada a ICustomDestinationList::BeginList está completa y lista para mostrarse.
ICustomDestinationList::D eleteList

Elimina una lista de accesos directos personalizada para una aplicación especificada.
ICustomDestinationList::GetRemovedDestinations

Recupera la lista actual de destinos que ha quitado el usuario de la lista de accesos directos existente que esta lista de accesos directos personalizada está pensada para reemplazar.
ICustomDestinationList::SetAppID

Especifica un identificador de modelo de usuario de aplicación único (AppUserModelID) para la aplicación cuyo botón de barra de tareas contendrá la lista de accesos directos personalizada compilada a través de los métodos de esta interfaz. Este método es opcional.

Comentarios

Cuándo implementar

Se proporciona una implementación de esta interfaz en Windows como CLSID_DestinationList. Esta interfaz no la implementan terceros.

Cuándo usar

Los Listas de salto contienen listas de tareas y de destino.
  • Los destinos son elementos que aparecen en las categorías recientes, frecuentes o personalizadas, en función del uso de una persona. Los destinos pueden ser archivos, carpetas, sitios web u otros elementos basados en contenido, pero no están necesariamente respaldados por archivos. Los destinos se pueden considerar como cosas o sustantivos. El usuario puede anclar o quitar destinos de la lista de accesos directos. Por lo general, se representan mediante objetos IShellItem , pero también pueden ser objetos IShellLink .
  • Las tareas son acciones comunes realizadas en una aplicación que se aplican a todos los usuarios de esa aplicación independientemente de los patrones de uso de un individuo. Las tareas se pueden considerar como acciones o verbos. Las tareas no se pueden anclar ni quitar. Se representan mediante objetos IShellLink .

La barra de tareas proporciona cada botón de barra de tareas con una lista de accesos directos. De forma predeterminada, una lista de accesos directos contiene una categoría Reciente , que se rellena automáticamente para las aplicaciones basadas en archivos a través de SHAddToRecentDocs o el cuadro de diálogo de archivo común. Para reemplazar la categoría Recent por la categoría Frecuente o definir, agregar y rellenar sus propias categorías personalizadas, una aplicación debe llamar a los métodos de esta interfaz. La aplicación también puede proporcionar sus propias tareas en función de la arquitectura de la aplicación y el uso previsto.

Nota Una aplicación debe ser un controlador registrado para un tipo de archivo para que un elemento de ese tipo aparezca en su Jump List. Sin embargo, no es necesario ser el controlador predeterminado para ese tipo de archivo.
 
Una lista de accesos directos personalizada está pensada para presentar contenido que la aplicación ha considerado significativa en función del uso anterior de la aplicación o a través de una acción que haya indicado que un elemento es de importancia para el usuario, como el usuario que agrega un elemento a una lista Favoritos.

La aplicación debe llamar a este objeto para proporcionar una lista de accesos directos personalizada a la interfaz de usuario de la barra de tareas. El sistema nunca consulta la aplicación para obtener la información.

Cuando una aplicación proporciona una lista de accesos directos personalizada, asume ciertas responsabilidades en torno a esa lista. Las categorías personalizadas deben rellenarse de forma coherente con el uso previsto de una lista de accesos directos. Los elementos de la lista deben comprobarse si son válidos o generar un error correctamente si se han eliminado. Si el usuario quita un elemento de la lista, se debe respetar esa eliminación.

Una lista de accesos directos personalizada nunca se actualiza realmente en el sentido de cambiar los elementos de una lista existente. En su lugar, la lista anterior se reemplaza por una nueva lista.

La secuencia básica de llamadas al método ICustomDestinationList para compilar y mostrar una jump List personalizada es la siguiente:

  1. SetAppID (obligatorio solo si una aplicación proporciona su propio AppUserModelID)
  2. BeginList
  3. AppendCategory, AppendKnownCategory, AddUserTasks o cualquier combinación de esos tres métodos.
  4. CommitList

Requisitos

Requisito Value
Cliente mínimo compatible Windows 7 [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 R2 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado shobjidl_core.h (include Shobjidl.h)

Consulte también

Extensiones de la barra de tareas