Freigeben über


ToggleButton-Element

Letzte Änderung: Freitag, 15. Oktober 2010

Gilt für: SharePoint Foundation 2010

Inhalt dieses Artikels
Attribute
Untergeordnete Elemente
Übergeordnete Elemente
Vorkommen

Definiert eine Schaltfläche, die zum Wechsel zwischen Zuständen verwendet wird.

<ToggleButton
  Alt="Text"
  Command="Text "
  CommandValueId="Text"
  Description="Text"
  Id="Text"
  LabelCss="CSS Class Selector"
  LabelText="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"
  MenuItemId="Text"
  QueryCommand="Text"
  Sequence="Integer"
  TemplateAlias="Text"
  ToolTipImage32by32="Url"
  ToolTipImage32by32Class="CSS Selector"
  ToolTipImage32by32Left="Negative Integer"
  ToolTipImage32by32Top="Negative Integer"
  ToolTipTitle="Text"
  ToolTipDescription="Text"
  ToolTipHelpKeyWord="Text"
  ToolTipShortcutKey="Text"
/>

Attribute

Attribut

Beschreibung

Alt

Optional. Alternativer Text für das Steuerelement.

Command

Optional. Der Name des auszuführenden Befehls, wenn auf das Steuerelement geklickt 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.

CommandValueId

Optional. Eine Zeichenfolge, die mit dem Befehlsereignis gesendet wird, wenn auf die Schaltfläche geklickt wird.

Description

Optional. Eine Zeichenfolge, die die Schaltfläche beschreibt.

Id

Erforderlich. Eine Zeichenfolge, die das Steuerelement identifiziert, z. B. "Ribbon.Library.ViewFormat.Standard".

LabelCss

Optional. Der Name einer CSS-Klassenauswahl, die auf die Beschriftung des Steuerelements angewendet werden soll.

LabelText

Optional. Der Beschriftungstext für das Steuerelement.

Image32by32

Optional. Eine serverrelative URL zu einer Datei, die ein als Symbol zu verwendendes Bild mit 32x32 Pixeln enthält, wie z. B. /_layouts/1033/images/formatmap32x32.png.

Image32by32Class

Optional. Der Name einer CSS-Klasse, die auf das Bild angewendet werden soll.

Image32by32Left

Optional. Eine negative ganze Zahl, die den Offset für die linke Seite des Bilds darstellt. 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. Beispielsweise führt das Festlegen des Image32by32Left-Attributs auf -160 und des Image32by32Top-Attributs auf -448 zu einer Inlineformatvorlage ähnlich der im folgenden HTML-Markup:

<img src="/_layouts/1033/images/formatmap32x32.png" style="position: absolute;left: -160px;top: -448px;" />

Image32by32Top

Optional. Eine negative ganze Zahl, die den Offset für die obere Seite des Bilds darstellt. 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 CSS-Attribut top für die Inlineformatvorlage eines HTML-Tags img festgelegt.

Image16by16

Optional. Eine serverrelative URL zu einer Datei, die ein als Symbol zu verwendendes Bild mit 16x16 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 CSS-Attribut left für die Inlineformatvorlage eines HTML-Tags img 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 CSS-Attribut top für die Inlineformatvorlage eines HTML-Tags img festgelegt.

MenuItemId

Optional. Eine Zeichenfolge, die das Menüelement definiert, in dem sich die Schaltfläche befindet.

QueryCommand

Optional. Der Name des auszuführenden Befehls, wenn Statusinformationen abgerufen werden.

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.

ToolTipImage32by32

Optional. Eine serverrelative URL zu einer Datei mit einem Bild mit 32x32 Pixeln, das in der QuickInfo verwendet wird, z. B. /_layouts/1033/images/formatmap32x32.png.

ToolTipImage32by32Class

Optional. Der Name einer CSS-Klassenauswahl, die auf das 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 zeigt, 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-Tags img 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 zeigt, 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-Tags img verwendet, wenn die Seite erstellt wird.

ToolTipTitle

Optional. Der als Titel der QuickInfo angezeigte Text.

ToolTipDescription

Optional. Der im Textkörper der QuickInfo angezeigte Text.

ToolTipHelpKeyWord

Optional. Das von der kontextabhängigen Hilfe verwendete Schlüsselwort.

ToolTipShortcutKey

Optional. Der für die Tastenkombination in der QuickInfo anzuzeigende Text. Wenn die Tastenkombination für das Steuerelement z. B. ALT+J ist, besitzt das Attribut den Wert ALT+J. In der QuickInfo wird der Text für die Tastenkombination in Klammern hinter dem Titel der QuickInfo angezeigt: "(ALT + J)".

Untergeordnete Elemente

Keine

Übergeordnete Elemente

CommandUIDefinition

Controls

Vorkommen

Mindestvorkommen: 0

Maximum: Unbegrenzt