Поделиться через

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

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

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

<Button
     Alt="Text"
     Command="Text"
     CommandType="General | OptionSelect | IgnoredByMenu"
     CommandValueId="Text"
     Description="Text"
     Id="Text"
     Image32by32="Url"
     Image32by32Class="CSS Class Selector"
     Image32by32Left="Negative Integer"
     Image32by32Top="Negative Integer"
     Image16by16="Url"
     Image16by16Class="CSS Class Selector"
     Image16by16Left="Negative Integer"
     Image16by16Top="Negative Integer"
     LabelCss="Text"
     LabelText="Text"
     MenuItemId="Text"
     Sequence="Integer"
     TemplateAlias="Text"
     ToolTipImage32by32="Url"
     ToolTipImage32by32Class="Text"
     ToolTipImage32by32Left="Negative Integer"
     ToolTipImage32by32Top="Negative Integer"
     ToolTipTitle="Text"
     ToolTipDescription="Text"
     ToolTipHelpKeyWord="Text"
     ToolTipShortcutKey="Text"
/>

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

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

Атрибуты

Атрибут Описание
Alt
Необязательный параметр. Альтернативный текст для кнопки.
Команда
Необязательный параметр. Имя команды, выполняемой при выборе элемента управления. Если элемент управления находится в элементе CommandUIDefinition, значение атрибута Command этого элемента управления должно совпадать со значением атрибута Command соответствующего элемента CommandUIHandler.
CommandType
Необязательный параметр. Значение перечисления, указывающее тип команды.

Общие. Команда неопределенного типа.

OptionSelection. Команда, создаваемая при выборе пользователем одного из параметров в группе параметров.

ИгнорируетсяByMenu. Команда, используемая для элементов управления, которые не должны закрывать меню при выборе.
CommandValueId
Необязательный параметр. Строка, которая отправляется с событием команды при нажатии кнопки.
Описание
Необязательный параметр. Строка, описывающая кнопку. Описание отображается только в том случае, если кнопка находится в меню и отображается в режиме отображения Menu32 .
Id
Обязательно. Строка идентифицирующая элемент управления, например, "Ribbon.Library.Share.NewRibbonButton".
Изображение32by32
Необязательный параметр. URL-адрес файла, который содержит изображение размерами 32 на 32 пикселя, используемое в качестве значка, например "/_layouts/1033/images/formatmap32x32.png".
Image32by32Class
Необязательный параметр. Имя селектора класса CSS, предназначенного для применения к изображению.
Image32by32Left
Необязательный параметр. Отрицательное целое число, определяющее смещение левого края изображения. Этот атрибут используется в том случае, если атрибут Image32by32 указывает на файл, в котором хранятся изображения нескольких значков.

Значение атрибута Image32by32Left используется для задания атрибута CSS left для встроенного стиля HTML-тега img. Например, установка атрибута Image32by32Left значения "-160", а атрибута Image32by32Top — "-448", приводит к созданию встроенного стиля, похожего на стиль в следующей разметке HTML:
HTML<img src="/_layouts/1033/images/formatmap32x32.png" style="position: absolute;left: -160px;top: -448px;" />
Image32by32Top
Необязательный параметр. Отрицательное целое число, определяющее смещение верхнего края изображения. Этот атрибут используется в том случае, если атрибут Image32by32 указывает на файл, в котором хранятся изображения нескольких значков. Значение атрибута Image32by32Top используется для задания атрибута CSS top для встроенного стиля HTML-тега img.
Изображение16by16
Необязательный параметр. URL-адрес файла, который содержит изображение размерами 16 на 16 пикселей, используемое в качестве значка, например "/_layouts/1033/images/formatmap16x16.png".
Image16by16Class
Необязательный параметр. Имя селектора класса CSS, предназначенного для применения к изображению.
Image16by16Left
Необязательный параметр. Отрицательное целое число, определяющее смещение левого края изображения. Этот атрибут используется в том случае, если атрибут Image16by16 указывает на файл, в котором хранятся изображения нескольких значков. Значение атрибута Image16by16Left используется для задания атрибута CSS left для встроенного стиля HTML-тега img.
Image16by16Top
Необязательный параметр. Отрицательное целое число, определяющее смещение верхнего края изображения. Этот атрибут используется в том случае, если атрибут Image16by16 указывает на файл, в котором хранятся изображения нескольких значков. Значение атрибута Image16by16Top используется для задания атрибута CSS top для встроенного стиля HTML-тега img.
LabelCss
Необязательный параметр. Имя селектора класса CSS, предназначенного для применения к надписи элемента управления.
LabelText
Необязательный параметр. Текст надписи элемента управления.
MenuItemId
Необязательный параметр. Строка, идентифицирующая пункт меню, в котором находится кнопка.
Sequence
Необязательный параметр. Целое число, определяющее положение элемента среди XML-узлов того же уровня.
TemplateAlias
Необязательный параметр. Строка, соответствующая значению атрибута TemplateAlias для элемента ControlRef, OverflowArea или OverflowSection в элементе GroupTemplate. Атрибут TemplateAlias используется для задания размера и положения элементов управления в группе при применении шаблона к группе.
ToolTipImage32by32
Необязательный параметр. URL-адрес файла, который содержит изображение размерами 32 на 32 пикселя, используемое в подсказке, например "/_layouts/1033/images/formatmap32x32.png".
ToolTipImage32by32Class
Необязательный параметр. Имя селектора класса CSS, предназначенного для применения к изображению.
ToolTipImage32by32Left
Необязательный параметр. Отрицательное целое число, определяющее смещение левого края изображения. Этот атрибут используется в том случае, если атрибут ToolTipImage32by32 указывает на файл, в котором хранятся изображения нескольких значков. Значение атрибута ToolTipImage32by32Left используется при создании страницы для задания атрибута CSS left.
ToolTipImage32by32Top
Необязательный параметр. Отрицательное целое число, определяющее смещение верхнего края изображения. Этот атрибут используется в том случае, если атрибут ToolTipImage32by32 указывает на файл, в котором хранятся изображения нескольких значков. Значение атрибута ToolTipImage32by32Top используется при создании страницы для задания атрибута CSS top.
ToolTipTitle
Необязательный параметр. Текст, отображаемый в качестве заголовка всплывающей подсказки.
ToolTipDescription
Необязательный параметр. Текст, отображаемый в качестве основного текста всплывающей подсказки.
ToolTipHelpKeyWord
Необязательный параметр. Ключевое слово, используемое в контекстной справке.
ToolTipShortcutKey
Необязательный параметр. Сочетание клавиш, отображаемое во всплывающей подсказке. Например, если сочетание клавиш для элемента управления — ALT+J, значение для этого атрибута — "ALT+J". Подсказка будет отображать текст для сочетания клавиш в круглых скобках после заголовка подсказки:(ALT+J)".

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

Нет

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

Occurrences

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

Пример

В следующем примере показано, как добавить элемент управления "Кнопка" на ленту сервера. В примере кнопка "Справка " добавляется на ленту в той же группе, что и встроенные элементы управления "Создать документ", "Создать папку" и "Отправить документ ".

<?xml version="1.0" encoding="utf-8"?>
<Elements xmlns="http://schemas.microsoft.com/sharepoint/">
  <CustomAction
    Id="NewUIRibbonControl"
    RegistrationType="List"
    RegistrationId="101"
    Location="CommandUI.Ribbon">
    <CommandUIExtension>
      <CommandUIDefinitions>
        <CommandUIDefinition
           Location="Ribbon.Documents.New.Controls._children">
          <Button
             Id="NewUIRibbonControl.ShowHelp"
             Alt="Help"
             Sequence="1981"
             Command="ShowHelp"
             Image32by32="/_layouts/images/newui/dochelp.png"
             LabelText="Help"
             TemplateAlias="o1"/>
        </CommandUIDefinition>
      </CommandUIDefinitions>
      <CommandUIHandlers>
        <CommandUIHandler
         Command="ShowHelp"
         CommandAction="javascript:window.open('https://msdn.microsoft.com/library/ee539395%28office.14%29.aspx');" />
      </CommandUIHandlers>
    </CommandUIExtension>
  </CustomAction>
</Elements>

См. также

  • Last updated on