使用 .NET 和 Windows Forms 扩展 Explorer 的 Band Objects

• 下载源文件 - 118 Kb

引言

关于使用 Band Objects、Browser Bands、Toolbar Bands 和 Communication Bands 扩展 Windows 和 Internet Explorer 的内容已经有很多了。所以，如果你熟悉 COM 和 ATL，你可能已经自己实现了一个。那么，如果你一直在等待一个简单的方法来给你的朋友留下深刻印象，就像 Google Toolbar 那样，那么它来了 - .NET 方法（或者说 Windows Forms 和 COM Interop 方法？）。在这篇教程中，我将展示如何使用 BandObject 控件创建上述任何一种 Band Object 类型。之后我还会讨论 BandObject 的一些实现细节。

一步一步构建“Hello World Bar”

1.

构建 BandObjectLib 的 Release 版本并将其注册到全局程序集缓存 (GAC)。最简单的方法是使用 Visual Studio 打开 BandObjectLib.sln，将活动配置设置为 Release，然后从“生成”菜单中选择“重新生成解决方案”。解决方案中的第二个项目 - RegisterLib - 是一个 C++ 实用程序项目，它执行“gacutil /if BandObjectLib.dll”命令，将程序集放入 GAC。

正如你可能已经知道的，Band Objects 是 COM 组件。为了让 .NET Framework 找到实现 COM 组件的程序集，它必须要么注册在 GAC 中，要么位于客户端应用程序的目录中。Band Objects 的客户端应用程序有两种可能性 - explorer.exe 和 iexplorer.exe。Explorer 位于 Windows 目录中，而 IE 位于“Program Files”的某个子目录中。所以，在这种情况下，GAC 实际上是唯一的选择。因此，实现 Band Objects 的 .NET 程序集应该注册在 GAC 中，并且它们依赖的所有库 - 如 BandObjectLib.dll - 也应该在那里。

GAC 中的程序集必须具有强名称，因此需要密钥对。我已经提供了带有密钥对的 BandObjects.snk 文件，但我鼓励你用你自己的密钥对替换它。有关更多详细信息，请参阅 sn.exe 工具。

2.

创建一个新的 Windows 控件库项目，并将其命名为 SampleBars。我们将依赖 BandObjectLib 的基本功能，因此我们需要添加对 BandObjectLib\Relase\bin\BandObjectLib.dll 的引用。由于我们正在开发一个“Hello World Bar”，请将 UserControl1.cs 以及其中 UserControl1 类重命名为 HelloWolrdBar.cs 和 HelloWorldBar。还将以下行放在 HelloWorldBar.cs 的开头：

using BandObjectLib;
using System.Runtime.InteropServices;

3.

让 HelloWorldBar 类继承 BandObject 而不是 System.Windows.Forms.UserControl。正如我之前提到的，Band Objects 是 COM 组件，所以我们应该使用 Guid 属性。使用 guidgen.exe 生成你的唯一 GUID，或者你可以使用我已经为你生成的 GUID。

[Guid("AE07101B-46D4-4a98-AF68-0333EA26E113")]

我们还必须用强名称签名我们的程序集。你可以通过将以下行放入 AssemblyInfo.cs 文件来完成此操作。

[assembly: AssemblyKeyFile(@"..\..\..\BandObjects.snk")]
        

4.

现在是时候决定我们要开发哪种类型的 Band Object 了。让我们将其制作成一个 Explorer Toolbar 以及一个 Horizontal Explorer Bar（也称为 Browser Communication Band）。要实现这个决定，我们只需要为我们的 HelloWorldBar 类添加自定义 BandObject 属性。

[Guid("AE07101B-46D4-4a98-AF68-0333EA26E113")]
[BandObject("Hello World Bar",
BandObjectStyle.Horizontal | BandObjectStyle.ExplorerToolbar,
HelpText = "Shows bar that says hello.")]
public class HelloWorldBar : BandObject
{ ...

这足以通过“查看”->“Explorer Bars”和“查看”->“Toolbars”的 Explorer 菜单使我们的控件可用。它还负责菜单项文本 -“Hello World Bar”，并且当菜单项被高亮显示时，状态栏会显示“Shows bar that says hello.”。你不喜欢声明式编程和自定义属性吗？

5.

现在是时候在 Visual Studio Designer 中打开 HelloWorldBar.cs 并添加一些控件了。虽然在我版本的 HelloWorldBar 中，我决定添加一个带有“Say Hello”标题的按钮，但你可以做一些更个性化的事情。我将按钮的大小设置为与控件的客户端区域大小相同，并将其 Anchor 属性设置为所有可能样式的组合 -“Top, Bottom, Left, Right”。背景颜色是“HotTrack”，ForeColor 是“Info”。

BandObject 控件具有几个特定于 Band Objects（以及派生自它的类）的属性 - Title、MinSize、MaxSize 和 IntegralSize。我为 HelloWorldBar 设置了 Title 为“Hello Bar”，并将 MinSize 和 Size 都设置为‘150, 24’。哦，在按钮的 On Click 事件处理程序中，我添加了显示消息框的代码。这是我的最终代码（其中大部分是由 VS.Net 生成的）。

using System;
using System.ComponentModel;
using System.Windows.Forms;

using BandObjectLib;
using System.Runtime.InteropServices;

namespace SampleBars
{
    [Guid("AE07101B-46D4-4a98-AF68-0333EA26E113")]
    [BandObject("Hello World Bar", BandObjectStyle.Horizontal 
         | BandObjectStyle.ExplorerToolbar, HelpText = "Shows bar that says hello.")]
    public class HelloWorldBar : BandObject
    {
        private System.Windows.Forms.Button button1;
        private System.ComponentModel.Container components = null;

        public HelloWorldBar()
        {
            InitializeComponent();
        }

        protected override void Dispose( bool disposing )
        {
            if( disposing )
            {
                if( components != null )
                    components.Dispose();
            }
            base.Dispose( disposing );
        }

        #region Component Designer generated code
        private void InitializeComponent()
        {
            this.button1 = new System.Windows.Forms.Button();
            this.SuspendLayout();
            // 
            // button1
            // 
            this.button1.Anchor = (((System.Windows.Forms.AnchorStyles.Top 
                | System.Windows.Forms.AnchorStyles.Bottom) 
                | System.Windows.Forms.AnchorStyles.Left) 
                | System.Windows.Forms.AnchorStyles.Right);
            this.button1.BackColor = System.Drawing.SystemColors.HotTrack;
            this.button1.ForeColor = System.Drawing.SystemColors.Info;
            this.button1.Name = "button1";
            this.button1.Size = new System.Drawing.Size(150, 24);
            this.button1.TabIndex = 0;
            this.button1.Text = "Say Hello";
            this.button1.Click += new System.EventHandler(this.button1_Click);
            // 
            // HelloWorldBar
            // 
            this.Controls.AddRange(new System.Windows.Forms.Control[] { this.button1 });
            this.MinSize = new System.Drawing.Size(150, 24);
            this.Name = "HelloWorldBar";
            this.Size = new System.Drawing.Size(150, 24);
            this.Title = "Hello Bar";
            this.ResumeLayout(false);

        }
        #endregion

        private void button1_Click(object sender, System.EventArgs e)
        {
            MessageBox.Show("Hello, World!");
        }
    }
}

6.

好的，现在我们已准备好构建 SampleBars.dll，但这还不足以在 Explorer 中看到它。我们必须将我们的程序集放入 GAC 并将其注册为 COM 服务器。有工具 - gacutil.exe 和 regasm.exe - 可以做到这一点。我版本的 SampleBars 解决方案中名为 Register 的 C++ 实用程序项目让我不必手动使用这些工具。它没有任何文件，只有一个如下的生成后命令（调试版本）。

        cd $(ProjectDir)..\bin\Debug
        gacutil /if SampleBars.dll
        regasm SampleBars.dll
        

[assembly: AssemblyVersion("1.0.*")]

WCHAR wszTitle[256];

[StructLayout(LayoutKind.Sequential,CharSet=CharSet.Unicode)]
public struct DESKBANDINFO
{
    public UInt32        dwMask;
    public Point        ptMinSize;
    public Point        ptMaxSize;
    public Point        ptIntegral;
    public Point        ptActual;
    [MarshalAs(UnmanagedType.ByValTStr, SizeConst=255)]
    public String        wszTitle;
    public DBIM         dwModeFlags;
    public Int32        crBkgnd;
};