This topic has not yet been rated - Rate this topic

ITaskbarList3::SetTabOrder method

Applies to: desktop apps only

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

Copy

HRESULT SetTabOrder(
  [in]            HWND hwndTab,
  [in, optional]  HWND hwndInsertBefore
);

Parameters

hwndTab [in]

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

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