ITaskbarList3::SetTabOrder method

Inserts a new thumbnail into a tabbed-document interface (TDI) or multiple-document interface (MDI) application's group flyout or moves an existing thumbnail to a new position in the application's group.

Syntax

HRESULT SetTabOrder(
  HWND hwndTab,
  HWND hwndInsertBefore
);

Parameters

hwndTab

Type: HWND

The handle of the tab window whose thumbnail is being placed. This value is required, must already be registered through ITaskbarList3::RegisterTab, and cannot be NULL.

hwndInsertBefore

Type: HWND

The handle of the tab window whose thumbnail that hwndTab is inserted to the left of. This handle must already be registered through ITaskbarList3::RegisterTab. If this value is NULL, the new thumbnail is added to the end of the list.

Return Value

Type: HRESULT

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

Remarks

This method must be called for the thumbnail to be shown in the group. Call it after you have called ITaskbarList3::RegisterTab.

Requirements

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

ITaskbarList3::UnregisterTab

Taskbar Extensions