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 |
|
|
IDL |
|
|
Library |
|
|
DLL |
|
See also
- ITaskbarList
- ITaskbarList2
- ITaskbarList3
- ITaskbarList3::RegisterTab
- ITaskbarList3::SetTabActive
- ITaskbarList3::UnregisterTab
- Taskbar Extensions