Freigeben über

Label-Element (Server-Menüband)

Gilt für: SharePoint 2016 | SharePoint Foundation 2013 | SharePoint Online-| SharePoint Server 2013

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

Elemente und Attribute

In den folgenden Abschnitten werden Attribute, untergeordnete und übergeordnete Elemente erläutert.

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 Beschriftung.
Image16by16
Optional. Eine serverrelative URL zu einer Datei, die ein 16 x 16 Pixel großes Bild enthält, das als Symbol verwendet werden soll, z. B. "/_layouts/1033/images/formatmap16x16.png".
Image16by16Class
Optional. Der Name einer CSS-Klassenauswahl, die auf das Bild angewendet werden soll.
Image16by16Left
Optional. Eine negative ganze Zahl, die einen Abstand für die linke Kante des Bilds angibt. 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 einen Abstand für die obere Kante des Bilds angibt. 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 CSS-Attribut top für die Inlineformatvorlage eines HTML-Tags img festgelegt.
Sequence
Optional. Eine ganze Zahl, die die Reihenfolge der Platzierung unter 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.
Befehl
Optional. Der Name des Befehls, der beim Schließen des Menüs ausgeführt werden soll.

Untergeordnete Elemente

Keine

Übergeordnete Elemente

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