Método ITaskbarList3::RegisterTab (shobjidl_core.h)

Artigo
03/02/2024

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.

Sintaxe

HRESULT RegisterTab(
  [in] HWND hwndTab,
  [in] HWND hwndMDI
);

Parâmetros

[in] hwndTab

Digite: HWND

Identificador da guia ou janela do documento. Esse valor é necessário e não pode ser NULL.

[in] hwndMDI

Digite: HWND

Identificador da janela de main do aplicativo. Esse valor informa à barra de tarefas a qual grupo de visualização do aplicativo anexar a nova miniatura. Esse valor é necessário e não pode ser NULL.

Retornar valor

Tipo: HRESULT

Retorna S_OK se tiver êxito; caso contrário, um valor de erro. Se um dos parâmetros for NULL, esse método retornará um erro.

Comentários

Por si só, registrar uma miniatura de tabulação sozinho não resultará na exibição dela. Você também deve chamar ITaskbarList3::SetTabOrder para instruir o grupo onde exibi-lo.

Requisitos

Requisito	Valor
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)
Biblioteca	Explorerframe.lib
DLL	Explorerframe.dll