Class ThumbnailToolBarManager

Namespace

Microsoft.WindowsAPICodePack.Taskbar

Assembly

Microsoft.WindowsAPICodePack.Shell.dll

Thumbnail toolbar manager class for adding a thumbnail toolbar with a specified set of buttons to the thumbnail image of a window in a taskbar button flyout.

public class ThumbnailToolBarManager

Inheritance

object

ThumbnailToolBarManager

Inherited Members

object.GetType()

object.MemberwiseClone()

object.ToString()

object.Equals(object)

object.Equals(object, object)

object.ReferenceEquals(object, object)

object.GetHashCode()

Methods

AddButtons(nint, params ThumbnailToolBarButton[])

Adds thumbnail toolbar for the specified window.

public void AddButtons(nint windowHandle, params ThumbnailToolBarButton[] buttons)

Parameters

windowHandle nint

Window handle for which the thumbnail toolbar buttons need to be added

buttons ThumbnailToolBarButton[]

Thumbnail buttons for the window's thumbnail toolbar

Remarks

After a toolbar has been added to a thumbnail, buttons can be altered only through various properties on the ThumbnailToolBarButton. While individual buttons cannot be added or removed, they can be shown and hidden through Visible as needed. The toolbar itself cannot be removed without re-creating the window itself.

Exceptions

ArgumentException

If the number of buttons exceed the maximum allowed capacity (7).

ArgumentException

If the Window Handle passed in invalid

AddButtons(UIElement, params ThumbnailToolBarButton[])

Adds thumbnail toolbar for the specified WPF Control.

public void AddButtons(UIElement control, params ThumbnailToolBarButton[] buttons)

Parameters

control UIElement

WPF Control for which the thumbnail toolbar buttons need to be added

buttons ThumbnailToolBarButton[]

Thumbnail buttons for the window's thumbnail toolbar

Remarks

After a toolbar has been added to a thumbnail, buttons can be altered only through various properties on the ThumbnailToolBarButton. While individual buttons cannot be added or removed, they can be shown and hidden through ThumbnailToolBarButton.Visible as needed. The toolbar itself cannot be removed without re-creating the window itself.

Exceptions

ArgumentException

If the number of buttons exceed the maximum allowed capacity (7).

ArgumentNullException

If the control passed in null