Skip to main content

DevExpress v24.2 Update — Your Feedback Matters

Our What's New in v24.2 webpage includes product-specific surveys. Your response to our survey questions will help us measure product satisfaction for features released in this major update and help us refine our plans for our next major release.

Take the survey Not interested

JumpListItemTask Class

Represents a task in a Jump List.

Namespace: DevExpress.Utils.Taskbar

Assembly: DevExpress.Utils.v24.2.dll

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

#Declaration

public class JumpListItemTask :
    Component,
    IJumpListItem,
    ISupportJumpListItemClick,
    ICloneable,
    ISupportCommandBinding

#Remarks

A Jump List task is represented by the JumpListItemTask class. Tasks can either be shortcuts to existing programs/documents/folders or they can invoke custom actions.

taskbar-JumpList

For a JumpListItemTask object, you can specify a file or folder to be launched on clicking on a task. Use the JumpListItemTask.Path property to do this. Command line arguments and the working folder can be specified using the JumpListItemTask.Arguments and JumpListItemTask.WorkingDirectory properties, respectively.

To perform custom actions on clicking on a task, handle the JumpListItemTask.Click event.

If the JumpListItemTask.Path property refers to a valid file/folder, the icon of this file/folder is by default, displayed by the task. Otherwise, no icon is displayed. To provide a custom icon, use the JumpListItemTask.IconIndex property.

To specify a caption for a task, use the JumpListItemTask.Caption property. The JumpListItemTask.Description property allows you to provide the text for the tooltip shown when the mouse pointer is positioned over the current task in the Jump List.

Tasks in the Jump List are always grouped into categories. There is always a predefined Tasks category in the Jump List. The name of this category cannot be changed. To access the Tasks category and add individual tasks to it, use the TaskbarAssistant.JumpListTasksCategory property. It is possible to separate tasks in this category with the JumpListItemSeparator.

JumpList_JumpListEditor_TasksCategory

If required, you can add custom categories with custom tasks to the Jump List. Use the TaskbarAssistant.JumpListCustomCategories property to do this.

JumpList_JumpListEditor_CustomCategories

#Implements

#Inheritance

See Also