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

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

Определяет кнопку галереи.

<GalleryButton
  Alt="Text"
  Command="Text"
  CommandPreview="Text"
  CommandRevert="Text"
  CommandType="General | OptionSelect | IgnoredByMenu"
  CommandValueId="Text"
  ElementDimensions="Size16by16 | Size32by32 | Size48by48 | Size72by96 | Size96by72 | Size96by96 | Size128by128 | Size190by30 | Size190by40 | Size190by50 | Size190by60"
  Id="Text"
  Image="Url"
  ImageClass="CSS Selector"
  ImageLeft="Negative Integer"
  ImageTop="Negative Integer"
  InnerHTML="HTML"
  MenuItemId="Text"
  QueryCommand="Text"
  Sequence="Integer"
  TemplateAlias="Text"
  ToolTipImage32by32="Url"
  ToolTipImage32by32Class="CSS Selector"
  ToolTipImage32by32Left="Negative Integer"
  ToolTipImage32by32Top="Negative Integer"
  ToolTipTitle="Text"
  ToolTipDescription="Text"
  ToolTipHelpKeyWord="Text"
  ToolTipShortcutKey="Text"
/>

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

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

Атрибуты

Атрибут	Описание
Alt	Необязательный параметр. Альтернативный текст, используемый для элемента управления.
Команда	Необязательный параметр. Имя команды, выполняемой при выборе элемента управления. Если элемент управления находится в элементе CommandUIDefinition, значение атрибута Command этого элемента управления должно совпадать со значением атрибута Command соответствующего элемента CommandUIHandler.
CommandPreview	Необязательный параметр. Имя команды, которая выполняется для предварительного просмотра выделения.
CommandRevert	Необязательный параметр. Имя команды, которая выполняется для возврата в состояние, предшествующее предварительному просмотру выделения.
CommandType	Необязательный параметр. Значение перечисления, указывающее тип команды. Общие. Команда неопределенного типа. OptionSelection. Команда, создаваемая при выборе пользователем одного из параметров в группе параметров. ИгнорируетсяByMenu. Команда, используемая для элементов управления, которые не должны закрывать меню при их выборе.
CommandValueId	Необязательный параметр. Строка, которая отправляется с событием команды при нажатии кнопки.
ElementDimensions	Обязательно. Значение перечисления, определяющее размеры прямоугольника, в котором отображается кнопка. Размеры указываются в пикселях в формате "ширина x высота". Размер16by16 Размер32by32 Размер48by48 Размер72by96 Размер96by72 Размер96by96 Размер128by128 Размер190by30 Размер190by40 Размер190by50 Размер190by60
Id	Обязательно. Строка, идентифицирующая элемент, например buttonStaticStyle1.
Image	Необязательный параметр. Относительный к серверу URL-адрес файла, содержащего изображение значка. Если атрибут Image не определен, необходимо определить атрибут InnerHTML.
ImageClass	Необязательный параметр. Имя селектора класса CSS, предназначенного для применения к изображению.
ImageLeft	Необязательный параметр. Отрицательное целое число, определяющее смещение левого края изображения. Этот атрибут используется, когда атрибут Image указывает на файл, содержащий изображения для нескольких значков.
ImageTop	Необязательный параметр. Отрицательное целое число, определяющее смещение верхнего края изображения. Этот атрибут используется, когда атрибут Image указывает на файл, содержащий изображения для нескольких значков.
Innerhtml	Необязательный параметр. Разметка HTML, соответствующая выбору, представленному кнопкой. Если атрибут InnerHTML не определен, необходимо определить атрибут Image.
MenuItemId	Необязательный параметр. Строка, идентифицирующая пункт меню, в котором находится кнопка.
QueryCommand	Необязательный параметр. Имя команды, которая выполняется при запросе сведений о состоянии.
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)".

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

Нет

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

CommandUIDefinition
Controls (Group)

Occurrences

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

Пример

Ниже приводится фрагмент XML-кода, в котором определяется группа элементов управления кнопок галереи, которые используются для применения стилей форматирования.

<Group
    Id="grpStyles"
    Description=""
    Title="Group Styles"
    Template="tmpStyles">
    <Controls>
        <GalleryButton
            Id="buttonStaticStyle1"
            Command="ApplyStyle"
            QueryCommand="QueryStyle"
            InnerHTML="&amp;lt;DIV class=&amp;quot;PreviewStyleContainer&amp;quot;&amp;gt;&amp;lt;P class=&amp;quot;PreviewStaticStyle1&amp;quot; id=&amp;quot;labelPreviewContent0&amp;quot;&amp;gt;&amp;lt;/P&amp;gt;&amp;lt;P class=&amp;quot;PreviewStyleLabel&amp;quot; id=&amp;quot;labelPreviewStyle0&amp;quot;&amp;gt;&amp;lt;/P&amp;gt;&amp;lt;/DIV&amp;gt;"
            ElementDimensions="Size64by48"
            LabelText="Heading1"
            Alt="Heading1"
            TemplateAlias="preview1"/>
        <GalleryButton
            Id="buttonStaticStyle2"
            Command="ApplyStyle"
            QueryCommand="QueryStyle"
            InnerHTML="&amp;lt;DIV class=&amp;quot;PreviewStyleContainer&amp;quot;&amp;gt;&amp;lt;P class=&amp;quot;PreviewStaticStyle2&amp;quot; id=&amp;quot;labelPreviewContent1&amp;quot;&amp;gt;&amp;lt;/P&amp;gt;&amp;lt;P class=&amp;quot;PreviewStyleLabel&amp;quot; id=&amp;quot;labelPreviewStyle1&amp;quot;&amp;gt;&amp;lt;/P&amp;gt;&amp;lt;/DIV&amp;gt;"
            ElementDimensions="Size64by48"
            LabelText="Heading2"
            Alt="Heading2"
            TemplateAlias="preview2"/>
        <GalleryButton
            Id="buttonStaticStyle3"
            QueryCommand="QueryStyle"
            Command="ApplyStyle"
            InnerHTML="&amp;lt;DIV class=&amp;quot;PreviewStyleContainer&amp;quot;&amp;gt;&amp;lt;P class=&amp;quot;PreviewStaticStyle3&amp;quot; id=&amp;quot;labelPreviewContent2&amp;quot;&amp;gt;&amp;lt;/P&amp;gt;&amp;lt;P class=&amp;quot;PreviewStyleLabel&amp;quot; id=&amp;quot;labelPreviewStyle2&amp;quot;&amp;gt;&amp;lt;/P&amp;gt;&amp;lt;/DIV&amp;gt;"
            ElementDimensions="Size64by48"
            LabelText="Heading3"
            Alt="Heading3"
            TemplateAlias="preview3"/>
        <GalleryButton
            Id="buttonStaticStyle4"
            Command="ApplyStyle"
            QueryCommand="QueryStyle"
            InnerHTML="&amp;lt;DIV class=&amp;quot;PreviewStyleContainer&amp;quot;&amp;gt;&amp;lt;P class=&amp;quot;PreviewStaticStyle4&amp;quot; id=&amp;quot;labelPreviewContent3&amp;quot;&amp;gt;&amp;lt;/P&amp;gt;&amp;lt;P class=&amp;quot;PreviewStyleLabel&amp;quot; id=&amp;quot;labelPreviewStyle3&amp;quot;&amp;gt;&amp;lt;/P&amp;gt;&amp;lt;/DIV&amp;gt;"
            ElementDimensions="Size64by48"
            LabelText="Quote"
            Alt="Quote"
            TemplateAlias="preview4"/>
        <GalleryButton
            Id="buttonStaticStyle5"
            Command="ApplyStyle"
            QueryCommand="QueryStyle"
            InnerHTML="&amp;lt;DIV class=&amp;quot;PreviewStyleContainer&amp;quot;&amp;gt;&amp;lt;P class=&amp;quot;PreviewStaticStyle5&amp;quot; id=&amp;quot;labelPreviewContent4&amp;quot;&amp;gt;&amp;lt;/P&amp;gt;&amp;lt;P class=&amp;quot;PreviewStyleLabel&amp;quot; id=&amp;quot;labelPreviewStyle4&amp;quot;&amp;gt;&amp;lt;/P&amp;gt;&amp;lt;/DIV&amp;gt;"
            ElementDimensions="Size64by48"
            LabelText="Citation"
            Alt="Citation"
            TemplateAlias="preview5"/>
        <FlyoutAnchor
            Alt="STR@L_MenuMoreStyles"
            Id="fsfaMoreStyles"
            Command="MenuOpenEditOnly"
            MenuAlt="STR@L_MenuMoreStyles"
            LabelText="STR@L_MenuMoreStyles"
            Image32by32="IMGMAP@one@UxGalWordQuickFormatsHH"
            TemplateAlias="morestyles"
            PopulateDynamically="true"
            PopulateOnlyOnce="false"
            PopulateQueryCommand="PopulateMenuMoreStyles"
            CommandMenuClose="MenuClose"
            CacheMenuVersions="false">
        </FlyoutAnchor>
    </Controls>
</Group>

Last updated on 2023-04-08