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

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

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

<CheckBox
     Alt="Text"
     Command="Text"
     Id="Text"
     LabelText="Text"
     MenuItemId="Text"
     QueryCommand="Text"
     Sequence="Integer"
     TemplateAlias="Text"
     ToolTipImage32by32="Url"
     ToolTipImage32by32Class="CSS Class Selector"
     ToolTipImage32by32Left="Negative Integer"
     ToolTipImage32by32Top="Negative Integer"
     ToolTipTitle="Text"
     ToolTipDescription="Text"
     ToolTipHelpKeyWord="Text"
     ToolTipShortcutKey="Text"
/>

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

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

Атрибуты

Атрибут	Описание
Alt	Необязательный параметр. Альтернативный текст для флажка.
Команда	Необязательный параметр. Имя команды, выполняемой при выборе элемента управления. Если элемент управления находится в элементе CommandUIDefinition, значение атрибута Command этого элемента управления должно совпадать со значением атрибута Command соответствующего элемента CommandUIHandler.
Id	Обязательно. Идентифицирует элемент управления. Значение может быть строковым представлением GUID-идентификатора или уникальным термом, например, "Ribbon.Library.Share.NewRibbonCheckBox".
LabelText	Необязательный параметр. Текст надписи элемента управления.
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 для встроенного стиля HTML-тега img.
ToolTipImage32by32Top	Необязательный параметр. Отрицательное целое число, определяющее смещение верхнего края изображения. Этот атрибут используется в том случае, если атрибут ToolTipImage32by32 указывает на файл, в котором хранятся изображения нескольких значков. Значение атрибута ToolTipImage32by32Top используется для задания атрибута CSS top для встроенного стиля HTML-тега img.
ToolTipTitle	Необязательный параметр. Текст, отображаемый в качестве заголовка всплывающей подсказки.
ToolTipDescription	Необязательный параметр. Текст, отображаемый в качестве основного текста всплывающей подсказки.
ToolTipHelpKeyWord	Необязательный параметр. Ключевое слово, используемое в контекстной справке.
ToolTipShortcutKey	Необязательный параметр. Сочетание клавиш, отображаемое во всплывающей подсказке. Например, если сочетание клавиш для элемента управления — ALT+J, значение для этого атрибута — "ALT+J". Подсказка будет отображать текст для сочетания клавиш в круглых скобках после заголовка подсказки:(ALT+J)".

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

Нет

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

CommandUIDefinition
Controls (Group)

Occurrences

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

Пример

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

<Group
  Id="Ribbon.Image.Image.Size"
  Sequence="50"
  Command="ImageSizeGroup"
  Description=""
  Title="$Resources:core,GrpSize;"
  Image32by32Popup="/_layouts/$Resources:core,Language;/images/formatmap32x32.png" Image32by32PopupTop="-128" Image32by32PopupLeft="0"
  Template="Ribbon.Templates.Flexible2"
>
  <Controls Id="Ribbon.Image.Image.Size.Controls">
    <Label
      Id="Ribbon.Image.Image.Size.HorizontalSizeLabel"
      LabelText="$Resources:core,LabelHorizSize;"
      Command="ImageHorizontalLabel"
      ForId="Ribbon.Image.Image.Size.HorizontalSize"
      Image16by16="/_layouts/$Resources:core,Language;/images/formatmap16x16.png" Image16by16Top="-80" Image16by16Left="-16"
      TemplateAlias="o1"
      Sequence="10"
    />
    <Spinner
       Id="Ribbon.Image.Image.Size.HorizontalSize"
       DefaultUnit="pixel"
       DefaultValue="10"
       AltUpArrow="$Resources:core,cui_spnUpAlt;"
       AltDownArrow="$Resources:core,cui_spnDownAlt;"
       AccelerationInterval="125"
       MultiplierInterval="2000"
       ImeEnabled="false"
       Command="ImageWidth"
       QueryCommand="QueryImageWidth"
       ToolTipTitle="$Resources:core,LabelHorizSize;"
       ToolTipDescription="$Resources:core,cui_stt_ButSizeMenuHorizontalSizeTooltip;"
       TemplateAlias="o2"
      Sequence="20"
    >
      <Unit
          Name="pixel"
          MinimumValue="1"
          MaximumValue="2000"
          DecimalDigits="0"
          Interval="5"
        >
        <UnitAbbreviation Value="px" />
      </Unit>
      <Unit
          Name="percent"
          MinimumValue="1"
          MaximumValue="100"
          DecimalDigits="0"
          Interval="1"
        >
        <UnitAbbreviation Value="%" />
      </Unit>
    </Spinner>
    <Label
      Id="Ribbon.Image.Image.Size.VertSizeLabel"
      LabelText="$Resources:core,LabelVertSize;"
      Command="ImageVerticalLabel"
      ForId="Ribbon.Image.Image.Size.VerticalSize"
      Image16by16="/_layouts/$Resources:core,Language;/images/formatmap16x16.png" Image16by16Top="-208" Image16by16Left="-224"
      TemplateAlias="o1"
      Sequence="30"
    />
    <Spinner
      Id="Ribbon.Image.Image.Size.VerticalSize"
      DefaultUnit="pixel"
      DefaultValue="10"
      AltUpArrow="$Resources:core,cui_spnUpAlt;"
      AltDownArrow="$Resources:core,cui_spnDownAlt;"
      AccelerationInterval="125"
      MultiplierInterval="2000"
      Command="ImageHeight"
      ImeEnabled="false"
      QueryCommand="QueryImageHeight"
      ToolTipTitle="$Resources:core,LabelVertSize;"
      ToolTipDescription="$Resources:core,cui_stt_ButSizeMenuVerticalSizeTooltip;"
      TemplateAlias="o2"
      Sequence="40"
    >
      <Unit
          Name="pixel"
          MinimumValue="1"
          MaximumValue="2000"
          DecimalDigits="0"
          Interval="5"
        >
        <UnitAbbreviation Value="px" />
      </Unit>
      <Unit
          Name="percent"
          MinimumValue="1"
          MaximumValue="100"
          DecimalDigits="0"
          Interval="1"
        >
        <UnitAbbreviation Value="%" />
      </Unit>
    </Spinner>
    <CheckBox
      Id="Ribbon.Image.Image.Size.LockAspect"
      Command="ImageLockRatio"
      QueryCommand="QueryImageLockRatio"
      LabelText="$Resources:core,LabelLockAspect;"
      Alt="$Resources:core,ButLockAspectAlt;"
      TemplateAlias="o2"
      Sequence="50"
    />
  </Controls>
</Group>

Last updated on 2023-04-08