ITaskbarList3::SetTabActive method (shobjidl_core.h)

Informs the taskbar that a tab or document window has been made the active window.

Syntax

HRESULT SetTabActive(
  [in] HWND  hwndTab,
  [in] HWND  hwndMDI,
  [in] DWORD dwReserved
);

Parameters

[in] hwndTab

Type: HWND

Handle of the active tab window. This handle must already be registered through ITaskbarList3::RegisterTab. This value can be NULL if no tab is active.

[in] hwndMDI

Type: HWND

Handle of the application's main window. This value tells the taskbar which group the thumbnail is a member of. This value is required and cannot be NULL.

[in] dwReserved

Type: DWORD

Reserved; set to 0.

Return value

Type: HRESULT

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

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::RegisterTab

ITaskbarList3::SetTabOrder

ITaskbarList3::UnregisterTab

Taskbar Extensions