src/shobjidl.h File Reference

This file is a minimal required part of shobjidl.h from Microsoft Windows SDK v7.0A. More...

#include <windows.h>

Include dependency graph for shobjidl.h:

Go to the source code of this file.

Classes
interface	ITaskbarList3
	Exposes methods that control the taskbar. More...
Enumerations
enum	TBPFLAG {   TBPF_NOPROGRESS = 0, TBPF_INDETERMINATE = 0x1, TBPF_NORMAL = 0x2, TBPF_ERROR = 0x4,   TBPF_PAUSED = 0x8 }

---

Detailed Description

This file is a minimal required part of shobjidl.h from Microsoft Windows SDK v7.0A.

Author:

Copyright © Microsoft Corporation

Extracted and documented by Lёppa <contacts[at]oleksii[dot]name>

Version:

Microsoft Windows SDK v7.0A

Id:

shobjidl.h 126 2010-08-30 18:00:47Z laleppa

URL:

https://svn.tspsg.info/svnroot/tspsg/trunk/src/shobjidl.h

This file is an extract of shobjidl.h from Microsoft Windows SDK v7.0A. It is needed to support Windows 7 Taskbar Extensions (namely, Progress Bars) and contains minimal required definition of ITaskbarList3 interface.

Tested with MSVC and mingw32. Doesn't need Windows 7 SDK itself.

Note:

Don't forget to link to ole32 library when using this file (usually -lole32 linker flag is enough).

---

Enumeration Type Documentation

enum TBPFLAG

Enumerator:

TBPF_NOPROGRESS	Stops displaying progress and returns the button to its normal state. Call this method with this flag to dismiss the progress bar when the operation is complete or cancelled.
TBPF_INDETERMINATE	The progress indicator does not grow in size, but cycles repeatedly along the length of the taskbar button. This indicates activity without specifying what proportion of the progress is complete. Progress is taking place, but there is no prediction as to how long the operation will take.
TBPF_NORMAL	The progress indicator grows in size from left to right in proportion to the estimated amount of the operation completed. This is a determinate progress indicator; a prediction is being made as to the duration of the operation.
TBPF_ERROR	The progress indicator turns red to show that an error has occurred in one of the windows that is broadcasting progress. This is a determinate state. If the progress indicator is in the indeterminate state, it switches to a red determinate display of a generic percentage not indicative of actual progress.
TBPF_PAUSED	The progress indicator turns yellow to show that progress is currently stopped in one of the windows but can be resumed by the user. No error condition exists and nothing is preventing the progress from continuing. This is a determinate state. If the progress indicator is in the indeterminate state, it switches to a yellow determinate display of a generic percentage not indicative of actual progress.