Compartir a través de

Elemento Label (cinta de opciones del servidor)

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

Define un control de etiqueta.

<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"
/>

Elementos y atributos

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

Atributos

Atributo Descripción
ForId
Opcional. El identificador del control que este control etiqueta.
Id
Necesario. Una cadena que identifica el control, como "Ribbon.Image.Image.Size.HorizontalSizeLabel".
LabelText
Opcional. El texto de la etiqueta.
Imagen16by16
Opcional. Dirección URL relativa al servidor a un archivo que contiene una imagen de 16 por 16 píxeles que se usará como icono, como "/_layouts/1033/images/formatmap16x16.png".
Image16by16Class
Opcional. Nombre de un selector de clases CSS que se aplicará a la imagen.
Imagen16by16Left
Opcional. Entero negativo que representa un desplazamiento del borde izquierdo de la imagen. Use este atributo cuando el atributo Image16by16 señale a un archivo de imagen que contenga imágenes de varios iconos. El valor del atributo Image16by16Left se usa para establecer el atributo left de CSS para el estilo en línea de una etiqueta HTML img.
Image16by16Top
Opcional. Entero negativo que representa un desplazamiento del borde superior de la imagen. Use este atributo cuando el atributo Image16by16 señale a un archivo de imagen que contenga imágenes de varios iconos. El valor del atributo Image16by16Top se usa para establecer el atributo top de CSS para el estilo en línea de una etiqueta HTML img.
Sequence
Opcional. Entero que especifica el orden de colocación entre nodos XML del mismo nivel.
TemplateAlias
Opcional. Cadena que coincide con el valor del atributo TemplateAlias de un elemento ControlRef, un elemento OverflowArea o un elemento OverflowSection en un elemento GroupTemplate. El atributo TemplateAlias se usa para cambiar el tamaño de los controles y posicionarlos dentro de un grupo cuando se aplica una plantilla al grupo.
QueryCommand
Opcional. El nombre del comando que debe ejecutarse cuando se realiza un sondeo de la información de estado.
Command
Opcional. El nombre del comando que debe ejecutarse cuando la etiqueta recibe el foco.

Elementos secundarios

Ninguno

Elementos principales

Repeticiones

  • Mínimo: 0
  • Máximo: 1

Ejemplo

El siguiente ejemplo es un fragmento de XML que muestra un elemento Controls que contiene dos controles de cuadros de texto y dos etiquetas para ellos.

<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>
  • Last updated on