This topic has not yet been rated - Rate this topic

ITaskbarList4::SetTabProperties method

Applies to: desktop apps only

Allows a tab to specify whether the main application frame window or the tab window should be used as a thumbnail or in the peek feature under certain circumstances.

Syntax

Copy

HRESULT SetTabProperties(
  [in]  HWND hwndTab,
  [in]  STPFLAG stpFlags
);

Parameters

hwndTab [in]

Type: HWND

The handle of the tab window that is to have properties set. This handle must already be registered through RegisterTab.

stpFlags [in]

Type: STPFLAG

One or more members of the STPFLAG enumeration that specify the displayed thumbnail and peek image source of the tab thumbnail.

Return value

Type: HRESULT

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

Remarks

An application might want to use the thumbnail or peek representation of its associated parent window if the application cannot generate its own thumbnail for a tab or for its active tab content (such as an animation) to appear live.

Requirements