构造块:服务器功能区
上次修改时间: 2011年8月22日
适用范围: SharePoint Foundation 2010
本文内容
服务器功能区的对象模型
用于服务器功能区的 XML
与服务器功能区相关的区域
有关服务器功能区的详细信息
Microsoft SharePoint Foundation 中的服务器功能区在用于 SharePoint 对象时会创建一个一致的用户界面 (UI)。功能区中的顶级元素是选项卡。选项卡显示在 网站的页面顶部。每个选项卡包含多个组,这些组又包含一些控件集。每个组均可包含多个控件并具有一个用于标识每个组的标签。组内的控件包括按钮、下拉菜单、复选框、组合框、拆分按钮以及库。这些控件中的每一个均由唯一的命令进行操作。
服务器功能区的对象模型
功能区使用了 ECMAScript(JavaScript、JScript) 对象模型和服务器对象模型。
服务器对象
IRibbonMenu - 表示用于实现功能区的接口。
SPRibbonButton - 表示功能区内的一个按钮。
SPRibbonCommand - 表示由功能区上某个控件处理的命令。
SPRibbonMenu - 表示功能区上显示的菜单。
SPRibbonMenuItem - 表示功能区上某个菜单中的控件。
SPRibbonMenuSection - 表示功能区菜单的一部分。
SPRibbonPopulateQueryCommand - 表示用于从 XML 填充功能区中的动态菜单的命令。
SPRibbonQueryCommand - 表示用于 QueryCommand 事件的功能区命令。
ECMAScript 对象
SP.Ribbon.PageManager
CUI.Page.CommandDispatcher
CUI.Page.PageComponent
用于服务器功能区的 XML
可通过使用某个"功能"中的 XML 或某个用户自定义操作来定义和自定义服务器功能区。用于功能区的 XML 定义每个选项卡、组和控件。Tab 元素包含一个 Groups 元素,而每个 Groups 元素又包含多个 Group 元素。在 Group 元素内是一个包含多个控件类型的 Controls 元素。可用的控件类型在服务器功能区的体系结构中列出。下面是一个自定义功能区的 XML 代码的示例。
<?xml version="1.0" encoding="utf-8"?>
<Elements xmlns="https://schemas.microsoft.com/sharepoint/">
<CustomAction
Id="Ribbon.WikiPageTab.CustomGroupAndControls"
Location="CommandUI.Ribbon"
RegistrationId="100"
RegistrationType="List">
<CommandUIExtension>
<CommandUIDefinitions>
<CommandUIDefinition
Location="Ribbon.WikiPageTab.Groups._children">
<Group
Id="Ribbon.WikiPageTab.CustomGroup"
Sequence="55"
Description="Custom Group"
Title="Custom Group"
Command="EnableCustomGroup"
Template="Ribbon.Templates.Flexible2">
<Controls Id="Ribbon.WikiPageTab.CustomGroup.Controls">
<Button
Id="Ribbon.WikiPageTab.CustomGroup.Controls.CustomButton1"
Command="CustomButtonCommand1"
Image16by16="/_layouts/images/FILMSTRP.GIF"
Image32by32="/_layouts/images/PPEOPLE.GIF"
LabelText=""
TemplateAlias="o2"
Sequence="15" />
</Controls>
</Group>
</CommandUIDefinition>
</CommandUIDefinitions>
<CommandUIHandlers>
<CommandUIHandler Command="EnableCustomGroup" />
<CommandUIHandler Command="CustomButtonCommand1" CommandAction="javascript:alert('Hello, world!');" />
</CommandUIHandlers>
</CommandUIExtension>
</CustomAction>
</Elements>
可使用 XML 和 ECMAScript(JavaScript、JScript) 对 SharePoint Foundation 中的功能区进行自定义。XML 定义功能区上的控件;JavaScript 对页面或页面上的对象执行操作。可以使用存在于 SharePoint FoundationJavaScript 对象模型或内置的 JavaScript 函数中的 JavaScript。还可将自己的 JavaScript 添加到页面中并使用它与功能区进行交互。有关自定义功能区的详细信息,请参见自定义服务器功能区。