Edit

Share via

ITaskbarList4::SetTabProperties method (shobjidl_core.h)

  • Article

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

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

Parameters

[in] hwndTab

Type: HWND

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

[in] stpFlags

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

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)

See also

ITaskbarList4