Compartir a través de


Elemento Label

Última modificación: viernes, 15 de octubre de 2010

Hace referencia a: SharePoint Foundation 2010

En este artículo
Atributos
Elementos secundarios
Elementos primarios
Repeticiones

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

Atributos

Atributo

Descripción

ForId

Opcional. El identificador del control que este control etiqueta.

Id

Obligatorio. Una cadena que identifica el control, como "Ribbon.Image.Image.Size.HorizontalSizeLabel".

LabelText

Opcional. El texto de la etiqueta.

Image16by16

Opcional. Dirección URL relativa a un servidor en un archivo que contiene una imagen de 16x16 píxeles que se usará como icono, tal como "/_layouts/1033/images/formatmap16x16.png".

Image16by16Class

Opcional. El nombre de un selector de clases CSS que se aplicará a la imagen.

Image16by16Left

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 primarios

Elemento CommandUIDefinition

Elemento Controls

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>