SharePoint Ribbon
自定义元素
在用户创建Ribbon自定义项时,CustomAction元素的Location属性默认有以下设置,此Location 属性告知 CustomAction 在何处应用自定义项
值 | 说明 |
CommandUI.Ribbon | 对于指定的 RegistrationId,自定义项出现在任何地方。 |
CommandUI.Ribbon.ListView | 当存在列表视图 Web 部件时出现自定义项。 |
CommandUI.Ribbon.EditForm | 自定义项出现在编辑表单上。 |
CommandUI.Ribbon.NewForm | 自定义项出现在新建表单上。 |
CommandUI.Ribbon.DisplayForm | 自定义项出现在显示表单上。 |
1,使用Designer 打开网站 2010 在菜单直接打开,2013 使用打开地址的方式打开。
之前你要建立一个测试列表,完成之后请继续,如图
打开你的测试列表
在其Display页中添加一个自定义操作。现在我们可以开始添加自定义操作了。注意一点,在添加自定义操作是不要使用在右下方“自定义操作”窗口上方的“新建”按钮,因为它会默认的在列表项菜单中添加你的自定义操作。
我们通过窗口上方,“自定义操作”功能区中的“自定义操作”按钮来添加新的自定义操作。
接着我们选择显示“表单”功能区,以在该列表的Display页中添加一个自定义操作。
我们将看到“创建自定义操作”窗口
Designer2010支持三种操作类型,分别是:导航至表单、启动工作流和导航至URL。
在“导航至URL”中我们可以提供一些参数,例如ItemID,ListID等等
在这里我们选择“导航至表单”来为我们的Display页面添加一个新建按钮
再往下看,你会发现“功能区位置”的设置已经自动完成了,因为我们选择的是在显示表单功能区中创建自定义操作,所以这里就是“Ribbon.ListForm.Display.Manage.Controls._children”,下面的表格列出了几个常用的功能区位置。
Form Name | Ribbon Location |
Display Form | Ribbon.ListForm.Display.Manage.Controls._children |
Edit Form | Ribbon.ListForm.Edit.Actions.Controls._children |
New Form | Ribbon.ListForm.Edit.Actions.Controls._children |
View Form | Ribbon.ListItem.Actions.Controls._children |
下面是“权限掩码”的设置,它可以帮助你指定拥有何种权限的人才能看见这个自定义操作,其值来自于SPBasePermissions枚举,具体值可在SDK中查找。在我们这个例子中留空即可。
最后便是设置我们这个自定义操作的序列号,它是用来设置我们的自定义操作在Ribbon中的位置的,越大则越靠右。