Compartir a través de

Elemento ControlRef (cinta de opciones del servidor)

Se aplica a: SharePoint 2016 | SharePoint Foundation 2013 | SharePoint Online | SharePoint Server 2013

Representa un marcador de posición para un control en un elemento GroupTemplate.

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

Elementos y atributos

En las siguientes secciones se describen los atributos, elementos secundarios y elementos primarios.

Atributos

Atributo Descripción
DisplayMode
Opcional. Valor de enumeración que determina cómo se representa un control:

- Pequeño. Representa un icono pequeño sin texto de etiqueta.
- Medio. Se representa como un icono de 16x16 píxeles con texto de etiqueta.
- Grande. Se presenta como un icono de 32x32 píxeles con texto de etiqueta.
- Menú. Se representa como un elemento de menú de solo texto.
- Menú16. Se representa como un elemento de menú con un icono de 16x16 píxeles.
- Menú32. Se representa como un elemento de menú con un icono de 32x32 píxeles.
TemplateAlias
Opcional. Cadena a la que un control puede hacer referencia en su propio atributo TemplateAlias. El atributo TemplateAlias se usa para cambiar el tamaño de los controles y posicionarlos en un grupo cuando se aplica una plantilla al grupo. Dos elementos que se incluyen en el mismo elemento GroupTemplate no deberían tener el mismo valor TemplateAlias.

Elementos secundarios

Ninguno

Elementos principales

Repeticiones

  • Mínimo: 0
  • Máximo: sin límite

Comentarios

Los controles no admiten necesariamente todos los modos de presentación. La siguiente tabla enumera los modos admitidos por cada tipo de control.


Control Small Medio Large Menú Menú16 Menú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
Control de giro
X
SplitButton
X
 X
 X
TextBox
X
Togglebutton
X
 X
 X

Ejemplo

El siguiente ejemplo es un fragmento XML que muestra la relación entre el atributo TemplateAlias para los controles de un elemento Group y el mismo atributo para los elementos ControlRef de un elemento GroupTemplate.

Observe que el elemento Group contiene tres elementos Button , cada uno con un atributo TemplateAlias establecido en un valor de "row1", "row2"o "row3".

El elemento GroupTemplate también contiene tres elementos ControlRef que tienen atributos establecidos en un valor de "row1", "row2"o "row3".

Cuando la plantilla se aplica al grupo, el diseño de los controles del grupo se determina al hacer coincidir el atributo TemplateAlias de un elemento Button al atributo TemplateAlias de un elemento 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>