Элемент Group (лента сервера)

Применимо к: SharePoint 2016 | SharePoint Foundation 2013 | SharePoint Online | SharePoint Server 2013

Определяет группу элементов управления.

<Group
  Command="Text"
  Description="Text"
  Id="Text"
  Image32by32Popup="Url"
  Image32by32PopupClass="CSS Class Selector"
  Image32by32PopupLeft="Negative Integer"
  Image32by32PopupTop="Negative Integer"
  Sequence="Integer"
  Template="Text"
  Title="Text"
/>

Элементы и атрибуты

В разделах ниже приводится описание атрибутов, дочерних и родительских элементов.

Атрибуты

Атрибут Описание
Команда
Необязательный параметр. Это значение используется для включения или отключения элементов управления в группе. Если атрибут Command присутствует и для него задано значение, лента выполняет опрос, проверяя, отключена ли команда. Если команда отключена, лента не опрашивает никакие команды, связанные с элементами управления в группе; эти элементы управления также отключаются.
Описание
Необязательный параметр. Описание группы.
Id
Обязательно. Строка, определяющая группу, например "Ribbon.DocLibListForm.Edit.Clipboard".
Image32by32Popup
Необязательный параметр. URL-адрес файла, который содержит изображение размерами 32 на 32 пикселя, используемое для представления группы, например "/_layouts/1033/images/formatmap32x32.png".
Image32by32PopupClass
Необязательный параметр. Имя селектора класса CSS, предназначенного для применения к изображению.
Image32by32PopupLeft
Необязательный параметр. Отрицательное целое число, определяющее смещение левого края изображения. Этот атрибут используется в том случае, если атрибут Image32by32Popup указывает на файл, в котором хранятся изображения нескольких значков. Значение атрибута Image32by32PopupLeft используется для задания атрибута CSS left для встроенного стиля HTML-тега img.
Image32by32PopupTop
Необязательный параметр. Отрицательное целое число, определяющее смещение верхнего края изображения. Этот атрибут используется в том случае, если атрибут Image32by32Popup указывает на файл, в котором хранятся изображения нескольких значков. Значение атрибута Image32by32PopupTop используется для задания атрибута CSS top для встроенного стиля HTML-тега img.
Sequence
Необязательный параметр. Целое число, определяющее положение элемента среди XML-узлов того же уровня.
шаблон.
Необязательный параметр. Строка, соответствующая атрибуту Id элемента GroupTemplate.
Title
Необязательный параметр. Текст, отображаемый в виде заголовка группы на ленте и в подсказке.

Дочерние элементы

Родительские элементы

Occurrences

  • Минимум: 0
  • Максимум: без ограничений

Пример

В следующем фрагменте XML-кода определяется группа, содержащая две кнопки.

<Group
  Id="Ribbon.WikiPageTab.CustomGroup"
  Sequence="55"
  Description="Custom Group"
  Title="Custom"
  Command="EnableCustomGroup"
  Template="Ribbon.Templates.Flexible2">
  <Controls Id="Ribbon.WikiPageTab.CustomGroup.Controls">
    <Button
      Id="Ribbon.WikiPageTab.CustomGroup.CustomGroupHello"
      Command="CustomGroupHelloWorld"
      Image16by16="/_layouts/images/FILMSTRP.GIF"
      Image32by32="/_layouts/images/PPEOPLE.GIF"
      LabelText="Hello, World"
      TemplateAlias="o2"
      Sequence="15" />
    <Button
      Id="Ribbon.WikiPageTab.CustomGroup.CustomGroupGoodbye"
      Command="CustomGroupGoodbyeWorld"
      Image16by16="/_layouts/images/FILMSTRP.GIF"
      Image32by32="/_layouts/images/PPEOPLE.GIF"
      LabelText="Good-bye, World"
      TemplateAlias="o2"
      Sequence="18" />
  </Controls>
</Group>

См. также