Elemento ControlRef

Artículo
09/24/2014

Última modificación: miércoles, 13 de octubre de 2010

Hace referencia a: SharePoint Foundation 2010

En este artículo
Atributos
Elementos secundarios
Elementos primarios
Repeticiones
Comentarios

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

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

Atributos

Atributo	Descripción
DisplayMode	Opcional. Valor de enumeración que determina la forma en que se representa un control. Small. Representa un icono pequeño sin texto de etiqueta. Medium. Se representa como un icono de 16x16 píxeles con texto de etiqueta. Large. Se representa como un icono de 32x32 píxeles con texto de etiqueta. Menu. Se representa como un elemento de menú de solo texto. Menu16. Se representa como un elemento de menú con un icono de 16x16 píxeles. Menu32. 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.

DisplayMode

Opcional. Valor de enumeración que determina la forma en que se representa un control.

Small. Representa un icono pequeño sin texto de etiqueta.
Medium. Se representa como un icono de 16x16 píxeles con texto de etiqueta.
Large. Se representa como un icono de 32x32 píxeles con texto de etiqueta.
Menu. Se representa como un elemento de menú de solo texto.
Menu16. Se representa como un elemento de menú con un icono de 16x16 píxeles.
Menu32. 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 primarios

Elemento Row

Elemento Strip

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.

	Pequeño	Mediano	Grande	Menú	Menu16	Menu32
Botón	X	X	X	X	X	X
Elemento CheckBox	X	X
Elemento ColorPicker				X
Elemento ComboBox		X
Elemento DropDown		X
Elemento FlyoutAnchor	X	X	X	X	X	X
Elemento GalleryButton			X	X
Elemento InsertTable				X
Elemento Label	X	X
Elemento MenuSection					X	X
Elemento MRUSplitButton	X	X	X
Elemento Spinner		X
Elemento SplitButton	X	X	X
Elemento TextBox		X
Elemento 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. Tenga en cuenta que el elemento Group contiene tres elementos Button, cada uno con un atributo TemplateAlias establecido en un valor de "fila1", "fila2" o "fila3". El elemento GroupTemplate también contiene tres elementos ControlRef que tienen atributos establecidos en un valor de "fila1", "fila2" o "fila3". 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>

Compartir a través de