(C#)WindowsShell外壳编程系列7-ContextMenu注册文件右键菜单

OStack程序员社区-中国程序员成长平台 › 门户 › 编程› c#›C#教程

原作者: [db:作者] 来自: [db:来源] 收藏邀请

（本系列文章由柠檬的(lc_mtt)原创，转载请注明出处，谢谢～）

从本节起，我所要讲述的是对 Windows 系统的“Shell 扩展”。“Shell 扩展”从字面上分两个部分：Shell 与 Extension。Shell 指 Windows Explorer，而Extension 则指由你编写的当某一预先约定好的事件（如在以. doc 为后缀的文件图标上单击右键）发生时由 Explorer 调用执行的代码。因此一个“Shell 扩展”就是一个为 Explorer 添加功能的 COM 对象。

“Shell 扩展”有很多种类型，每种类型都在各自不同的事件发生时被调用运行，但也有一些扩展的类型和调用情形是非常相似的。

类型	何时被调用	应该作些什么
Context menu 扩展处理器	用户右键单击文件或文件夹对象时，或在一个文件夹窗口中的背景处单击右键时（要求shell版本为4.71+）	添加菜单项到上下文菜单中
Property sheet 扩展处理器	要显示一个文件对象的属性框时	添加定制属性页到属性表中
Drag and drop 扩展处理器	用户用右键拖放文件对象到文件夹窗口或桌面时	添加菜单项到上下文菜单中
Drop 扩展处理器	用户拖动Shell对象并将它放到一个文件对象上时	任何想要的操作
QueryInfo扩展处理器 (需要shell版本 4.71+)	用户将鼠标盘旋于文件或其他Shell对象的图标上时	返回一个浏览器用于显示在提示框中的字符串

现在你可能想知道“Shell 扩展”到底是什么样的，不过我还是乐意把我后面所实现的技术效果直接展示出来。以下三副图片分别代表了三种“Shell 扩展”：

（1）实现类似 WinRAR 的右键菜单

（2）根据文本大小，显示不同的 TXT 文件图标

（3）当鼠标移动到 TXT 文件图标上的时候，显示内容预览。

好，废话不多说了，赶紧进入今天要讲述的内容： ContextMenu 注册文件右键菜单。

对于 WinRAR 所实现的效果，其实叫做上下文菜单。例如我们把扩展关联到 .TXT 文件，当用户右键单击文本文件对象时扩展就会被调用，然后向系统菜单增加菜单项，并响应相应的命令。由此可见，基本上每种 Shell 扩展，都需要做一些几乎一样的事情。

初始化接口
当我们的shell扩展被加载时，Explorer 将调用我们所实现的COM对象的 QueryInterface() 函数以取得一个 IShellExtInit 接口指针。该接口仅有一个方法 Initialize()，其函数原型为：

IShellExtInit
{
[PreserveSig()]
int Initialize(IntPtr pidlFolder, IntPtr lpdobj, uint hKeyProgID);
}

Explorer 使用该方法传递给我们各种各样的信息.
pidlFolder 是用户所选择操作的文件所在的文件夹的 PIDL 变量. (一个 PIDL [指向ID 列表的指针] 是一个数据结构，它唯一地标识了在Shell命名空间的任何对象, 一个Shell命名空间中的对象可以是也可以不是真实的文件系统中的对象。)
lpdobj 是一个 IDataObject 接口指针，通过它我们可以获取用户所选择操作的文件名。
hKeyProgID 是一个HKEY 注册表键变量，可以用它获取我们的DLL的注册数据。

因此我们可以在这个方法中，获取到被右击选择的一个或多个文件/文件夹名。

hKeyProgID)
{
    try
    {
        m_dataObject = null;
        if (lpdobj != (IntPtr)0)
        {
            m_dataObject = (ShellLib.IDataObject)Marshal.GetObjectForIUnknown(lpdobj);
            FORMATETC fmt = new FORMATETC();
            fmt.cfFormat = CLIPFORMAT.CF_HDROP;
            fmt.ptd = 0;
            fmt.dwAspect = DVASPECT.DVASPECT_CONTENT;
            fmt.lindex = -1;
            fmt.tymed = TYMED.TYMED_HGLOBAL;
            STGMEDIUM medium = new STGMEDIUM();
            m_dataObject.GetData(ref fmt, ref medium);
            m_hDrop = medium.hGlobal;
        }
    }
    catch (Exception)
    {
    }
    return S_OK;
}

IDataObject 是一个接口，包含了一些获取文件名的方法，后面可以用到。

与上下文菜单交互的接口

一旦 Explorer 初始化了扩展,它就会接着调用 IContextMenu 的方法让我们添加菜单项, 提供状态栏上的提示, 并响应执行用户的选择。IContextMenu 接口定义了以下几个方法：

IContextMenu
{
    [PreserveSig()]
    int QueryContextMenu(HMenu hmenu, uint iMenu, uint idCmdFirst, uint idCmdLast, CMF uFlags);
    [PreserveSig()]
    void InvokeCommand(IntPtr pici);
    [PreserveSig()]
    void GetCommandString(uint idcmd, GCS uflags, uint reserved, IntPtr commandstring, int cchMax);
}

第一个是 QueryContextMenu(), 它让我们可以修改上下文菜单。其参数：

hmenu 上下文菜单句柄。
uMenuIndex 是我们应该添加菜单项的起始位置。
uidFirstCmd 和 uidLastCmd 是我们可以使用的菜单命令ID值的范围。
uFlags 标识了Explorer 调用 QueryContextMenu() 的原因。

我们调用该方法，为上下文菜单增加几个菜单项：

idCmdLast, CMF uFlags)
{
    int id = 0;
    if ((uFlags & (CMF.CMF_VERBSONLY | CMF.CMF_DEFAULTONLY | CMF.CMF_NOVERBS)) == 0 ||
        (uFlags & CMF.CMF_EXPLORE) != 0)
    {
        //创建子菜单
        HMenu submenu = ShellLib.Helpers.CreatePopupMenu();
        Helpers.AppendMenu(submenu, MFMENU.MF_STRING, new IntPtr(idCmdFirst + id++), "复制路径(&C)");
        Helpers.AppendMenu(submenu, MFMENU.MF_STRING, new IntPtr(idCmdFirst + id++), "复制文本内容(&T)");
        Helpers.AppendMenu(submenu, MFMENU.MF_STRING, new IntPtr(idCmdFirst + id++), "柠檬的博客(&L)");

        //将子菜单插入到上下文菜单中
        Helpers.InsertMenu(hMenu, 1, MFMENU.MF_BYPOSITION | MFMENU.MF_POPUP, submenu.handle, "MyContextMenu(&Y)");

        //为菜单增加图标
        Bitmap bpCopy = Resource1.copy;
        Helpers.SetMenuItemBitmaps(submenu, 0, MFMENU.MF_BYPOSITION, bpCopy.GetHbitmap(), bpCopy.GetHbitmap());
        Helpers.SetMenuItemBitmaps(submenu, 1, MFMENU.MF_BYPOSITION, bpCopy.GetHbitmap(), bpCopy.GetHbitmap());
        Bitmap bpHome = Resource1.home;
        Helpers.SetMenuItemBitmaps(submenu, 2, MFMENU.MF_BYPOSITION, bpHome.GetHbitmap(), bpHome.GetHbitmap());
    }
    return id;
}

在状态栏上显示提示帮助

下一个要被调用的IContextMenu 方法是 GetCommandString().。如果用户是在浏览器窗口中右击文本文件，或选中一个文本文件后单击文件菜单时,状态栏会显示提示帮助。我们的 GetCommandString() 函数将返回一个帮助字符串供浏览器显示。

cchMax)
{
    string tip = "";

    switch (uflags)
    {
        case GCS.VERB:
            break;
        case GCS.HELPTEXTW:
            switch (idcmd)
            {
                case 0:
                    tip = "把选中的文件/文件夹的全路径复制到剪切板";
                    break;
                case 1:
                    tip = "把选中的 TXT 文本内容复制到剪切板";
                    break;
                case 2:
                    tip = "访问柠檬的博客 http://lemony.cnblogs.com";
                    break;
                default:
                    break;
            }
            if (!string.IsNullOrEmpty(tip))
            {
                byte[] data = new byte[cchMax * 2];
                Encoding.Unicode.GetBytes(tip, 0, tip.Length, data, 0);
                Marshal.Copy(data, 0, commandstring, data.Length);
            }
            break;
    }
}

执行用户的选择

IContextMenu 接口的最后一个方法是 InvokeCommand()。当用户点击我们添加的菜单项时该方法将被调用。其参数：

CMINVOKECOMMANDINFO 结构带有大量的信息, 但我们只关心 lpVerb 和 hwnd 这两个成员。
lpVerb参数有两个作用 – 它或是可被激发的verb(动作)名, 或是被点击的菜单项的索引值。

hwnd 是用户激活我们的菜单扩展时所在的浏览器窗口的句柄。

我们可以根据被点击的菜单项索引，来执行相应的操作。

IContextMenu.InvokeCommand(IntPtr pici)
{
    INVOKECOMMANDINFO ici = (INVOKECOMMANDINFO)Marshal.PtrToStructure(pici, typeof(ShellLib.INVOKECOMMANDINFO));
    StringBuilder sb = new StringBuilder(1024);
    StringBuilder sbAll = new StringBuilder();
    uint nselected;

    switch (ici.verb)
    {
        case 0:
            //复制文件名
            nselected = Helpers.DragQueryFile(m_hDrop, 0xffffffff, null, 0);
            for (uint i = 0; i < nselected; i++)
            {
                ShellLib.Helpers.DragQueryFile(m_hDrop, i, sb, sb.Capacity + 1);
                sbAll.Append(sb.ToString() + "\n");
            }
            Clipboard.Clear();
            Clipboard.SetDataObject(sbAll.ToString(), true);
            break;
        case 1:
            //复制文件内容
            nselected = Helpers.DragQueryFile(m_hDrop, 0xffffffff, null, 0);
            for (uint i = 0; i < nselected; i++)
            {
                ShellLib.Helpers.DragQueryFile(m_hDrop, i, sb, sb.Capacity + 1);
                StreamReader sr = new StreamReader(sb.ToString(), Encoding.GetEncoding("gb2312"));
                sbAll.Append(sr.ReadToEnd());
                sr.Close();
            }
            Clipboard.Clear();
            Clipboard.SetDataObject(sbAll.ToString(), true);
            break;
        case 2:
            //调用浏览器，打开网页
            Process proc = new Process();
            proc.StartInfo.FileName = "IExplore.exe";
            proc.StartInfo.Arguments = "http://lemony.cnblogs.com";
            proc.Start();
            break;
        default:
            break;
    }
}

注册Shell扩展
现在我们已经实现了所有需要的COM接口. 可是我们怎样才能让浏览器使用我们的扩展呢？首先，我们要注册动态库。但仅仅这样是不够的，为了告诉浏览器使用我们的扩展, 我们需要在文本文件类型的注册表键下注册扩展。

(请原谅我未能抽出时间对注册扩展做详细的说明（如果以后有机会会补上），大家可以自行研究)

RegisterServer(String str1)
{
    try
    {
        //注册 DLL
        RegistryKey root;
        RegistryKey rk;
        root = Registry.LocalMachine;
        rk = root.OpenSubKey("Software\\Microsoft\\Windows\\CurrentVersion\\Shell Extensions\\Approved", true);
        rk.SetValue(GUID, KEYNAME);
        rk.Close();
        root.Close();

        //注册文件
        RegTXT();
    }
    catch{
    }
}

[System.Runtime.InteropServices.ComUnregisterFunctionAttribute()]
static void UnregisterServer(String str1)
{
    try
    {
        //注销动态库
        RegistryKey root;
        RegistryKey rk;
        root = Registry.LocalMachine;
        rk = root.OpenSubKey("Software\\Microsoft\\Windows\\CurrentVersion\\Shell Extensions\\Approved", true);
        rk.DeleteValue(GUID);
        rk.Close();
        root.Close();

        //注销文件
        UnRegTXT();
    }
    catch
    {
    }
}

private static void RegTXT()
{
    RegistryKey root;
    RegistryKey rk;

    root = Registry.ClassesRoot;
    rk = root.OpenSubKey(".txt");
    string txtclass = (string)rk.GetValue("");
    if (string.IsNullOrEmpty(txtclass))
    {
        txtclass = "TXT";
        rk.SetValue("", txtclass);

    }
    rk.Close();

    rk = root.CreateSubKey(txtclass + "\\shellex\\ContextMenuHandlers\\" + KEYNAME);
    rk.SetValue("", GUID);
    rk.Close();

    rk = root.CreateSubKey(txtclass + "\\shellex\\IconHandler");
    rk.SetValue("", GUID);
    rk.Close();

    rk = root.CreateSubKey(txtclass + "\\shellex\\{00021500-0000-0000-C000-000000000046}");
    rk.SetValue("", GUID);
    rk.Close();
}

private static void UnRegTXT()
{
    RegistryKey root;
    RegistryKey rk;

    root = Registry.ClassesRoot;
    rk = root.OpenSubKey(".txt");
    rk.Close();
    string txtclass = (string)rk.GetValue("");
    if (!string.IsNullOrEmpty(txtclass))
    {
        root.DeleteSubKey(txtclass + "\\shellex\\ContextMenuHandlers\\" + KEYNAME);
        root.DeleteSubKey(txtclass + "\\shellex\\IconHandler");
        root.DeleteSubKey(txtclass + "\\shellex\\{00021500-0000-0000-C000-000000000046}");
    }
}

注册动态库

.NET 开发的动态库有些特别，需要在 .NET SDK 中注册

regasm MyContextMenu.dll /CodeBase
反注册则是：regasm /unregister MyContextMenu.dll /CodeBase

代码：https://files.cnblogs.com/lemony/MyContextMenu.rar

关于代码：代码里面还包括了图标扩展和提示扩展的代码，如果有兴趣，可自行阅读。

题外话：还有相当多的关于 Shell 扩展的内容无法一一说明，如果有机会，以后会尽量补上。或大家查阅网上的“Windows Shell扩展编程完全指南”（虽然是VC版的，但内容相当丰富）

鲜花

握手

雷人

路过

鸡蛋

该文章已有0人参与评论

请发表评论

全部评论

专题导读

More+

10-27 六六分期app的软件客服如何联系？(六六分期

11-06 可心卡盟:win10系统火狐flash插件崩溃怎么

11-06 亲亲特价:怎么删除回收站图标

11-06 济南大学虚拟社区:鲁大师节能降温的具体办

11-06 xlueops.exe:无线网络安装向导

11-06 女斗合众国:win7系统cf与主机连接不稳定怎

11-06 0xc000022-[cf烟雾头]cf怎么调烟雾头

11-06 qizideyouhuo:应用程序无法正常启动0xc0000

11-06 ipz-185:win7系统vcf文件怎么打开

11-06 傻哥蹦迪:win10系统s4怎么打开usb调试

11-06 八神浩树gtaste:回收站清空了怎么恢复

11-06 妖尾之黑色守护:win10系统电脑没有1440x900

11-06 校园至尊魔王小说:win7系统浏览网页时字体

11-06 女斗合众国:win10系统访问共享文件夹提示请

11-06 tokyo hot n0654:恢复win7系统默认字体一招

11-06 雨酷仙境:设置win7系统转移临时文件夹腾出

11-06 阿穆纳伊之杖:win7系统开始菜单在右边还原

11-06 tunespotting:win10系统火狐flash插件总是

11-06 甘尔葛分析师：计谋网站seo关键词暴涨有什

11-06 蔡贵霖: 计谋网站seo关键词暴涨有什么秘密

11-06 博益网首页:ao3网页版进入不了解决方法

11-06 漏斗子专栏: 网站数据分析小白易懂精华篇

11-06 见证双虹怎么做:win7系统开启telnet命令的

11-06 颾狐蝶蜋:系统资源不足无法完成请求的服务

11-06 国光中学校歌:提交网站到alexa查询详细步骤

11-06 西安有情天:静态网页和动态网页的区别

11-06 红木雅尚斋:外部链接构造对网站的好处

11-06 前官礼遇：防止域名劫持–增强域安全性的10

11-06 密传二转答案: 中文分词算法有哪些

11-06 金泉家园邮编:百度快照劫持的表现及应对方

C#学习14（VS2017查看解决方案中项目类图）发布时间：2022-07-10

WinRAR(WinZip)压缩与解压实现（C#版Window平台）发布时间：2022-07-10

剪的笔顺,诠释剪的笔画,认识剪的部首

1 六六分期app的软件客服如何联系？(六六分期

六六分期app的软件客服如何联系？不知道吗？加qq群【895510560】即可！标题：六六分期

阅读：19131|2023-10-27

2 可心卡盟:win10系统火狐flash插件崩溃怎么

今天小编告诉大家如何处理win10系统火狐flash插件总是崩溃的问题，可能很多用户都不知

阅读：9973|2022-11-06

3 亲亲特价:怎么删除回收站图标

今天小编告诉大家如何对win10系统删除桌面回收站图标进行设置，可能很多用户都不知道

阅读：8317|2022-11-06

4 济南大学虚拟社区:鲁大师节能降温的具体办

今天小编告诉大家如何对win10系统电脑设置节能降温的设置方法，想必大家都遇到过需要

阅读：8686|2022-11-06

5 xlueops.exe:无线网络安装向导

我们在使用xp系统的过程中,经常需要对xp系统无线网络安装向导设置进行设置，可能很多

阅读：8627|2022-11-06

6 女斗合众国:win7系统cf与主机连接不稳定怎

今天小编告诉大家如何处理win7系统玩cf老是与主机连接不稳定的问题，可能很多用户都不

阅读：9643|2022-11-06

7 0xc000022-[cf烟雾头]cf怎么调烟雾头

电脑对日常生活的重要性小编就不多说了，可是一旦碰到win7系统设置cf烟雾头的问题，很

阅读：8611|2022-11-06

8 qizideyouhuo:应用程序无法正常启动0xc0000

我们在日常使用电脑的时候，有的小伙伴们可能在打开应用的时候会遇见提示应用程序无法

阅读：7991|2022-11-06

9 ipz-185:win7系统vcf文件怎么打开

今天小编告诉大家如何对win7系统打开vcf文件进行设置，可能很多用户都不知道怎么对win

阅读：8642|2022-11-06

10 傻哥蹦迪:win10系统s4怎么打开usb调试

今天小编告诉大家如何对win10系统s4开启USB调试模式进行设置，可能很多用户都不知道怎

阅读：7527|2022-11-06

客服电话

电子邮件

(C#)WindowsShell外壳编程系列7-ContextMenu注册文件右键菜单

请发表评论

全部评论

上一篇：

下一篇：

theindianappguy/machine_learning_flutter

samaxes/minify-maven-plugin: Combine and

挨打的读音是什么？是āi dǎ还是ái dǎ？

【小程序】小程序的循环遍历

nacika-ins/nanachibot: nanachibot is Rus

剪的笔顺,诠释剪的笔画,认识剪的部首

六六分期app的软件客服如何联系？(六六分期

florent37/ViewAnimator: A fluent Android

florent37/Shrine-MaterialDesign2: implem

CVE-2020-36276

SimpleSoftwareIO/simple-sms: Send and re

关于我们

产品与服务

解决方案

139-2527-9053