Label 元素

上次修改时间： 2015年3月9日

适用范围： SharePoint Foundation 2010

本文内容
属性
子元素
父元素
出现次数

定义标签控件。

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

属性

属性	说明
ForId	可选。此控件所标注的控件的 ID。
Id	必需。用于标识控件的字符串，例如"Ribbon.Image.Image.Size.HorizontalSizeLabel"。
LabelText	可选。标签的文本。
Image16by16	可选。文件相对于服务器的 URL，该文件包含要用作图标的 16 X 16 像素图像，例如"/_layouts/1033/images/formatmap16x16.png"。
Image16by16Class	可选。应用于图像的 CSS 类选择器的名称。
Image16by16Left	可选。一个负整数，表示图像左边缘的偏移。当 Image16by16 属性指向一个图像文件（其中包含许多图标的图像）时，使用此属性。Image16by16Left 属性的值用于设置级联样式 HTML img 标记的 CSS left 属性。
Image16by16Top	可选。一个负整数，表示图像上边缘的偏移。当 Image16by16 属性指向一个图像文件（其中包含许多图标的图像）时，使用此属性。Image16by16Top 属性的值用于设置级联样式 HTML img 标记的 CSS top 属性。
Sequence	可选。一个指定同级 XML 节点之间的放置顺序的整数。
TemplateAlias	可选。一个匹配 ControlRef 元素、OverflowArea 元素或 GroupTemplate 元素中的 OverflowSection 元素的 TemplateAlias 属性值的字符串。在对某个组应用模板时，可使用 TemplateAlias 属性调整该组中控件的大小和位置。
QueryCommand	可选。轮询状态信息时要执行的命令的名称。
Command	可选。当标签接收到焦点时要执行的命令的名称。

子元素

无

父元素

CommandUIDefinition

Controls

出现次数

最小值：0 最大值：1

示例

以下示例是一个 XML 片段，它显示了一个包含两个文本框控件和两个控件标签的 Controls 元素。

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