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


Элемент Label

Дата последнего изменения: 9 марта 2015 г.

Применимо к: SharePoint Foundation 2010

В этой статье
Атрибуты
Дочерние элементы
Родительские элементы
Вхождения

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

<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

Необязательный атрибут. Текст надписи.

Image16by16

Необязательный атрибут. 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

Необязательный атрибут. Имя команды, которая выполняется при запросе сведений о состоянии.

Command

Необязательный атрибут. Имя команды, которая выполняется, когда надпись оказывается в фокусе.

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

Нет

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

CommandUIDefinition

Controls

Вхождения

Минимум: 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>