Skip to main content
A newer version of this page is available. .

TaskbarAssistant Class

Provides methods to manipulate an application taskbar button, Jump List and thumbnail preview.

Namespace: DevExpress.Utils.Taskbar

Assembly: DevExpress.Utils.v21.2.dll

NuGet Packages: DevExpress.Utils, DevExpress.Win.Design, DevExpress.Wpf.Core

Declaration

public class TaskbarAssistant :
    Component

The following members return TaskbarAssistant objects:

Remarks

Windows 7 has introduced a new look and new features for application buttons displayed within the system taskbar. The TaskbarAssistant component is designed to facilitate the customization of an application’s taskbar button, its Jump List and thumbnail preview.

The Jump List is opened on right-clicking an application taskbar button:

taskbar-JumpList

The Jump List can contain:

  • General application commands (painted against the gray background in the image above)
  • The Tasks category with custom commands.
  • Either the Frequent or Recent category (containing recently used files). The contents of these categories are managed by the Windows shell.
  • Custom categories with custom commands (see the Scheduler category in the image above).

When you hover over an application taskbar button, a live thumbnail preview is displayed. The preview window can contain a toolbar with up to seven buttons below the preview image, as in the figure below:

taskbar-Thumbnail

More information on these taskbar features can be found in MSDN at: Taskbar Extensions

The TaskbarAssistant component supports the following taskbar customization features:

Feature

Property/Properties

Add custom items to the Tasks category in the Jump List.

TaskbarAssistant.JumpListTasksCategory

Add custom categories to the Jump List.

TaskbarAssistant.JumpListCustomCategories

Enable either the Recent or Frequent category in the Jump List.

TaskbarAssistant.JumpListKnownCategoryVisibility, TaskbarAssistant.JumpListKnownCategoryPosition

Add buttons to the toolbar in the thumbnail preview.

TaskbarAssistant.ThumbnailButtons, ThumbnailButton.Click

Display a progress indicator in the taskbar button. The following progress styles are supported:

Indeterminate marquee-style:

taskbar-indeterminateprogress

Determinate Normal Style (Reflects the completed percentage of an operation):

taskbar-determinateprogress

Determinate Paused Style (The progress indicator turns yellow to show that progress is currently stopped in one of the windows but can be resumed by the user):

taskbar-determinateprogress-paused

Determinate Error Style (The progress indicator turns red to show that an error has occurred):

taskbar-determinateprogress-error

TaskbarAssistant.ProgressMode, TaskbarAssistant.ProgressCurrentValue, TaskbarAssistant.ProgressMaximumValue

Display a small overlay icon over the application icon.

taskbar-OverlayIcon

TaskbarAssistant.OverlayIcon

Use a specific area of the application window as a thumbnail.

TaskbarAssistant.ThumbnailClipRegion

Inheritance

See Also