Interface ITaskbarList3 (shobjidl_core.h)

Estende ITaskbarList2 expondo métodos que dão suporte à funcionalidade unificada de botão de inicialização e alternância da barra de tarefas adicionada ao Windows 7. Essa funcionalidade inclui representações em miniatura e destinos de comutador com base em guias individuais em um aplicativo com guias, barras de ferramentas em miniatura, notificação e sobreposições de status e indicadores de progresso.

Herança

A interface ITaskbarList3 herda de ITaskbarList2. ITaskbarList3 também tem estes tipos de membros:

Métodos

A interface ITaskbarList3 tem esses métodos.

ITaskbarList3::RegisterTab Informa à barra de tarefas que uma nova guia ou miniatura de documento foi fornecida para exibição no submenu do grupo de barras de tarefas de um aplicativo.
ITaskbarList3::SetOverlayIcon Aplica uma sobreposição a um botão da barra de tarefas para indicar o status do aplicativo ou uma notificação ao usuário.
ITaskbarList3::SetProgressState Define o tipo e o estado do indicador de progresso exibido em um botão da barra de tarefas.
ITaskbarList3::SetProgressValue Exibe ou atualiza uma barra de progresso hospedada em um botão da barra de tarefas para mostrar a porcentagem específica concluída da operação completa.
ITaskbarList3::SetTabActive Informa à barra de tarefas que uma guia ou janela de documento foi criada na janela ativa.
ITaskbarList3::SetTabOrder Insere uma nova miniatura em um submenu de grupo do aplicativo TDI (interface de documento com guias) ou MDI (interface de vários documentos) ou move uma miniatura existente para uma nova posição no grupo do aplicativo.
ITaskbarList3::SetThumbnailClip Seleciona uma parte da área de cliente de uma janela a ser exibida como a miniatura dessa janela na barra de tarefas.
ITaskbarList3::SetThumbnailTooltip Especifica ou atualiza o texto da dica de ferramenta exibida quando o ponteiro do mouse se baseia em uma miniatura de visualização individual em um submenu de botão da barra de tarefas.
ITaskbarList3::ThumbBarAddButtons Adiciona uma barra de ferramentas em miniatura com um conjunto especificado de botões à imagem em miniatura de uma janela em um submenu de botão da barra de tarefas.
ITaskbarList3::ThumbBarSetImageList Especifica uma lista de imagens que contém imagens de botão para uma barra de ferramentas inserida em uma imagem em miniatura de uma janela em um submenu de botão da barra de tarefas.
ITaskbarList3::ThumbBarUpdateButtons Mostra, habilita, desabilita ou oculta botões em uma barra de ferramentas de miniatura, conforme exigido pelo estado atual da janela. Uma barra de ferramentas em miniatura é uma barra de ferramentas inserida em uma imagem em miniatura de uma janela em um submenu de botão da barra de tarefas.
ITaskbarList3::UnregisterTab Remove uma miniatura do grupo de visualização de um aplicativo quando essa guia ou documento é fechado no aplicativo.

Comentários

Essa interface também fornece os métodos das interfaces ITaskbarList e ITaskbarList2 , das quais ela herda.

Quando implementar

Uma implementação dessa interface é fornecida no Windows como CLSID_TaskbarList. Essa interface não é implementada por terceiros.

Quando usar

Use os métodos dessa interface para fazer o seguinte:

• Ao trabalhar com um aplicativo TDI (como o Windows Internet Explorer) ou um aplicativo MDI (como o Microsoft Excel) que está exibindo suas janelas como um grupo na barra de tarefas:
  • Forneça a barra de tarefas com uma miniatura que representa a exibição de uma guia ou documento individual.
  • Remova a miniatura de uma guia ou documento individual do grupo.
  • Altere a ordem das miniaturas no grupo.
  • Defina uma miniatura de tabulação como o item selecionado quando as miniaturas forem mostradas.
• Ao aplicar uma sobreposição a um ícone da barra de tarefas, como uma notificação.
• Ao mostrar o progresso de uma operação, como copiar ou instalar um item.
• Ao adicionar uma barra de ferramentas a uma miniatura.

Quando um aplicativo exibe uma janela, seu botão da barra de tarefas é criado pelo sistema. Quando o botão está em vigor, a barra de tarefas envia uma mensagem TaskbarButtonCreated para a janela. Seu aplicativo deve chamar RegisterWindowMessage(L"TaskbarButtonCreated") e manipular essa mensagem em seu wndproc. Essa mensagem deve ser recebida pelo aplicativo antes de chamar qualquer método ITaskbarList3 .

Nota Os aplicativos não podem se fixar programaticamente na barra de tarefas. Essa funcionalidade é reservada estritamente para o usuário.

 

Requisitos

Cliente mínimo com suporte	Windows 7 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 R2 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	shobjidl_core.h (inclua Shobjidl.h)

Confira também

ITaskbarList2

Extensões da barra de tarefas