在笔者公司中,SharePoint得到了大规模的使用。最近,在IT托管的SharePoint 2010系统中,页面最上方被统一加上了一个额外的区域,右上角放置了两个额外的下拉菜单。
这两个下拉菜单为用户提供了一些快捷链接,包括访问IT的Support网站、查看当前网站的信息,以及从系统中申请一个新的SharePoint网站等。
从上面的截图可以看到,这两个定制的下拉菜单使用了SharePoint的内置风格,它们的样式与SharePoint 2010页面上的网站操作与欢迎菜单保持了一致。如果我们要在自己的应用中,创建这样一个与SharePoint 2010风格一致的下拉菜单,应该如何做呢?
要创建一个使用SharePoint内置风格的下拉菜单,可以创建一个自定义类,并让其继承自Microsoft.SharePoint.WebControls.ToolBarMenuButton类。通过调用父类所提供的各个属性与方法,我们的自定义类就可以为菜单添加自定义的菜单项。
在下面所示的代码中,从第18到28行,初始化了这个菜单的基本样式。基本上,我们会复用SharePoint 2010内置的CSS Class和图片。第19行通过将MenuTemplateControl.LargeIconMode属性指定为true,使得菜单以大图标模式进行展现。
第31行通过MenuControl.Text属性指定了这个下拉菜单所显示出来的文本内容。
接下来,我们开始向这个下拉菜单中添加子菜单项。添加子菜单项的方法有两种,第一种是直接调用父类所提供的AddMenuItem()方法。此方法的各个参数分别是:
- id:指定一个唯一的ID号;
- displayName:菜单项的标题文字;
- imageUrl:菜单项的图标;
- description:菜单项的描述文字;
- navigateUrl:用户点击菜单项时,将用户导航到此路径;
- onClickScript:用户点击菜单项时,执行指定的JavaScript脚本
第二种方法是先创建一个MenuItemTemplate对象,为它的各个属性赋值,然后将它添加到MenuTemplateControl.Controls集合里面。
要在下拉菜单中添加一个分割线,调用父类的AddMenuItemSeparator()方法。
如果想在下拉菜单中添加二级菜单,就需要先创建一个SubMenuTemplate对象,将它添加到MenuTemplateControl.Controls集合里面。然后一个一个的创建MenuItemTemplate对象,将它们添加到SubMenuTemplate对象的Controls集合中。
下面的代码创建了一个“Support”二级菜单,然后向这个二级菜单添加了一个“GetIT”子菜单项。
最后要做的,就是将我们创建的这个自定义控件,放到页面上去。根据我们想要放置的地方的不同,可以有不同的方式。比如,可以修改(或创建一个新的)母版页。
通过上面的示范代码最后创建出来的下拉菜单的呈现效果,如下图所示。在下图中,笔者将这个额外的菜单,放到了页面的用户欢迎菜单的左侧。
在下一篇文章中,我将讲述如何让我们创建的自定义菜单,能够和SharePoint Feature框架中的Custom Action整合在一起。也就是说,网站开发人员可以使用Custom Action,直接向我们所创建的自定义菜单中添加子菜单项,就如同向“网站操作”菜单中添加子菜单项那样。通过这样的整合,我们的自定义菜单将具有更好的灵活性和可扩展性。