ITaskbarList3::RegisterTab method (shobjidl_core.h)

Informs the taskbar that a new tab or document thumbnail has been provided for display in an application's taskbar group flyout.

Syntax

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

Parameters

[in] hwndTab

Type: HWND

Handle of the tab or document window. This value is required and cannot be NULL.

[in] hwndMDI

Type: HWND

Handle of the application's main window. This value tells the taskbar which application's preview group to attach the new thumbnail to. This value is required and cannot be NULL.

Return value

Type: HRESULT

Returns S_OK if successful, or an error value otherwise. If either parameter is NULL, this method returns an error.

Remarks

By itself, registering a tab thumbnail alone will not result in its being displayed. You must also call ITaskbarList3::SetTabOrder to instruct the group where to display it.

Requirements

Requirement Value
Minimum supported client Windows 7 [desktop apps only]
Minimum supported server Windows Server 2008 R2 [desktop apps only]
Target Platform Windows
Header shobjidl_core.h (include Shobjidl.h)
Library Explorerframe.lib
DLL Explorerframe.dll

See also

ITaskbarList

ITaskbarList2

ITaskbarList3

ITaskbarList3::SetTabActive

ITaskbarList3::SetTabOrder

ITaskbarList3::UnregisterTab

Taskbar Extensions