ITaskbarList3::SetThumbnailClip method (shobjidl_core.h)

Selects a portion of a window's client area to display as that window's thumbnail in the taskbar.

Syntax

HRESULT SetThumbnailClip(
  [in] HWND hwnd,
  [in] RECT *prcClip
);

Parameters

[in] hwnd

Type: HWND

The handle to a window represented in the taskbar.

[in] prcClip

Type: RECT*

A pointer to a RECT structure that specifies a selection within the window's client area, relative to the upper-left corner of that client area. To clear a clip that is already in place and return to the default display of the thumbnail, set this parameter to NULL.

Return value

Type: HRESULT

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

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)
Library Explorerframe.lib
DLL Explorerframe.dll

See also

ITaskbarList

ITaskbarList2

ITaskbarList3

Taskbar Extensions