Freigeben über


SplitButton-Element (Server-Menüband)

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

Definiert ein Steuerelement, das eine Schaltfläche und ein Dropdownmenü kombiniert.

<SplitButton
  Alt="Text"
  CacheMenuVersions="TRUE | FALSE"
  Command="Text"
  CommandMenuOpen="Text"
  CommandMenuClose="Text"
  CommandType="General | OptionSelection | IgnoredByMenu"
  Id="Text"
  Image32by32="Url"
  Image32by32Class="CSS Class Selector"
  Image32by32Left="Negative Integer"
  Image32by32Top="Negative Integer"
  Image16by16="Url"
  Image16by16Class="CSS Class Selector"
  Image16by16Left="Negative Integer"
  Image16by16Top="Negative Integer"
  LabelText="Text"
  MenuAlt="Text"
  MenuCommand="Text"
  PopulateDynamically=" TRUE | FALSE "
  PopulateQueryCommand="Text"
  PopulateOnlyOnce=" TRUE | FALSE "
  Sequence="Integer"
  TemplateAlias="Text"
  ToolTipImage32by32="Url"
  ToolTipImage32by32Class="CSS Class Selector"
  ToolTipImage32by32Left="Negative Integer"
  ToolTipImage32by32Top="Negative Integer"
  ToolTipTitle="Text"
  ToolTipDescription="Text"
  ToolTipHelpKeyWord="Text"
  ToolTipSelectedItemTitle="Text"
  ToolTipShortcutKey="Text"
/>

Elemente und Attribute

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

Attribute

Attribut Beschreibung
Alt
Optional. Alternativer Text für das Steuerelement.
CacheMenuVersions
Optional. Mit TRUE werden die zuvor erstellten Versionen eines dynamischen Menüs gespeichert. Der Standardwert ist FALSE.
Befehl
Optional. Der Name des Befehls, der ausgeführt werden soll, wenn das Steuerelement ausgewählt wird. Falls sich das Steuerelement in einem CommandUIDefinition-Element befindet, sollte der Wert des Command-Attributs des Steuerelements mit dem Wert des Command-Attributs eines entsprechenden CommandUIHandler-Elements übereinstimmen.
CommandMenuOpen
Optional. Der Name des Befehls, der beim Öffnen des Menüs ausgeführt werden soll.
CommandMenuClose
Optional. Der Name des Befehls, der beim Schließen des Menüs ausgeführt werden soll.
CommandType
Optional. Ein Enumerationswert, der den Befehlstyp angibt.
Allgemein. Kein bestimmter Befehlstyp.
OptionSelection. Ein Befehl, der generiert wird, wenn ein Benutzer eine Option in einer Optionsgruppe auswählt.
IgnoredByMenu. Ein Befehl, der für Steuerelemente verwendet wird, die das Menü nicht schließen sollten, wenn sie ausgewählt sind.
Id
Erforderlich. Eine Zeichenfolge zur Identifikation des Steuerelements.
Image32by32
Optional. Eine serverrelative URL zu einer Datei, die ein 32 x 32 Pixel großes Bild enthält, das als Symbol verwendet werden soll, z. B. "/_layouts/1033/images/formatmap32x32.png".
Image32by32Class
Optional. Der Name einer CSS-Klassenauswahl, die auf das Bild angewendet werden soll.
Image32by32Left
Optional. Eine negative ganze Zahl, die einen Abstand für die linke Kante des Bilds angibt. Verwenden Sie dieses Attribut, wenn das Image32by32-Attribut auf eine Bilddatei zeigt, die Bilder für viele Symbole enthält.
Mit dem Wert des Image32by32Left-Attributs wird das CSS-Attribut left für die Inlineformatvorlage eines HTML-Tags img festgelegt. Wenn Sie beispielsweise das Image32by32Left-Attribut auf "-160" und das Image32by32Top-Attribut auf "-448" festlegen, ergibt sich eine Inlineformatvorlage, die der im folgenden HTML-Markup ähnlich ist:
HTML<img src="/_layouts/1033/images/formatmap32x32.png" style="position: absolute;left: -160px;top: -448px;" />
Image32by32Top
Optional. Eine negative ganze Zahl, die einen Abstand für die obere Kante des Bilds angibt. Verwenden Sie dieses Attribut, wenn das Image32by32-Attribut auf eine Bilddatei zeigt, die Bilder für viele Symbole enthält. Mit dem Wert des Image32by32Top-Attributs wird das top-CSS-Attribut für die Inlineformatvorlage eines img-HTML-Tags festgelegt.
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.
LabelText
Optional. Der Beschriftungstext für das Steuerelement.
MenuAlt
Optional. Alternativer Text für das Menü.
Menucommand
Optional. Der Name des Befehls, der ausgeführt werden soll, wenn das Menü ausgewählt wird.
AuffüllenDynamically
Optional. Ist TRUE, wenn das Menü dynamisch erstellt wird. Der Standardwert ist FALSE.
PopulateQueryCommand
Optional. Der Name des auszuführenden Befehls, wenn ein dynamisches Menü erstellt wird.
PopulateOnlyOnce
Optional. Ist TRUE, wenn ein dynamisches Menü nur beim ersten Zugriff gefüllt wird.
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 dient zum Bestimmen der Größe und Position von Steuerelementen in einer Gruppe, wenn eine Vorlage auf die Gruppe angewendet wird.
ToolTipImage32by32
Optional. Eine serverrelative URL zu einer Datei, die ein 32 x 32 Pixel großes Bild enthält, das in der QuickInfo verwendet werden soll, z. B. "/_layouts/1033/images/formatmap32x32.png".
ToolTipImage32by32Class
Optional. Der Name eines CSS-Selektors, der auf ein QuickInfo-Bild angewendet werden soll.
ToolTipImage32by32Left
Optional. Eine negative ganze Zahl, die einen Abstand für die linke Kante des Bilds angibt. Verwenden Sie dieses Attribut, wenn das ToolTipImage32by32-Attribut auf eine Bilddatei verweist, die die Bilder für viele Symbole enthält. Der Wert des ToolTipImage32by32Left-Attributs wird zum Festlegen des CSS-Attributs left für die Inlineformatvorlage eines HTML-img-Tags verwendet, wenn die Seite erstellt wird.
ToolTipImage32by32Top
Optional. Eine negative ganze Zahl, die einen Abstand für die obere Kante des Bilds angibt. Verwenden Sie dieses Attribut, wenn das ToolTipImage32by32-Attribut auf eine Bilddatei verweist, die die Bilder für viele Symbole enthält. Der Wert des ToolTipImage32by32Top-Attributs wird zum Festlegen des CSS-Attributs top für die Inlineformatvorlage eines HTML-img-Tags verwendet, wenn die Seite erstellt wird.
ToolTipTitle
Optional. Der als Titel der QuickInfo angezeigte Text.
QuickInfoDescription
Optional. Der im Textkörper der QuickInfo angezeigte Text.
ToolTipHelpKeyWord
Optional. Das von der kontextabhängigen Hilfe verwendete Stichwort.
ToolTipSelectedItemTitle
Optional. Der Titel der QuickInfo für das ausgewählte Element.
ToolTipShortcutKey
Optional. Der für die Tastenkombination in der QuickInfo anzuzeigende Text. Wenn die Tastenkombination für das Steuerelement z. B. ALT+J ist, lautet der Wert für dieses Attribut "ALT+J". Die QuickInfo zeigt den Text für die Tastenkombination in Klammern nach dem QuickInfo-Titel an: "(Alt+J)".

Untergeordnete Elemente

Übergeordnete Elemente

Vorkommen

  • Minimum: 0
  • Maximum: Unbegrenzt