小编典典

如何开始开发 Internet Explorer 扩展?

all

这里有没有人有开发可以分享他们知识的 IE 扩展的经验?这将包括代码示例,或指向好的链接,或有关过程的文档,或任何东西。

我真的很想这样做,但是我遇到了糟糕的文档,糟糕的代码/示例代码/缺乏的巨大墙壁。您可以提供的任何帮助/资源将不胜感激。

具体来说,我想从如何从 IE 扩展中访问/操作 DOM 开始。

编辑,更多细节:

理想情况下,我想种植一个工具栏按钮,单击该按钮时会弹出一个菜单,其中包含指向外部站点的链接。我还想根据某些条件访问 DOM 并在页面上植入
JavaScript。

在 IE 扩展中保存信息的最佳方式是什么?在 Firefox/Chrome/大多数现代浏览器中,您使用window.localStorage,但显然对于
IE8/IE7,这不是一个选项。也许是 SQLite DB 之类的?可以假设 .NET 4.0 将安装在用户的计算机上吗?

我不想使用 Spice IE,因为我想构建一个与 IE9 兼容的产品。我也在这个问题中添加了 C 标签,因为如果用 C
构建一个标签会更好,我可以这样做。


阅读 162

收藏
2022-06-27

共1个答案

小编典典

[更新] 我正在更新此答案以在 Windows 10 x64*Visual Studio 2017 Community中与
Internet Explorer 11 一起使用。此答案的先前版本(适用于 Internet Explorer 8,在 Windows 7 x64
和 Visual Studio 2010 中)位于此答案的底部。
***

创建有效的 Internet Explorer 11 加载项

我正在使用 Visual Studio 2017 CommunityC#.Net Framework 4.6.1
,因此其中一些步骤对您来说可能略有不同。

您需要以 管理员身份打开 Visual Studio 来构建解决方案,以便构建后脚本可以注册 BHO(需要注册表访问权限)。

首先创建一个类库。我打电话给我的 InternetExplorerExtension

将这些引用添加到项目中:

  • Interop.SHDocVw:COM 选项卡/搜索"Microsoft Internet Controls"
  • Microsoft.mshtml:程序集选项卡/搜索"Microsoft.mshtml"

注意: 不知何故,MSHTML 没有在我的系统中注册,即使我可以在“添加引用”窗口中找到。这在构建时导致错误:

找不到类型库“MSHTML”的包装程序集

可以在http://techninotes.blogspot.com/2016/08/fixing-cannot-find-wrapper-
assembly-for.html找到修复程序 或者,您可以运行此批处理脚本:

"%ProgramFiles(x86)%\Microsoft Visual Studio\2017\Community\Common7\Tools\VsDevCmd.bat"
cd "%ProgramFiles(x86)%\Microsoft Visual Studio\2017\Community\Common7\IDE\PublicAssemblies"
regasm Microsoft.mshtml.dll
gacutil /i Microsoft.mshtml.dll

创建以下文件:

IEAddon.cs

using System;
using System.Collections.Generic;
using System.Runtime.InteropServices;
using System.Windows.Forms;
using Microsoft.Win32;
using mshtml;
using SHDocVw;

namespace InternetExplorerExtension
{
    [ComVisible(true)]
    [ClassInterface(ClassInterfaceType.None)]
    [Guid("D40C654D-7C51-4EB3-95B2-1E23905C2A2D")]
    [ProgId("MyBHO.WordHighlighter")]
    public class WordHighlighterBHO : IObjectWithSite, IOleCommandTarget
    {
        const string DefaultTextToHighlight = "browser";

        IWebBrowser2 browser;
        private object site;

        #region Highlight Text
        void OnDocumentComplete(object pDisp, ref object URL)
        {
            try
            {
                // @Eric Stob: Thanks for this hint!
                // This was used to prevent this method being executed more than once in IE8... but now it seems to not work anymore.
                //if (pDisp != this.site)
                //    return;

                var document2 = browser.Document as IHTMLDocument2;
                var document3 = browser.Document as IHTMLDocument3;

                var window = document2.parentWindow;
                window.execScript(@"function FncAddedByAddon() { alert('Message added by addon.'); }");

                Queue<IHTMLDOMNode> queue = new Queue<IHTMLDOMNode>();
                foreach (IHTMLDOMNode eachChild in document3.childNodes)
                    queue.Enqueue(eachChild);

                while (queue.Count > 0)
                {
                    // replacing desired text with a highlighted version of it
                    var domNode = queue.Dequeue();

                    var textNode = domNode as IHTMLDOMTextNode;
                    if (textNode != null)
                    {
                        if (textNode.data.Contains(TextToHighlight))
                        {
                            var newText = textNode.data.Replace(TextToHighlight, "<span style='background-color: yellow; cursor: hand;' onclick='javascript:FncAddedByAddon()' title='Click to open script based alert window.'>" + TextToHighlight + "</span>");
                            var newNode = document2.createElement("span");
                            newNode.innerHTML = newText;
                            domNode.replaceNode((IHTMLDOMNode)newNode);
                        }
                    }
                    else
                    {
                        // adding children to collection
                        var x = (IHTMLDOMChildrenCollection)(domNode.childNodes);
                        foreach (IHTMLDOMNode eachChild in x)
                        {
                            if (eachChild is mshtml.IHTMLScriptElement)
                                continue;
                            if (eachChild is mshtml.IHTMLStyleElement)
                                continue;

                            queue.Enqueue(eachChild);
                        }
                    }
                }
            }
            catch (Exception ex)
            {
                MessageBox.Show(ex.Message);
            }
        }
        #endregion
        #region Load and Save Data
        static string TextToHighlight = DefaultTextToHighlight;
        public static string RegData = "Software\\MyIEExtension";

        [DllImport("ieframe.dll")]
        public static extern int IEGetWriteableHKCU(ref IntPtr phKey);

        private static void SaveOptions()
        {
            // In IE 7,8,9,(desktop)10 tabs run in Protected Mode
            // which prohibits writes to HKLM, HKCU.
            // Must ask IE for "Writable" registry section pointer
            // which will be something like HKU/S-1-7***/Software/AppDataLow/
            // In "metro" IE 10 mode, tabs run in "Enhanced Protected Mode"
            // where BHOs are not allowed to run, except in edge cases.
            // see http://blogs.msdn.com/b/ieinternals/archive/2012/03/23/understanding-ie10-enhanced-protected-mode-network-security-addons-cookies-metro-desktop.aspx
            IntPtr phKey = new IntPtr();
            var answer = IEGetWriteableHKCU(ref phKey);
            RegistryKey writeable_registry = RegistryKey.FromHandle(
                new Microsoft.Win32.SafeHandles.SafeRegistryHandle(phKey, true)
            );
            RegistryKey registryKey = writeable_registry.OpenSubKey(RegData, true);

            if (registryKey == null)
                registryKey = writeable_registry.CreateSubKey(RegData);
            registryKey.SetValue("Data", TextToHighlight);

            writeable_registry.Close();
        }
        private static void LoadOptions()
        {
            // In IE 7,8,9,(desktop)10 tabs run in Protected Mode
            // which prohibits writes to HKLM, HKCU.
            // Must ask IE for "Writable" registry section pointer
            // which will be something like HKU/S-1-7***/Software/AppDataLow/
            // In "metro" IE 10 mode, tabs run in "Enhanced Protected Mode"
            // where BHOs are not allowed to run, except in edge cases.
            // see http://blogs.msdn.com/b/ieinternals/archive/2012/03/23/understanding-ie10-enhanced-protected-mode-network-security-addons-cookies-metro-desktop.aspx
            IntPtr phKey = new IntPtr();
            var answer = IEGetWriteableHKCU(ref phKey);
            RegistryKey writeable_registry = RegistryKey.FromHandle(
                new Microsoft.Win32.SafeHandles.SafeRegistryHandle(phKey, true)
            );
            RegistryKey registryKey = writeable_registry.OpenSubKey(RegData, true);

            if (registryKey == null)
                registryKey = writeable_registry.CreateSubKey(RegData);
            registryKey.SetValue("Data", TextToHighlight);

            if (registryKey == null)
            {
                TextToHighlight = DefaultTextToHighlight;
            }
            else
            {
                TextToHighlight = (string)registryKey.GetValue("Data");
            }
            writeable_registry.Close();
        }
        #endregion

        [Guid("6D5140C1-7436-11CE-8034-00AA006009FA")]
        [InterfaceType(1)]
        public interface IServiceProvider
        {
            int QueryService(ref Guid guidService, ref Guid riid, out IntPtr ppvObject);
        }

        #region Implementation of IObjectWithSite
        int IObjectWithSite.SetSite(object site)
        {
            this.site = site;

            if (site != null)
            {
                LoadOptions();

                var serviceProv = (IServiceProvider)this.site;
                var guidIWebBrowserApp = Marshal.GenerateGuidForType(typeof(IWebBrowserApp)); // new Guid("0002DF05-0000-0000-C000-000000000046");
                var guidIWebBrowser2 = Marshal.GenerateGuidForType(typeof(IWebBrowser2)); // new Guid("D30C1661-CDAF-11D0-8A3E-00C04FC9E26E");
                IntPtr intPtr;
                serviceProv.QueryService(ref guidIWebBrowserApp, ref guidIWebBrowser2, out intPtr);

                browser = (IWebBrowser2)Marshal.GetObjectForIUnknown(intPtr);

                ((DWebBrowserEvents2_Event)browser).DocumentComplete +=
                    new DWebBrowserEvents2_DocumentCompleteEventHandler(this.OnDocumentComplete);
            }
            else
            {
                ((DWebBrowserEvents2_Event)browser).DocumentComplete -=
                    new DWebBrowserEvents2_DocumentCompleteEventHandler(this.OnDocumentComplete);
                browser = null;
            }
            return 0;
        }
        int IObjectWithSite.GetSite(ref Guid guid, out IntPtr ppvSite)
        {
            IntPtr punk = Marshal.GetIUnknownForObject(browser);
            int hr = Marshal.QueryInterface(punk, ref guid, out ppvSite);
            Marshal.Release(punk);
            return hr;
        }
        #endregion
        #region Implementation of IOleCommandTarget
        int IOleCommandTarget.QueryStatus(IntPtr pguidCmdGroup, uint cCmds, ref OLECMD prgCmds, IntPtr pCmdText)
        {
            return 0;
        }
        int IOleCommandTarget.Exec(IntPtr pguidCmdGroup, uint nCmdID, uint nCmdexecopt, IntPtr pvaIn, IntPtr pvaOut)
        {
            try
            {
                // Accessing the document from the command-bar.
                var document = browser.Document as IHTMLDocument2;
                var window = document.parentWindow;
                var result = window.execScript(@"alert('You will now be allowed to configure the text to highlight...');");

                var form = new HighlighterOptionsForm();
                form.InputText = TextToHighlight;
                if (form.ShowDialog() != DialogResult.Cancel)
                {
                    TextToHighlight = form.InputText;
                    SaveOptions();
                }
            }
            catch (Exception ex)
            {
                MessageBox.Show(ex.Message);
            }

            return 0;
        }
        #endregion

        #region Registering with regasm
        public static string RegBHO = "Software\\Microsoft\\Windows\\CurrentVersion\\Explorer\\Browser Helper Objects";
        public static string RegCmd = "Software\\Microsoft\\Internet Explorer\\Extensions";

        [ComRegisterFunction]
        public static void RegisterBHO(Type type)
        {
            string guid = type.GUID.ToString("B");

            // BHO
            {
                RegistryKey registryKey = Registry.LocalMachine.OpenSubKey(RegBHO, true);
                if (registryKey == null)
                    registryKey = Registry.LocalMachine.CreateSubKey(RegBHO);
                RegistryKey key = registryKey.OpenSubKey(guid);
                if (key == null)
                    key = registryKey.CreateSubKey(guid);
                key.SetValue("Alright", 1);
                registryKey.Close();
                key.Close();
            }

            // Command
            {
                RegistryKey registryKey = Registry.LocalMachine.OpenSubKey(RegCmd, true);
                if (registryKey == null)
                    registryKey = Registry.LocalMachine.CreateSubKey(RegCmd);
                RegistryKey key = registryKey.OpenSubKey(guid);
                if (key == null)
                    key = registryKey.CreateSubKey(guid);
                key.SetValue("ButtonText", "Highlighter options");
                key.SetValue("CLSID", "{1FBA04EE-3024-11d2-8F1F-0000F87ABD16}");
                key.SetValue("ClsidExtension", guid);
                key.SetValue("Icon", "");
                key.SetValue("HotIcon", "");
                key.SetValue("Default Visible", "Yes");
                key.SetValue("MenuText", "&Highlighter options");
                key.SetValue("ToolTip", "Highlighter options");
                //key.SetValue("KeyPath", "no");
                registryKey.Close();
                key.Close();
            }
        }

        [ComUnregisterFunction]
        public static void UnregisterBHO(Type type)
        {
            string guid = type.GUID.ToString("B");
            // BHO
            {
                RegistryKey registryKey = Registry.LocalMachine.OpenSubKey(RegBHO, true);
                if (registryKey != null)
                    registryKey.DeleteSubKey(guid, false);
            }
            // Command
            {
                RegistryKey registryKey = Registry.LocalMachine.OpenSubKey(RegCmd, true);
                if (registryKey != null)
                    registryKey.DeleteSubKey(guid, false);
            }
        }
        #endregion
    }
}

互操作

using System;
using System.Runtime.InteropServices;
namespace InternetExplorerExtension
{
    [ComVisible(true)]
    [InterfaceType(ComInterfaceType.InterfaceIsIUnknown)]
    [Guid("FC4801A3-2BA9-11CF-A229-00AA003D7352")]
    public interface IObjectWithSite
    {
        [PreserveSig]
        int SetSite([MarshalAs(UnmanagedType.IUnknown)]object site);
        [PreserveSig]
        int GetSite(ref Guid guid, [MarshalAs(UnmanagedType.IUnknown)]out IntPtr ppvSite);
    }


    [StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
    public struct OLECMDTEXT
    {
        public uint cmdtextf;
        public uint cwActual;
        public uint cwBuf;
        [MarshalAs(UnmanagedType.ByValTStr, SizeConst = 100)]
        public char rgwz;
    }

    [StructLayout(LayoutKind.Sequential)]
    public struct OLECMD
    {
        public uint cmdID;
        public uint cmdf;
    }

    [ComImport(), ComVisible(true),
    Guid("B722BCCB-4E68-101B-A2BC-00AA00404770"),
    InterfaceTypeAttribute(ComInterfaceType.InterfaceIsIUnknown)]
    public interface IOleCommandTarget
    {

        [return: MarshalAs(UnmanagedType.I4)]
        [PreserveSig]
        int QueryStatus(
            [In] IntPtr pguidCmdGroup,
            [In, MarshalAs(UnmanagedType.U4)] uint cCmds,
            [In, Out, MarshalAs(UnmanagedType.Struct)] ref OLECMD prgCmds,
            //This parameter must be IntPtr, as it can be null
            [In, Out] IntPtr pCmdText);

        [return: MarshalAs(UnmanagedType.I4)]
        [PreserveSig]
        int Exec(
            //[In] ref Guid pguidCmdGroup,
            //have to be IntPtr, since null values are unacceptable
            //and null is used as default group!
            [In] IntPtr pguidCmdGroup,
            [In, MarshalAs(UnmanagedType.U4)] uint nCmdID,
            [In, MarshalAs(UnmanagedType.U4)] uint nCmdexecopt,
            [In] IntPtr pvaIn,
            [In, Out] IntPtr pvaOut);
    }
}

最后是一个表单,我们将使用它来配置选项。在这种形式中放置 aTextBox和 Ok Button。将按钮的DialogResult 设置为
Ok 。将此代码放在表单代码中:

using System.Windows.Forms;
namespace InternetExplorerExtension
{
    public partial class HighlighterOptionsForm : Form
    {
        public HighlighterOptionsForm()
        {
            InitializeComponent();
        }

        public string InputText
        {
            get { return this.textBox1.Text; }
            set { this.textBox1.Text = value; }
        }
    }
}

在项目属性中,执行以下操作:

  • 使用强密钥签署程序集;
  • 在 Debug 选项卡中,将 Start External Program 设置为C:\Program Files (x86)\Internet Explorer\iexplore.exe
  • 在 Debug 选项卡中,将 Command Line Arguments 设置为http://msdn.microsoft.com/en-us/library/ms976373.aspx#bho_getintouch
  • 在 Build Events 选项卡中,将 Post-build events 命令行 设置为:

    "%ProgramFiles(x86)%\Microsoft SDKs\Windows\v10.0A\bin\NETFX 4.6.1 Tools\gacutil.exe" /f /i "$(TargetDir)$(TargetFileName)"
    

    “%windir%\Microsoft.NET\Framework\v4.0.30319\RegAsm.exe” /注销 “$(TargetDir)$(TargetFileName)”

    “%windir%\Microsoft.NET\Framework\v4.0.30319\RegAsm.exe” “$(TargetDir)$(TargetFileName)”

注意: 即使我的计算机是 x64,我使用了非 x64 的路径gacutil.exe并且它工作...... x64 特定的一个是:

C:\Program Files (x86)\Microsoft SDKs\Windows\v10.0A\bin\NETFX 4.6.1 Tools\ **x64\** gacutil.exe

64 位 IE 需要 64 位编译和 64 位注册的 BHO。虽然我只能使用 32 位 IE11 进行调试,但 32 位注册扩展也可以通过运行 64
位 IE11 来工作。

这个答案似乎有一些关于这个的额外信息:https
://stackoverflow.com/a/23004613/195417

如果需要,可以使用 64bit regasm:

%windir%\Microsoft.NET\Framework **64\** v4.0.30319\RegAsm.exe

这个附加组件的工作原理

我没有改变插件的行为......请查看下面的 IE8 部分进行描述。


## IE8 的上一个答案

伙计……这是一项艰巨的工作!我很好奇如何做到这一点,所以我自己做了。

首先……功劳不全是我的。这是我在这些网站上找到的内容的汇编:

当然,我希望我的答案具有您所要求的功能:

  • DOM 遍历找东西;
  • 一个显示窗口的按钮(在我的情况下是设置)
  • 持久化配置(我将为此使用注册表)
  • 最后执行javascript。

我将逐步描述它,我如何设法在 Windows 7 x64中使用* Internet Explorer 8
来完成它......请注意,我无法在其他配置中进行测试。希望你能理解 =)
*

创建有效的 Internet Explorer 8 加载项

我正在使用 Visual Studio 2010C# 4.Net Framework 4
,因此其中一些步骤对您来说可能略有不同。

创建了一个类库。我打电话给我的 InternetExplorerExtension

将这些引用添加到项目中:

  • 互操作性SHDocVw
  • 微软.mshtml

注意:这些引用可能位于每台计算机的不同位置。

这是我在 csproj 中的参考部分包含的内容:

<Reference Include="Interop.SHDocVw, Version=1.1.0.0, Culture=neutral, PublicKeyToken=90ba9c70f846762e, processorArchitecture=MSIL">
  <SpecificVersion>False</SpecificVersion>
  <EmbedInteropTypes>True</EmbedInteropTypes>
  <HintPath>C:\Program Files (x86)\Microsoft Visual Studio 9.0\Common7\IDE\PrivateAssemblies\Interop.SHDocVw.dll</HintPath>
</Reference>
<Reference Include="Microsoft.CSharp" />
<Reference Include="Microsoft.mshtml, Version=7.0.3300.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a">
  <EmbedInteropTypes>True</EmbedInteropTypes>
</Reference>
<Reference Include="System" />
<Reference Include="System.Data" />
<Reference Include="System.Drawing" />
<Reference Include="System.Windows.Forms" />
<Reference Include="System.Xml" />

以与更新的 IE11 文件相同的方式创建文件。

IEAddon.cs

您可以从 IE11 版本中取消注释以下行:

...
// @Eric Stob: Thanks for this hint!
// This was used to prevent this method being executed more than once in IE8... but now it seems to not work anymore.
if (pDisp != this.site)
    return;
...

互操作

与 IE11 版本相同。

最后是一个表单,我们将使用它来配置选项。在这种形式中放置 aTextBox和 Ok Button。将按钮的DialogResult 设置为
Ok 。IE11 插件的代码相同。

在项目属性中,执行以下操作:

  • 使用强密钥签署程序集;
  • 在 Debug 选项卡中,将 Start External Program 设置为C:\Program Files (x86)\Internet Explorer\iexplore.exe
  • 在 Debug 选项卡中,将 Command Line Arguments 设置为http://msdn.microsoft.com/en-us/library/ms976373.aspx#bho_getintouch
  • 在 Build Events 选项卡中,将 Post-build events 命令行 设置为:

    "C:\Program Files (x86)\Microsoft SDKs\Windows\v7.0A\Bin\NETFX 4.0 Tools\ **x64** \gacutil.exe" /f /i "$(TargetDir)$(TargetFileName)"
    

    “C:\Windows\Microsoft.NET\Framework\v4.0.30319\RegAsm.exe” /注销 “$(TargetDir)$(TargetFileName)”

    “C:\Windows\Microsoft.NET\Framework\v4.0.30319\RegAsm.exe” “$(TargetDir)$(TargetFileName)”

注意: 由于我的电脑是 x64 的,所以在我的机器上 gacutil 可执行文件的路径中有一个特定的 x64,可能与你的不同。

64 位 IE 需要 64 位编译和 64 位注册的 BHO。使用 64 位 RegAsm.exe(通常位于
C:\Windows\Microsoft.NET\Framework64\v4.0.30319\RegAsm.exe)

这个附加组件的工作原理

它遍历所有 DOM 树,替换文本,使用按钮配置,本身带有黄色背景。如果您单击泛黄的文本,它会调用动态插入页面的 javascript
函数。默认词是“浏览器”,所以它匹配了很多! 编辑: 更改要突出显示的字符串后,您必须单击 URL 框并按 Enter … F5
不起作用,我认为这是因为 F5 被视为“导航”,并且需要监听导航事件(也许)。我稍后会尝试解决这个问题。

现在,该走了。我很累。随意提问…可能因为我要去旅行而无法回答… 3天后我回来了,但我会尝试在此期间来这里。

2022-06-27