Interfaz ITaskbarList3 (shobjidl_core.h)

  • Artículo

Extiende ITaskbarList2 mediante la exposición de métodos que admiten la funcionalidad unificada de inicio y cambio de botón de barra de tareas agregada en Windows 7. Esta funcionalidad incluye representaciones en miniatura y destinos de conmutador basados en pestañas individuales en una aplicación con pestañas, barras de herramientas en miniatura, superposiciones de estado y notificaciones, e indicadores de progreso.

Herencia

La interfaz ITaskbarList3 hereda de ITaskbarList2. ITaskbarList3 también tiene estos tipos de miembros:

Métodos

La interfaz ITaskbarList3 tiene estos métodos.

 
ITaskbarList3::RegisterTab

Informa a la barra de tareas de que se ha proporcionado una nueva pestaña o miniatura de documento para mostrarla en el control flotante del grupo de la barra de tareas de una aplicación.
ITaskbarList3::SetOverlayIcon

Aplica una superposición a un botón de barra de tareas para indicar el estado de la aplicación o una notificación al usuario.
ITaskbarList3::SetProgressState

Establece el tipo y el estado del indicador de progreso mostrado en un botón de la barra de tareas.
ITaskbarList3::SetProgressValue

Muestra o actualiza una barra de progreso hospedada en un botón de barra de tareas para mostrar el porcentaje específico completado de la operación completa.
ITaskbarList3::SetTabActive

Informa a la barra de tareas de que se ha realizado una pestaña o ventana de documento en la ventana activa.
ITaskbarList3::SetTabOrder

Inserta una nueva miniatura en una interfaz de documento con pestañas (TDI) o en un control flotante de grupo de la aplicación de interfaz de varios documentos (MDI) o mueve una miniatura existente a una nueva posición en el grupo de la aplicación.
ITaskbarList3::SetThumbnailClip

Selecciona una parte del área cliente de una ventana para mostrarla como miniatura de esa ventana en la barra de tareas.
ITaskbarList3::SetThumbnailTooltip

Especifica o actualiza el texto de la información sobre herramientas que se muestra cuando el puntero del mouse se encuentra en una miniatura de vista previa individual en un control flotante del botón de la barra de tareas.
ITaskbarList3::ThumbBarAddButtons

Agrega una barra de herramientas en miniatura con un conjunto especificado de botones a la imagen en miniatura de una ventana en un control flotante del botón de la barra de tareas.
ITaskbarList3::ThumbBarSetImageList

Especifica una lista de imágenes que contiene imágenes de botón para una barra de herramientas incrustada en una imagen en miniatura de una ventana en un control flotante del botón de la barra de tareas.
ITaskbarList3::ThumbBarUpdateButtons

Muestra, habilita, deshabilita u oculta botones en una barra de herramientas en miniatura según sea necesario para el estado actual de la ventana. Una barra de herramientas en miniatura es una barra de herramientas incrustada en una imagen en miniatura de una ventana en un control flotante del botón de la barra de tareas.
ITaskbarList3::UnregisterTab

Quita una miniatura del grupo de vista previa de una aplicación cuando se cierra esa pestaña o documento en la aplicación.

Comentarios

Esta interfaz también proporciona los métodos de las interfaces ITaskbarList e ITaskbarList2 , de las que hereda.

Cuándo implementar

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

Cuándo usar

Use los métodos de esta interfaz para hacer lo siguiente:
  • Cuando se trabaja con una aplicación de TDI (como Windows Internet Explorer) o una aplicación MDI (como Microsoft Excel) que muestra sus ventanas como un grupo en la barra de tareas:
    • Proporcione la barra de tareas con una miniatura que represente la vista de una ficha o documento individual.
    • Quite la miniatura de una ficha o documento individual del grupo.
    • Cambie el orden de las miniaturas en el grupo.
    • Establezca una miniatura de pestaña como elemento seleccionado cuando se muestren las miniaturas.
  • Al aplicar una superposición a un icono de barra de tareas, como una notificación.
  • Al mostrar el progreso de una operación, como copiar o instalar un elemento.
  • Al agregar una barra de herramientas a una miniatura.
Cuando una aplicación muestra una ventana, el sistema crea su botón de barra de tareas. Cuando el botón está en su lugar, la barra de tareas envía un mensaje TaskbarButtonCreated a la ventana. La aplicación debe llamar a RegisterWindowMessage(L"TaskbarButtonCreated") y controlar ese mensaje en su wndproc. La aplicación debe recibir ese mensaje antes de llamar a cualquier método ITaskbarList3 .
Nota Las aplicaciones no se pueden anclar mediante programación a la barra de tareas. Esa funcionalidad está reservada estrictamente para el usuario.
 

Requisitos

   
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

ITaskbarList2

Extensiones de la barra de tareas