Elemento Label (Server Ribbon)

Artigo
04/08/2023

Aplica-se a: SharePoint 2016 | SharePoint Foundation 2013 | | do SharePoint Online SharePoint Server 2013

Define um controle de rótulo.

<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 e atributos

As seções a seguir descrevem os atributos, os elementos filhos e os elementos pai.

Atributos

Atributo	Descrição
ForId	Opcional. A ID do controle que esse controle rotula.
Id	Obrigatório. Uma cadeia de caracteres que identifica o controle, como "Ribbon.Image.Image.Size.HorizontalSizeLabel".
Labeltext	Opcional. O texto do rótulo.
Imagem16by16	Opcional. Uma URL relativa ao servidor a um arquivo que contém uma imagem de 16 por 16 pixels a ser usada como um ícone, como "/_layouts/1033/images/formatmap16x16.png".
Image16by16Class	Opcional. O nome de um seletor de classe CSS a ser aplicado à imagem.
Image16by16Left	Opcional. Um inteiro negativo que representa um deslocamento para a borda esquerda da imagem. Use esse atributo quando o atributo Image16by16 apontar para um arquivo de imagem que contém imagens para muitos ícones. O valor do atributo Image16by16Left é usado para definir o atributo esquerdo CSS para o estilo embutido de uma marca img HTML.
Image16by16Top	Opcional. Um inteiro negativo que representa um deslocamento para a borda superior da imagem. Use esse atributo quando o atributo Image16by16 apontar para um arquivo de imagem que contém imagens para muitos ícones. O valor do atributo Image16by16Top é usado para definir o atributo superior do CSS para o estilo embutido de uma marca img HTML.
Sequence	Opcional. Um inteiro que especifica a ordem de posicionamento entre nós XML irmãos.
TemplateAlias	Opcional. Uma cadeia de caracteres que corresponde ao valor do atributo TemplateAlias para um elemento ControlRef , um elemento OverflowArea ou um elemento OverflowSection em um elemento GroupTemplate . O atributo TemplateAlias é usado para controles de tamanho e posição em um grupo quando um modelo é aplicado ao grupo.
QueryCommand	Opcional. O nome do comando a ser executado ao sondar informações de estado.
Comando	Opcional. O nome do comando a ser executado quando o rótulo recebe foco.

Elementos filho

Nenhum

Elementos pai

Occurrences

Mínimo: 0
Máximo: 1

Exemplo

O exemplo a seguir é um fragmento XML que mostra um elemento Controls que contém dois controles de caixa de texto e dois rótulos para eles.

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

Partilhar via