通过

服务器功能区) (功能区元素

适用于： SharePoint 2016 |SharePoint Foundation 2013 |SharePoint Online |SharePoint Server 2013

包含定义服务器功能区用户界面的元素。

<Ribbon
  Id="Text"
  Image32by32GroupPopupDefault="Url"
  Image32by32GroupPopupDefaultClass="CSS Selector"
  Image32by32GroupPopupDefaultLeft="Negative Integer"
  Image32by32GroupPopupDefaultTop="Negative Integer"
  ImageDownArrow="Url"
  ImageDownArrowClass="CSS Selector"
  ImageDownArrowLeft="Negative Integer"
  ImageDownArrowTop="Negative Integer"
  ImageSideArrow="Url"
  ImageSideArrowClass="CSS Selector"
  ImageSideArrowLeft="Negative Integer"
  ImageSideArrowTop="Negative Integer"
  ImageUpArrow="Url"
  ImageUpArrowClass="CSS Selector"
  ImageUpArrowLeft="Negative Integer"
  ImageUpArrowTop="Negative Integer"
  RootEventCommand="Text"
  TabSwitchCommand="Text"
  ScaleCommand="Text"
  TextDirection="Text"
  ToolTipFooterText="Text"
  ToolTipFooterImage16by16="Url"
  ToolTipFooterImage16by16Class="CSS Selector"
  ToolTipFooterImage16by16Left="Negative Integer"
  ToolTipFooterImage16by16Top="Negative Integer"
  ToolTipDisabledCommandImage16by16="Url"
  ToolTipDisabledCommandImage16by16Class="CSS Selector"
  ToolTipDisabledCommandImage16by16Left="Negative Integer"
  ToolTipDisabledCommandImage16by16Top="Negative Integer"
  ToolTipDisabledCommandDescription="Text"
  ToolTipDisabledCommandTitle="Text"
  ToolTipDisabledCommandHelpKey="Text"
  ToolTipHelpCommand="Text"
  ToolTipSelectedItemTitlePrefix="Text"
  ShortcutKeyJumpToRibbon_Ctrl="Text"
  ShortcutKeyJumpToRibbon_Alt="Text"
  ShortcutKeyJumpToRibbon_Shift="Text"
  ShortcutKeyJumpToRibbon_AccessKey="Text"
  ShortcutKeyJumpToFirstControl_Ctrl="Text"
  ShortcutKeyJumpToFirstControl_Alt="Text"
  ShortcutKeyJumpToFirstControl_Shift="Text"
  ShortcutKeyJumpToFirstControl_AccessKey="Text"
  ATContextualTabText="Text"
  ATTabPositionText="Text"
  NavigationHelpText="Text"
/>

元素和属性

下面各部分介绍了属性、子元素和父元素。

Attributes

属性 说明
Id
必填。 标识元素的字符串，例如“Ribbon”。
Image32by32GroupPopupDefault
可选。 文件相对于服务器的 URL，该文件包含要用于弹出图像的 32 X 32 像素图像，例如“/_layouts/1033/images/formatmap32x32.png”。
Image32by32GroupPopupDefaultClass
可选。 应用于弹出图像的 CSS 类选择器的名称。
Image32by32GroupPopupDefaultLeft
可选。 一个负整数，表示图像左边缘的偏移。 当 Image32by32GroupPopupDefault 属性指向一个图像文件（其中包含许多图标的图像）时，使用此属性。 Image32by32GroupPopupDefaultLeft 属性的值可用于在创建页面时设置级联样式 HTML img 标记的 CSS left 属性。
Image32by32GroupPopupDefaultTop
可选。 一个负整数，表示图像上边缘的偏移。 当 Image32by32GroupPopupDefault 属性指向一个图像文件（其中包含许多图标的图像）时，使用此属性。 Image32by32GroupPopupDefaultTop 属性的值可用于在创建页面时设置级联样式 HTML img 标记的 CSS top 属性。
ImageDownArrow
可选。 文件相对于服务器的 URL，该文件包含要用于向下箭头的 16 X 16 像素图像，例如“/_layouts/1033/images/formatmap16x16.png”。
ImageDownArrowClass
可选。 应用于向下箭头图像的 CSS 类选择器的名称。
ImageDownArrowLeft
可选。 一个负整数，表示图像左边缘的偏移。 当 ImageDownArrow 属性指向一个图像文件（其中包含许多图标的图像）时，使用此属性。 ImageDownArrowLeft 属性的值可用于在创建页面时设置级联样式 HTML img 标记的 CSS left 属性。
ImageDownArrowTop
可选。 一个负整数，表示图像上边缘的偏移。 当 ImageDownArrow 属性指向一个图像文件（其中包含许多图标的图像）时，使用此属性。 ImageDownArrowTop 属性的值可用于在创建页面时设置级联样式 HTML img 标记的 CSS top 属性。
ImageSideArrow
可选。 文件相对于服务器的 URL，该文件包含要用于侧箭头的 16 X 16 像素图像。
ImageSideArrowClass
可选。 应用于侧箭头图像的 CSS 类选择器的名称。
ImageSideArrowLeft
可选。 一个负整数，表示图像左边缘的偏移。
ImageSideArrowTop
可选。 一个负整数，表示图像上边缘的偏移。
RootEventCommand
可选。 在功能区事件发生时要调用的默认命令的名称。
TabSwitchCommand
可选。 在更改活动的功能区选项卡时要调用的命令的名称。
ScaleCommand
可选。 在缩放功能区时要调用的命令的名称。
TextDirection
可选。 一个字符串，指定绘制文本的方向，例如“ltr”。
ToolTipFooterText
可选。 要在工具提示页脚中使用的文本。
ToolTipFooterImage16by16
可选。 文件相对于服务器的 URL，该文件包含要用于工具提示页脚的 16 X 16 像素图像，例如“/_layouts/1033/images/formatmap16x16.png”。
ToolTipFooterImage16by16Class
可选。 应用于图像的 CSS 类选择器的名称。
ToolTipFooterImage16by16Left
可选。 一个负整数，表示图像左边缘的偏移。
ToolTipFooterImage16by16Top
可选。 一个负整数，表示图像上边缘的偏移。
ToolTipDisabledCommandImage16by16
可选。 文件相对于服务器的 URL，该文件包含禁用控件时要在工具提示中使用的 16 X 16 像素图像。
ToolTipDisabledCommandImage16by16Class
可选。 应用于图像的 CSS 类选择器的名称。
ToolTipDisabledCommandImage16by16Left
可选。 一个负整数，表示图像左边缘的偏移。
ToolTipDisabledCommandImage16by16Top
可选。 一个负整数，表示图像上边缘的偏移。
ToolTipDisabledCommandDescription
可选。 禁用控件时工具提示的文本。
ToolTipDisabledCommandTitle
可选。 禁用控件时工具提示的标题。
ToolTipDisabledCommandHelpKey
可选。 禁用控件时调用“帮助”的键。
ToolTipHelpCommand
可选。 禁用控件时调用“帮助”的命令的名称。
ToolTipSelectedItemTitlePrefix
可选。 针对所选项的工具提示的标题前缀。
ShortcutKeyJumpToRibbon_Ctrl
可选。 “t”或“f”，指示是否按 Ctrl 键对第一个功能区选项卡设置焦点。
ShortcutKeyJumpToRibbon_Alt
可选。 “t”或“f”，指示是否按 Alt 键对第一个功能区选项卡设置焦点。
ShortcutKeyJumpToRibbon_Shift
可选。 “t”或“f”，指示是否按 Shift 键对第一个功能区选项卡设置焦点。
ShortcutKeyJumpToRibbon_AccessKey
可选。 一个字符的字符串，指定对第一个功能区选项卡设置焦点时应按的键。
ShortcutKeyJumpToFirstControl_Ctrl
可选。 “t”或“f”，指示是否按 Ctrl 键对第一个控件设置焦点。
ShortcutKeyJumpToFirstControl_Alt
可选。 “t”或“f”，指示是否按 Alt 键对第一个控件设置焦点。
ShortcutKeyJumpToFirstControl_Shift
可选。 “t”或“f”，指示是否按 Shift 键对第一个控件设置焦点。
ShortcutKeyJumpToFirstControl_AccessKey
可选。 一个单字符字符串，指定应按下以在第一个控件上设置焦点的键。
ATContextualTabText
可选。 隐藏文本，用于向屏幕阅读器传达上下文选项卡信息，例如 “ {0} 组。 选项卡 {1} 。 {2}”
ATTabPositionText
可选。 用于向屏幕阅读器传达选项卡信息的隐藏文本，例如“的选项卡{0}{1}”。
NavigationHelpText
可选。 说明如何使用键盘导航功能区的消息文本，该文本显示为屏幕读取器的隐藏文字。

子元素

父元素

出现次数

  • 最小值：0
  • 最大值：1

另请参阅