JumpTask 类

定义

命名空间:

System.Windows.Shell

程序集:

PresentationFramework.dll

表示某应用程序在 Windows 7 任务栏跳转列表中的快捷方式。

public ref class JumpTask : System::Windows::Shell::JumpItem

public class JumpTask : System.Windows.Shell.JumpItem

type JumpTask = class
    inherit JumpItem

Public Class JumpTask
Inherits JumpItem

继承

Object

JumpItem

JumpTask

示例

以下示例演示如何在标记中声明 JumpTask 。 打开JumpTask记事本应用程序中命名readme.txt的文本文件。

<JumpTask Title="Read Me" 
          Description="Open readme.txt in Notepad." 
          ApplicationPath="C:\Windows\notepad.exe"
          IconResourcePath="C:\Windows\System32\imageres.dll"
          IconResourceIndex="14"
          WorkingDirectory="C:\Users\Public\Documents"
          Arguments="readme.txt"/>

以下示例演示如何在代码中配置 JumpTask 。 打开 JumpTask 计算器应用程序。

// Configure a new JumpTask.
JumpTask jumpTask1 = new JumpTask();
// Get the path to Calculator and set the JumpTask properties.
jumpTask1.ApplicationPath = Path.Combine(Environment.GetFolderPath(Environment.SpecialFolder.SystemX86), "calc.exe");
jumpTask1.IconResourcePath = Path.Combine(Environment.GetFolderPath(Environment.SpecialFolder.SystemX86), "calc.exe");
jumpTask1.Title = "Calculator";
jumpTask1.Description = "Open Calculator.";
jumpTask1.CustomCategory = "User Added Tasks";

注解

可以将 A JumpTask 视为应用程序的快捷方式。 通过设置 ApplicationPath 属性指定可执行文件的路径。 ApplicationPath如果未设置，则表示当前正在运行的进程的路径。 可以选择指定 Arguments 在启动时传递给应用程序。

可以设置基本显示属性，例如TitleDescription，并IconResourcePath指定跳转列表中任务的外观。 与 a JumpTask 配合使用的图标必须作为本机资源提供。 如果 DLL 或可执行文件中提供了多个图标资源，则通过指示属性中的 IconResourceIndex 偏移量来指定要使用的图标资源。

默认情况下，一个 JumpTask 将放置在跳转列表 的任务类别中 。 可以通过设置 CustomCategory 属性来指定任务的自定义分组。

可以通过创建 JumpTask 没有 Title 和 CustomCategory 指定项的项，直观地分隔跳转列表中的项。 此空 JumpTask 将显示为跳转列表中的水平线。 在这种情况下，可以设置其他属性，但它们不会有任何影响。

构造函数

JumpTask()

初始化 JumpTask 类的新实例。

属性

ApplicationPath	获取或设置应用程序的路径。
Arguments	获取或设置启动时要传递给应用程序的参数。
CustomCategory	获取或设置在Windows 7 个任务栏跳转列表中分组的类别JumpItem的名称。 (继承自 JumpItem)
Description	获取或设置针对跳转列表中的任务在工具提示中显示的文本。
IconResourceIndex	获取或设置嵌入在资源中的图标的索引，索引从零开始。
IconResourcePath	获取或设置资源的路径，该资源包含要在跳转列表中显示的图标。
Title	获取或设置针对跳转列表中的任务显示的文本。
WorkingDirectory	获取或设置启动时应用程序的工作目录。

方法

Equals(Object)	确定指定对象是否等于当前对象。 (继承自 Object)
GetHashCode()	作为默认哈希函数。 (继承自 Object)
GetType()	获取当前实例的 Type。 (继承自 Object)
MemberwiseClone()	创建当前 Object 的浅表副本。 (继承自 Object)
ToString()	返回表示当前对象的字符串。 (继承自 Object)

另请参阅

• JumpPath
• JumpList
• JumpItemsRejected
• Startup
• Args