ITaskbarList3 Interface Reference

Exposes methods that control the taskbar. More...

#include <shobjidl.h>

List of all members.

Public Member Functions
HRESULT	SetProgressState (HWND hwnd, TBPFLAG tbpFlags)
	Sets the type and state of the progress indicator displayed on a taskbar button.
HRESULT	SetProgressValue (HWND hwnd, ULONGLONG ullCompleted, ULONGLONG ullTotal)
	Displays or updates a progress bar hosted in a taskbar button to show the specific percentage completed of the full operation.

---

Detailed Description

Exposes methods that control the taskbar.

Extends ITaskbarList2 by exposing methods that support the unified launching and switching taskbar button functionality added in Windows 7. This functionality includes thumbnail representations and switch targets based on individual tabs in a tabbed application, thumbnail toolbars, notification and status overlays, and progress indicators. This interface also provides the methods of the ITaskbarList and ITaskbarList2 interfaces, from which it inherits.

---

Member Function Documentation

HRESULT ITaskbarList3::SetProgressState	(	HWND	hwnd,
		TBPFLAG	tbpFlags
	)

Sets the type and state of the progress indicator displayed on a taskbar button.

Parameters:

hwnd	The handle of the window in which the progress of an operation is being shown. This window's associated taskbar button will display the progress bar.
tbpFlags	Flags that control the current state of the progress button.

Returns:

Returns S_OK if successful, or an error value otherwise.

Note:

A call to SetProgressValue() will switch a progress indicator currently in an indeterminate mode (TBPF_INDETERMINATE) to a normal (determinate) display and clear the TBPF_INDETERMINATE flag.

HRESULT ITaskbarList3::SetProgressValue	(	HWND	hwnd,
		ULONGLONG	ullCompleted,
		ULONGLONG	ullTotal
	)

Displays or updates a progress bar hosted in a taskbar button to show the specific percentage completed of the full operation.

Parameters:

hwnd	The handle of the window whose associated taskbar button is being used as a progress indicator.
ullCompleted	An application-defined value that indicates the proportion of the operation that has been completed at the time the method is called.
ullTotal	An application-defined value that specifies the value ullCompleted will have when the operation is complete.

---

The documentation for this interface was generated from the following file:

• src/shobjidl.h