码迷,mamicode.com
首页 > Windows程序 > 详细

C# Windows 7任务栏开发之跳转列表(Jump Lists)

时间:2015-04-28 09:45:56      阅读:245      评论:0      收藏:0      [点我收藏+]

标签:windows 7   任务栏   

      Jump Lists可以使用户方便快捷的找到想要浏览的文件(文档、图片、音频或视频等)以及应用程序的链接或快捷方式。以IE 浏览器为例看看Jump Lists 都具备哪些功能:

技术分享


      “Taskbar Tasks” 放置了应用程序的一些默认任务:“打开IE 浏览器”、“从任务栏取消固定”、“关闭程序”。无论是否对Jump Lists 做过开发,“Taskbar Tasks” 列表都会出现在所有的应用程序中。

      “User Tasks” 包含了应用程序本身提供的一些功能,通过这些链接可以直接对应用程序进行操作。例如,打开一个新IE 标签。
      “Known Category” 这个列表是Windows 7 默认类别,其中包含三种模式:“Recent”(近期浏览)、“Frequent”(经常浏览)、“Neither”。它的功能是将经常浏览的网页内容记录下来以便日后再次浏览,随着时间的流逝该列表中的网页链接会随之变化或消失。除了“Known Category” 列表外同样也以创建“Custom Category”(下文将会慢慢讲到)。
      “Pinned Category” 正如上面所讲“Frequent Category” 列表中的网页会经常变化,通过右键将网页“钉”在列表中可使其永久保存。


创建User Tasks 列表

      现在是不是也想为自己的程序添加一个JL,下面先来介绍如何创建User Tasks 列表。

1. 通过JumpList 类创建一个JL 实例。

2. 使用JumpListLink(string pathValue, string titleValue) 方法(pathValue:应用程序路径,titleValue:链接名称),可以将“记事本”、“画板”这样的Windows 应用程序,以及“网站地址”创建为User Tasks 链接。

3. 再使用AddUserTasks(params IJumpListTask[] tasks) 方法将这些链接添加到JL 中。如下代码所示:

private JumpList    _jumpList;
_jumpList = JumpList.CreateJumpListForIndividualWindow("Windows.TaskBar.WinFormJumpList", this.Handle);
/// <summary>
        /// 添加User Tasks
        /// </summary>
        private void AddUserTasks()
        {
            string systemPath = Environment.GetFolderPath(Environment.SpecialFolder.System);

            // 程序链接
            JumpListTask notepadTask = new JumpListLink(Path.Combine(systemPath, "notepad.exe"), "Notepad")
            {
                IconReference = new IconReference(Path.Combine(systemPath, "notepad.exe"), 0)
            };
            JumpListTask paintTask = new JumpListLink(Path.Combine(systemPath, "mspaint.exe"), "Paint")
            {
                IconReference = new IconReference(Path.Combine(systemPath, "mspaint.exe"), 0)
            };

            // 分割线
            JumpListTask jlSeparator = new JumpListSeparator();

            JumpListTask linkTask = new JumpListLink("http://blog.csdn.net/aoshilang2249", "langya's Blog")
            {
                IconReference = new IconReference("C:\\Program Files\\Internet Explorer\\iexplore.exe", 0)
            };

            // 添加 User Tasks
            _jumpList.AddUserTasks(notepadTask, paintTask, jlSeparator, linkTask);

            // 对JumpList 进行刷新
            _jumpList.Refresh();
        }
      在上面程序中,通过JumpListTask 接口创建了“程序链接”(JumpListLink,其中IconReference 为链接图标)和“分割线”(JumpListSeparator);使用AddUserTasks 方法时注意每个链接的位置关系;最后必须使用Refresh 方法对JL 进行刷新才能显示出最新的JL 内容。

技术分享

创建Known Category 列表

      在使用Known Category 功能前,需要先为程序注册文件类型,随后可通过KnownCategoryToDisplay 属性将Known Category 预设为“Recent”、“Frequent”、“Neither” 中的任意一种类型,当测试程序打开某个的文件时,相应的文件链接就会显示在Known Category 列表中。如下代码所示:

文件关联注册辅助类:

using System;
using System.Collections.Generic;
using System.Text;
using System.Diagnostics;
using System.IO;
using System.Windows.Forms;
using System.ComponentModel;
using Microsoft.Win32;

namespace LangYa.Net.Utils.File
{
    /// <summary>
    /// 注册文件关联的应用程序的辅助类
    /// </summary>
    public class FileAssociationsHelper
    {
        private static RegistryKey classesRoot;  // 注册表的根目录

        private static void Process(string[] args)
        {
            if (args.Length < 6)
            {
                string error = ("Usage: <ProgId> <Register in HKCU: true|false> <AppId> <OpenWithSwitch> <Unregister: true|false> <Ext1> [Ext2 [Ext3] ...]");
                throw new ArgumentException(error);
            }

            try
            {
                string  progId         = args[0];
                bool    registerInHKCU = bool.Parse(args[1]);
                string  appId          = args[2];
                string  openWith       = args[3];
                bool    unregister     = bool.Parse(args[4]);

                List<string> argList = new List<string>();
                for (int i = 5; i < args.Length; i++)
                {
                    argList.Add(args[i]);
                }
                string[] associationsToRegister = argList.ToArray(); // 文件列表

                if (registerInHKCU)
                {
                    classesRoot = Registry.CurrentUser.OpenSubKey(@"Software\Classes");
                }
                else
                {
                    classesRoot = Registry.ClassesRoot;
                }

                // 注销
                Array.ForEach(associationsToRegister, assoc => UnregisterFileAssociation(progId, assoc));
                UnregisterProgId(progId);

                // 注册
                if (!unregister)
                {
                    RegisterProgId(progId, appId, openWith);
                    Array.ForEach(associationsToRegister, assoc => RegisterFileAssociation(progId, assoc));
                }
            }
            catch (Exception e)
            {
               
            }
        }

        /// <summary>
        /// 注册类标识符
        /// </summary>
        /// <param name="progId">类标识符</param>
        /// <param name="appId">应用程序Id</param>
        /// <param name="openWith">打开文件的进程全路径</param>
        private static void RegisterProgId(string progId, string appId, string openWith)
        {
            RegistryKey progIdKey = classesRoot.CreateSubKey(progId);
            progIdKey.SetValue("FriendlyTypeName", "@shell32.dll,-8975");
            progIdKey.SetValue("DefaultIcon", "@shell32.dll,-47");
            progIdKey.SetValue("CurVer", progId);
            progIdKey.SetValue("AppUserModelID", appId);

            RegistryKey shell = progIdKey.CreateSubKey("shell");
            shell.SetValue(String.Empty, "Open");
            shell = shell.CreateSubKey("Open");
            shell = shell.CreateSubKey("Command");
            shell.SetValue(String.Empty, openWith + " %1"); // " %1"表示将被双击的文件的路径传给目标应用程序 

            shell.Close();
            progIdKey.Close();
        }

        /// <summary>
        /// 注销类标识符
        /// </summary>
        /// <param name="progId">类标识符</param>
        private static void UnregisterProgId(string progId)
        {
            try
            {
                classesRoot.DeleteSubKeyTree(progId);
            }
            catch { }
        }

        /// <summary>
        /// 注册文件关联
        /// </summary>
        private static void RegisterFileAssociation(string progId, string extension)
        {
            RegistryKey openWithKey = classesRoot.CreateSubKey(Path.Combine(extension, "OpenWithProgIds"));
            openWithKey.SetValue(progId, String.Empty);
            openWithKey.Close();
        }

        /// <summary>
        /// 注销文件关联
        /// </summary>
        private static void UnregisterFileAssociation(string progId, string extension)
        {
            try
            {
                RegistryKey openWithKey = classesRoot.CreateSubKey(Path.Combine(extension, "OpenWithProgIds"));
                openWithKey.DeleteValue(progId);
                openWithKey.Close();
            }
            catch (Exception e)
            {
                
            }
        }

        /// <summary>
        /// 类标识符注册操作
        /// </summary>
        /// <param name="unregister">注册或注销</param>
        /// <param name="progId">类标识符</param>
        /// <param name="registerInHKCU">是否在HKCU中注册文件关联 -- false</param>
        /// <param name="appId">应用程序Id</param>
        /// <param name="openWith">打开文件的进程全路径</param>
        /// <param name="extensions">文件关联列表</param>
        private static void InternalRegisterFileAssociations(bool unregister, 
                                                             string progId, bool registerInHKCU,string appId, string openWith, 
                                                             string[] extensions)
        {
            string Arguments = string.Format("{0} {1} {2} \"{3}\" {4} {5}",
                                              progId, // 0
                                              registerInHKCU, // 1 
                                              appId, // 2
                                              openWith,
                                              unregister,
                                              string.Join(" ", extensions));
            try
            {
                Process(Arguments.Split(' '));
            }
            catch (Win32Exception e)
            {
                if (e.NativeErrorCode == 1223) // 1223:用户操作被取消。
                {
                    // 该操作已经被用户取消
                }
            }
        }

        /// <summary>
        /// 判断类标识符是否注册
        /// </summary>
        /// <param name="progId">类标识符</param>
        /// <returns>注册了返回true</returns>
        public static bool IsApplicationRegistered(string progId)
        {
            return (Registry.ClassesRoot.OpenSubKey(progId) != null);
        }

        /// <summary>
        /// 注册类标识符的文件关联
        /// </summary>
        /// <param name="progId">类标识符</param>
        /// <param name="registerInHKCU">是否在HKCU中注册文件关联 -- false
        /// <param name="appId">应用程序Id</param>
        /// <param name="openWith">打开文件的进程全路径</param>
        /// <param name="extensions">文件关联列表</param>
        public static void RegisterFileAssociations(string progId,bool registerInHKCU, string appId, string openWith,
                                                    params string[] extensions)
        {
            InternalRegisterFileAssociations(false, progId, registerInHKCU, appId, openWith, extensions);
        }

        /// <summary>
        /// 注销类标识符的文件关联
        /// </summary>
        /// <param name="progId">类标识符</param>
        /// <param name="registerInHKCU">是否在HKCU中注册文件关联 -- false
        /// <param name="appId">应用程序Id</param>
        /// <param name="openWith">打开文件的进程全路径</param>
        /// <param name="extensions">文件关联列表</param>
        public static void UnregisterFileAssociations(string progId, bool registerInHKCU, string appId, string openWith,
                                                      params string[] extensions)
        {
            InternalRegisterFileAssociations(true, progId, registerInHKCU, appId, openWith, extensions);
        }
    }
}
/// <summary>
/// 添加Known Tasks
/// </summary>
private void AddKnownTasks(JumpListKnownCategoryType knowsType, int knownCategoryOrdinalPosition)
{
    _jumpList.KnownCategoryToDisplay        = knowsType;
    _jumpList.KnownCategoryOrdinalPosition  = knownCategoryOrdinalPosition; // 相对于Custom的位置

    if (!FileAssociationsHelper.IsApplicationRegistered(TaskbarManager.Instance.ApplicationId))
    {
        FileAssociationsHelper.RegisterFileAssociations(TaskbarManager.Instance.ApplicationId,
                                                    false,
                                                    TaskbarManager.Instance.ApplicationId,
                                                    Assembly.GetExecutingAssembly().Location,
                                                    ".jpg", ".png", ".gif", ".JPG", ".PNG", ".GIF");
    }

    _jumpList.Refresh();
}

为了文件正常打开,还需要修改Main方法,让衔接的路径可以传入应用程序,以便打开应用程序关联的文件:

/// <summary>
/// 应用程序的主入口点。
/// </summary>
[STAThread]
static void Main(string[] args)
{
    string filePath = "";
    if ((args != null) && (args.Length > 0))
    {
        for (int i = 0; i < args.Length; i++)
        {
            // 对于路径中间带空格的会自动分割成多个参数传入
            filePath += " " + args[i];
        }

        filePath.Trim();
    }

    Application.EnableVisualStyles();
    Application.SetCompatibleTextRenderingDefault(false);
    Application.Run(new Main() { FilePath = filePath });
}
/// <summary>
/// 应用程序文件
/// </summary>
public string FilePath
{
    get { return (_strFilePath); }
    set
    {
        _strFilePath = value;
        if (!string.IsNullOrEmpty(_strFilePath))
        {
            _pictureBox.ImageLocation = _strFilePath;
        }
    }
}

技术分享

创建Custom Category 列表

      如同上文创建JumpList 的方式:

1. 通过JumpListCustomCategory 类创建“自定义分类”列表实例。

2. 由JumpListCustomCategory(string categoryName) 方法为列表命名。

3. 使用AddJumpListItems 方法将链接加入到分类中。如下代码所示:

/// <summary>
/// 添加Custom Tasks
/// </summary>
private void AddCustomTasks(string categoryName)
{
    if (categoryName.Length > 0)
    {
        JumpListCustomCategory customCategory = new JumpListCustomCategory(categoryName);
        _jumpList.AddCustomCategories(customCategory);

        // Arguments需要打开的文件类型的参数(如文件路径等)
        JumpListLink jlItem = new JumpListLink(Assembly.GetExecutingAssembly().Location, "Chrysanthemum.jpg")
        {
            IconReference = new IconReference(Assembly.GetEntryAssembly().Location, 0),
            Arguments = @"C:\Users\Public\Pictures\Sample Pictures\Chrysanthemum.jpg"
        };

        customCategory.AddJumpListItems(jlItem);
        _jumpList.Refresh();
    }
}
技术分享



C# Windows 7任务栏开发之跳转列表(Jump Lists)

标签:windows 7   任务栏   

原文地址:http://blog.csdn.net/aoshilang2249/article/details/45330595

(0)
(0)
   
举报
评论 一句话评论(0
登录后才能评论!
© 2014 mamicode.com 版权所有  联系我们:gaon5@hotmail.com
迷上了代码!