演练：在Excel中建立自定义菜单项 Brian A. RandellMCW Technologies, LLCSeptember 2003Applies to: Microsoft® Visual Studio® Tools for the Microsoft Office System Microsoft Office Excel 2003Microsoft Visual Studio .NET 2003概述：Office CommandBar对象提供了增加菜单项和工具条按钮代码的途径。在这篇演练中，你将建立自定义菜单项目下的菜单条，并且增加代码来响应Office菜单。内容：介绍建立菜单和工具条项目是微软Office的一个核心特点，虽然这次试验是示范在微软Office Excel 2003中使用这些项目，但是这些操作在Office Word中是类似的。（不同之处在于在Word中菜单名是Menu Bar，而在Excel中叫Worksheet Menu Bar。）你将在Excel主菜单中建立菜单项。然后，你增加此菜单项。最后，你增加Click事件代码来执行自定义代码。提示：Office菜单和工具条的对象模块定义在Office.dll中，当你给微软Office System项目建立了一个新的Visual Studio Tools时，微软Visual Studio® .NET自动包含到此模块的引用。先决条件要完成此演练，下列软件和组件必须安装：• Microsoft Visual Studio .NET 2003 or Microsoft Visual Basic® .NET Standard 2003 • Microsoft Visual Studio Tools for the Microsoft Office System • Microsoft Office Professional Edition 2003提示：假如你是Visual Basic .Net编程者，你需要设置Option Strict为On（或者你在每一个模块中增加Option Strict声明）。虽然这不是必须的，但是这可以保证你不会执行不安全的类型转换。在以后的时间里，利用此选项的好处将远远大于增加代码的困难。开始你将通过建立一个新的Visual Studio .NET的Excel项目来开始。建立项目使用微软Office System的Visual Studio Tool建立一个新的Excel工作簿项目（在Visual Basic .NET或是C＃中）。建立一个Excel工作簿项目1. 开始Visual Studio .NET，在文件菜单上，指向新建，点击项目。2. 在项目类型面板上，扩展微软Office System项目，接着选择Visual Basic 项目或Visual c＃项目。3. 在模板面板中选择Excel工作簿。4. 起名为ExcelCommandBars，接着存储在当地硬盘。5. 在微软Office项目向导中接受缺省值，点击完成。Visual Studio .NET为你在代码编辑器中打开ThisWorkbook.vb或是ThisWorkboo.cs文件。建立菜单栏项目在Excel主菜单条上建立一个菜单栏项目需要你使用Add方法增加一个CommandBarControl。在Excel中建立菜单栏项目1. 在已存变量ThisApplication和ThisWorkbook下面增加下列变量：' Visual Basic Private MainMenuBar As Office.CommandBar Private MenuBarItem As Office.CommandBarControl Private WithEvents MenuItem As Office.CommandBarButton // C# private Office.CommandBar MainMenuBar = null; private Office.CommandBarControl MenuBarItem = null; private Office.CommandBarButton MenuItem = null; 2. 在OfficeCodeBehing类中增加下列程序（通过项目模板建立），这段程序初始化了先前声明的MainMenuBar和MenuItemBar对象。' Visual Basic Private Sub InitMenuBarItems(ByVal Caption As String)Try MainMenuBar = ThisApplication.CommandBars( _ "Worksheet Menu Bar") MenuBarItem = MainMenuBar.Controls.Add( _ Office.MsoControlType.msoControlPopup, Temporary:=True) MenuBarItem.Caption = Caption Catch ex As Exception MessageBox.Show(ex.Message, _ ex.Source, MessageBoxButtons.OK, MessageBoxIcon.Error) End Try End Sub // C# private void InitMenuBarItems(string Caption) { try { MainMenuBar = ThisApplication.CommandBars["Worksheet Menu Bar"]; MenuBarItem = MainMenuBar.Controls.Add( Office.MsoControlType.msoControlPopup, Type.Missing, Type.Missing, Type.Missing, true); MenuBarItem.Caption = Caption; } catch (Exception ex) { MessageBox.Show(ex.Message, ex.Source, MessageBoxButtons.OK, MessageBoxIcon.Error); } } 3. 增加下列代码到已存在的ThisWorkbook_Open程序，这段代码调用你刚才建立的InitMenuBarItems程序。' Visual Basic InitMenuBarItems("&Custom Code") // C# InitMenuBarItems("&Custom Code"); 4. 选择文件菜单上的保存所有文件来保存整个方案。5. 按F5运行项目，装入Excel和你的工作簿。6. 在Excel中，查看菜单栏项目标签写着Custom Code的菜单显示在帮助菜单右边。如图一所示：
图一：有着自定义菜单栏项目的Excel 建立菜单项目有了合适的自定义菜单栏，你就可以加入新的菜单中了。菜单项目表示为CommandBarControl对象，你将使用先前建立的菜单栏项目Controls集合的Add方法来建立一个新的CommandBarControl实例。建立菜单项目1. 增加下列程序到OfficeCodeBehind类中，这段程序建立了CommandBarControl并且设置其标题：' Visual Basic Private Function CreateButton( _ ByVal Parent As Office.CommandBarPopup, _ ByVal Caption As String) As Office.CommandBarButton Try Dim cbc As Office.CommandBarControl cbc = Parent.Controls.Add( _ Office.MsoControlType.msoControlButton, Temporary:=True) cbc.Caption = Caption cbc.Visible = True Return DirectCast(cbc, Office.CommandBarButton) Catch ex As Exception MessageBox.Show(ex.Message, _ ex.Source, MessageBoxButtons.OK, MessageBoxIcon.Error) End Try End Function // C# private Office.CommandBarButton CreateButton( Office.CommandBarPopup Parent, string Caption) { Office.CommandBarControl cbc = null; try { cbc = Parent.Controls.Add( Office.MsoControlType.msoControlButton, Type.Missing, Type.Missing, Type.Missing, true); cbc.Caption = Caption; cbc.Visible = true; } catch (Exception ex) { MessageBox.Show(ex.Message, ex.Source, MessageBoxButtons.OK, MessageBoxIcon.Error); } return (Office.CommandBarButton) cbc; } 2. 增加下列代码到ThisWorkbook_Open程序中，下列代码调用了InitMenuBarItems程序：' Visual Basic MenuItem = CreateButton( _ DirectCast(MenuBarItem, Office.CommandBarPopup), _ "Run Demo Code") // C# MenuItem = CreateButton( (Office.CommandBarPopup)MenuBarItem, "Run Demo Code"); 3. 选择文件菜单上的保存所有文件来保存整个方案。4. 按F5运行此项目，装入Excel和你的工作簿。5. 在Excel中点击自定义的顶级菜单，查看Run Demo Code菜单项。如下图二所示：图二：增加了一个菜单项之后 拦截菜单项的点击事件为了完成本次演练，你需要增加一个事件来处理自定义菜单项被点击之后的响应。（只用在Visual Basic）拦截菜单项点击事件在Visual Basic .NET中完成下列步骤增加菜单项被点击的事件处理程序。为自定义菜单项增加事件处理（Visual Basic）1. 在代码编辑器的左上角的Class Name下拉列表中选择MenuItem。2. 在代码编辑器的右上角的Method Name下拉列表中选择Click。3. 修改MenuItem_Click程序，增加下列代码：' Visual Basic MessageBox.Show(String.Format( _ "You just clicked the button labeled '{0}'.{1}" & _ "The name of your workbook is '{2}'.", _ Ctrl.Caption, Environment.NewLine, ThisWorkbook.Name), _ "MenuItem_Click", MessageBoxButtons.OK, _ MessageBoxIcon.Information) 4. 选择文件菜单中的保存所有文件来保存整个解决方案。5. 按F5运行这个项目，装入Excel和你的工作簿。6. 在Excel中，点击Custom Code菜单，接着选择Run Demo Code。一个警告框出现，显示当前工作簿。（C＃）拦截点击菜单项目事件在Visual C＃中完成下列步骤来增加点击自定义菜单栏项目的事件处理。为自定义菜单项目增加事件处理（C＃）1. 增加下列程序到OfficeCodeBehind类中：// C# private void MenuItem_Click( Office.CommandBarButton Ctrl, ref Boolean CancelDefault) { MessageBox.Show(String.Format( "You just clicked the button labeled '{0}'.\n" + "The name of your workbook is '{1}'.", Ctrl.Caption, ThisWorkbook.Name), "MenuItem_Click", MessageBoxButtons.OK, MessageBoxIcon.Information); } 2. 修改ThisWorkbook_Open程序，增加下列代码：// C# MenuItem.Click += new Microsoft.Office.Core. _CommandBarButtonEvents_ClickEventHandler(MenuItem_Click); 提示：如果你输入完代码的第一行（直到＋＝），Visual Studio .NET将提示你按TAB键。代码编辑器将为你插入此行的剩余代码。这个自动完成的新特点使你更容易的完成事件处理程序。测试本应用现在你可以测试自己建立的自定义菜单项了。测试本应用1. 选择文件菜单的保存所有文件来保存整个项目。2. 按F5运行这个项目，装入Excel和你的工作簿。3. 在警告框中出现对你当前工作簿的描述。结论微软Office应用的一个核心特点是建立菜单和工具栏的能力。Office CommandBar对象提供了一种方法来自定义菜单和工具栏。虽然本次演练示范了你怎样增加代码来响应Excel菜单的点击，你将会发现在Word中的行为与此类似。
