Export (0) Print
Expand All

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(
  [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

Minimum supported client

Windows 7 [desktop apps only]

Minimum supported server

Windows Server 2008 R2 [desktop apps only]

Header

Shobjidl.h

IDL

Shobjidl.idl

Library

Explorerframe.lib

DLL

Explorerframe.dll

See also

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

 

 

Community Additions

ADD
Show:
© 2014 Microsoft