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

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

Представляет заполнитель для элемента управления в элементе GroupTemplate.

<ControlRef
  DisplayMode="Small | Medium | Large | Menu | Menu16 | Menu32"
  TemplateAlias="Text"
/>

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

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

Атрибуты

Атрибут	Описание
DisplayMode	Необязательный параметр. Значение перечисления, определяющее способ отрисовки элемента управления: - Маленький. Элемент управления отображается в виде маленького значка без надписи. - Средний. Элемент управления отображается в виде значка размером 16 на 16 пикселей с надписью. - Большой. Элемент управления отображается в виде значка размером 32 на 32 пикселя с надписью. - Меню. Элемент управления отображается в виде текстового пункта меню. - Меню16. Элемент управления отображается в виде текстового пункта меню со значком размером 16 на 16 пикселей. - Меню32. Элемент управления отображается в виде текстового пункта меню со значком размером 32 на 32 пикселя.
TemplateAlias	Необязательный параметр. Строка, на которую элемент управления может ссылаться в собственном атрибуте TemplateAlias. Атрибут TemplateAlias используется для задания размера и положения элементов управления в группе при применении шаблона к группе. Каждый элемент в одном элементе GroupTemplate должен иметь уникальное значение TemplateAlias.

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

Нет

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

• Row
• Полосы

Occurrences

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

Замечания

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

Control	Small	Средний	Large	Меню	Меню16	Меню32
Button	X	X	X	X	X	X
CheckBox	X	X
Colorpicker				X
ComboBox		X
DropDown		X
FlyoutAnchor	X	X	X	X	X	X
GalleryButton			X	X
InsertTable				X
Label	X	X
MenuSection					X	X
MRUSplitButton	X	X	X
Индикатор работы		X
SplitButton	X	X	X
TextBox		X
ToggleButton	X	X	X

Пример

В следующем примере приведен фрагмент XML-кода, в котором показано отношение между атрибутом TemplateAlias для элементов управления в элементе Group и тем же атрибутом для элементов ControlRef в элементе GroupTemplate.

Обратите внимание, что элемент Group содержит три элемента Button , для каждого из которых атрибут TemplateAlias имеет значение "row1", "row2"или "row3".

Элемент GroupTemplate также содержит три элемента ControlRef , атрибуты которых имеют значение "row1", "row2"или "row3".

При применении шаблона к группе макет элементов управления в группе определяется посредством сопоставления атрибута TemplateAlias элемента Button с атрибутом TemplateAlias элемента ControlRef.

<Group
  Id="Ribbon.CustomTabExample.CustomGroupExample"
  Description="This is a custom group."
  Title="Custom Group"
  Sequence="52"
  Template="Ribbon.Templates.CustomTemplateExample">
  <Controls Id="Ribbon.CustomTabExample.CustomGroupExample.Controls">
    <Button
      Id="Ribbon.CustomTabExample.CustomGroupExample.HelloWorld"
      Command="CustomTabExample.HelloWorldCommand"
      Sequence="15"
      Description="Says hello to the World!"
      LabelText="Hello!"
      TemplateAlias="row1"/>
    <Button
      Id="Ribbon.CustomTabExample.CustomGroupExample.GoodbyeWorld"
      Command="CustomTabExample.GoodbyeWorldCommand"
      Sequence="17"
      Description="Says goodbye to the World!"
      LabelText="Goodbye!"
      TemplateAlias="row2"/>
    <Button
      Id="Ribbon.CustomTabExample.CustomGroupExample.LaterWorld"
      Command="CustomTabExample.LaterWorldCommand"
      Sequence="19"
      Description="Says I will see you later to the World!"
      LabelText="Later!"
      TemplateAlias="row3"/>
  </Controls>
</Group>
<GroupTemplate Id="Ribbon.Templates.CustomTemplateExample">
  <Layout
    Title="OneLargeTwoMedium"
    LayoutTitle="OneLargeTwoMedium">
    <Section Alignment="Top" Type="OneRow">
      <Row>
        <ControlRef DisplayMode="Large" TemplateAlias="row1" />
      </Row>
    </Section>
    <Section Alignment="Top" Type="TwoRow">
      <Row>
        <ControlRef DisplayMode="Medium" TemplateAlias="row2" />
      </Row>
      <Row>
        <ControlRef DisplayMode="Medium" TemplateAlias="row3" />
      </Row>
    </Section>
  </Layout>
</GroupTemplate>