TaskbarItemInfo.ThumbButtonInfos Property
Gets or sets the collection of ThumbButtonInfo objects that are associated with the Window.
Namespace: Microsoft.Windows.Shell
Assembly: Microsoft.Windows.Shell (in Microsoft.Windows.Shell.dll)
Syntax
'Declaration
Public Property ThumbButtonInfos As ThumbButtonInfoCollection
public ThumbButtonInfoCollection ThumbButtonInfos { get; set; }
public:
property ThumbButtonInfoCollection^ ThumbButtonInfos {
ThumbButtonInfoCollection^ get ();
void set (ThumbButtonInfoCollection^ value);
}
member ThumbButtonInfos : ThumbButtonInfoCollection with get, set
function get ThumbButtonInfos () : ThumbButtonInfoCollection
function set ThumbButtonInfos (value : ThumbButtonInfoCollection)
Property Value
Type: Microsoft.Windows.Shell.ThumbButtonInfoCollection
The collection of ThumbButtonInfo objects that are associated with the Window. The default is an empty collection.
Remarks
You can add buttons to the taskbar thumbnail to give users access to common tasks without requiring them to switch to the application window. For example, Windows Media Player provides Play, Pause, Forward, and Back buttons that let users control media playback from the taskbar thumbnail when the application is minimized. Buttons in the taskbar thumbnail are represented by ThumbButtonInfo objects and are contained in the ThumbButtonInfos collection.
The Windows 7 shell allows a maximum of seven buttons in the taskbar thumbnail. If more than seven ThumbButtonInfo objects are added to the ThumbButtonInfoCollection, the additional objects are treated as overflow. When a button is Collapsed, it does not have any visible elements, and no space is reserved for it. In this case, additional buttons from the ThumbButtonInfoCollection overflow are displayed.
The following illustration shows the taskbar preview with a collection of two thumb buttons.
Windows Taskbar Thumb Buttons
.png "Taskbar Item Info Sample")
.NET Framework Security
- Full trust for the immediate caller. This member cannot be used by partially trusted code. For more information, see Using Libraries from Partially Trusted Code.