Interfaz ITaskbarList3 (shobjidl_core.h)
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.
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) |