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


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

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

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

<Label
  ForId="Text"
  Id="Text"
  LabelText="Text"
  Image16by16="Url"
  Image16by16Class="CSS Class Selector"
  Image16by16Left="Negative Integer"
  Image16by16Top="Negative Integer"
  Sequence="Integer"
  TemplateAlias="Text"
  QueryCommand="Text"
  Command="Text"
/>

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

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

Атрибуты

Атрибут Описание
ForId
Необязательный параметр. Идентификатор элемента управления, к которому относится данная надпись.
Id
Обязательно. Строка, идентифицирующая элемент управления, например, "Ribbon.Image.Image.Size.HorizontalSizeLabel".
LabelText
Необязательный параметр. Текст надписи.
Изображение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.
Sequence
Необязательный параметр. Целое число, определяющее положение элемента среди XML-узлов того же уровня.
TemplateAlias
Необязательный параметр. Строка, соответствующая значению атрибута TemplateAlias для элемента ControlRef, OverflowArea или OverflowSection в элементе GroupTemplate. Атрибут TemplateAlias используется для задания размера и положения элементов управления в группе при применении шаблона к группе.
QueryCommand
Необязательный параметр. Имя команды, которая выполняется при запросе сведений о состоянии.
Команда
Необязательный параметр. Имя команды, которая выполняется, когда надпись оказывается в фокусе.

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

Нет

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

Occurrences

  • Минимум: 0
  • Максимум: 1

Пример

В следующем примере приведен фрагмент XML-кода, в котором показан элемент Controls, содержащий два элемента управления "текстовое поле" и две надписи для них

<Controls Id="Ribbon.Link.Link.Properties.Controls">
  <Label
    Id="Ribbon.Link.Link.Properties.LinkAddressLabel"
    LabelText="$Resources:core,LabelLinkAddress;"
    Command="LinkUrlLabel"
    ForId="Ribbon.Link.Link.Properties.LinkAddress"
    Sequence="10"
    Image16by16="/_layouts/$Resources:core,Language;/images/formatmap16x16.png" Image16by16Top="-160" Image16by16Left="-224"
    TemplateAlias="o1"/>
  <TextBox
    Id="Ribbon.Link.Link.Properties.LinkAddress"
    Command="LinkUrlChanged"
    ToolTipTitle="$Resources:core,cui_LinkAddress;"
    ToolTipDescription="$Resources:core,cui_STT_LinkAddress;"
    QueryCommand="QueryLinkUrl"
    MaxLength="512"
    TemplateAlias="o2"
    Sequence="20"
                />
  <Label
    Id="Ribbon.Link.Link.Properties.LinkTooltipLabel"
    LabelText="$Resources:core,LabelLinkTooltip;"
    Command="LinkAltLabel"
    ForId="Ribbon.Link.Link.Properties.LinkTooltip"
    Image16by16="/_layouts/$Resources:core,Language;/images/formatmap16x16.png" Image16by16Top="0" Image16by16Left="-88"
    Sequence="30"
    TemplateAlias="o1"/>
  <TextBox
    ToolTipTitle="$Resources:core,cui_LinkTooltip;"
    ToolTipDescription="$Resources:core,cui_STT_LinkTooltip;"
    Id="Ribbon.Link.Link.Properties.LinkTooltip"
    Command="LinkTitleChanged"
    QueryCommand="QueryLinkTitle"
    MaxLength="128"
    Sequence="40"
    TemplateAlias="o2"/>
</Controls>