ITaskbarList3::SetTabOrder method (shobjidl_core.h)

Article
02/22/2024

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(
  [in]           HWND hwndTab,
  [in, optional] HWND hwndInsertBefore
);

Parameters

[in] 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.

[in, optional] 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

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