ComponentOne Windows 7 Control Pack for WinForms
Working with Windows 7 Control Pack for WinForms / Working with C1TaskbarButton / Jump List Elements / C1JumpPath Basics
In This Topic
    C1JumpPath Basics
    In This Topic

    A jump path, represented by the C1JumpLink class and inheriting from the C1JumpItem class, is reference to a file that can be accessed and opened from the taskbar's jump list.

    C1JumpPaths can be linked to any type of file; the only requirement is that your project be registered to handle the file type. To register the file type, use the C1TaskbarButton's RegisterFileAssociations method, which takes two overloads. The following method registers a .png file and commands the link to open Paint.NET to display the file:

    To write code in Visual Basic

    Visual Basic
    Copy Code
    C1TaskbarButton1.JumpList.Apply()
    

    To write code in C#

    C#
    Copy Code
    c1TaskbarButton1.JumpList.Apply();
    

    C1JumpPath has two settable properties: Path and CustomCategory. Path simply sets the location of the file, and CustomCategory specifies the category the jump path will appear in on the jump list. If the CustomCategory property is not set, the paths will just appear in the Recent or Frequently Used categories.

    By default, the C1JumpPaths icon will be the Windows default icon for that type of file, but you can change that by specifying an icon in the RegisterFileAssociations method's defaultIcon string. The title of the C1JumpPath will be the same as the filename.