1 out of 1 rated this helpful - Rate this topic

ITaskbarList3::RegisterTab method

Applies to: desktop apps only

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

hwndTab [in]

Type: HWND

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

hwndMDI [in]

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

Minimum supported client

Windows 7

Minimum supported server

Windows Server 2008 R2

Header

Shobjidl.h

IDL

Shobjidl.idl

Library

Explorerframe.lib

DLL

Explorerframe.dll

See also

ITaskbarList
ITaskbarList2
ITaskbarList3
ITaskbarList3::SetTabActive
ITaskbarList3::SetTabOrder
ITaskbarList3::UnregisterTab
Taskbar Extensions

 

 

Send comments about this topic to Microsoft

Build date: 3/7/2012

Did you find this helpful?
(1500 characters remaining)
Community Content Add
Annotations FAQ