Label-Element

Artikel
09/24/2014

Letzte Änderung: Freitag, 15. Oktober 2010

Gilt für: SharePoint Foundation 2010

Inhalt dieses Artikels
Attribute
Untergeordnete Elemente
Übergeordnete Elemente
Vorkommen

Definiert ein Bezeichnungssteuerelement.

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

Attribute

Attribut	Beschreibung
ForId	Optional. Die ID des Steuerelements, das dieses Steuerelement bezeichnet.
Id	Erforderlich. Eine Zeichenfolge zur Identifikation des Steuerelements, beispielsweise "Ribbon.Image.Image.Size.HorizontalSizeLabel".
LabelText	Optional. Der Text der Bezeichnung.
Image16by16	Optional. Eine serverrelative URL zu einer Datei, die ein als Symbol zu verwendendes Bild mit 16 x 16 Pixeln enthält, wie z. B. /_layouts/1033/images/formatmap16x16.png.
Image16by16Class	Optional. Der Name einer CSS-Klasse, die auf das Bild angewendet werden soll.
Image16by16Left	Optional. Eine negative ganze Zahl, die den Offset für die linke Seite des Bilds darstellt. Verwenden Sie dieses Attribut, wenn das Image16by16-Attribut auf eine Bilddatei zeigt, die Bilder für viele Symbole enthält. Mit dem Wert des Image16by16Left-Attributs wird das left-CSS-Attribut für die Inlineformatvorlage eines img-HTML-Tags festgelegt.
Image16by16Top	Optional. Eine negative ganze Zahl, die den Offset für die obere Seite des Bilds darstellt. Verwenden Sie dieses Attribut, wenn das Image16by16-Attribut auf eine Bilddatei zeigt, die Bilder für viele Symbole enthält. Mit dem Wert des Image16by16Top-Attributs wird das top-CSS-Attribut für die Inlineformatvorlage eines img-HTML-Tags festgelegt.
Sequence	Optional. Eine ganze Zahl, die die Reihenfolge in der Platzierung von gleichgeordneten XML-Knoten angibt.
TemplateAlias	Optional. Eine Zeichenfolge, die mit dem Wert des TemplateAlias-Attributs für ein ControlRef-Element, ein OverflowArea-Element oder ein OverflowSection-Element in einem GroupTemplate-Element übereinstimmt. Das TemplateAlias-Attribut wird für die Größenänderung und Positionierung von Steuerelementen innerhalb einer Gruppe verwendet, wenn eine Vorlage auf die Gruppe angewendet wird.
QueryCommand	Optional. Der Name des auszuführenden Befehls, wenn Statusinformationen abgerufen werden.
Command	Optional. Der Name des Befehls, der beim Schließen des Menüs ausgeführt werden soll.

Untergeordnete Elemente

Keine

Übergeordnete Elemente

CommandUIDefinition

Controls

Vorkommen

Minimum: 0

Maximum: 1

Beispiel

Das folgende Beispiel ist ein XML-Fragment, das ein Controls-Element mit zwei Textfeld-Steuerelementen und zwei Bezeichnungen für diese zeigt.

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

Freigeben über