GalleryButton-Element (Group) (Menüband des Servers)
Gilt für: SharePoint 2016-| SharePoint Foundation 2013 | SharePoint Online-| SharePoint Server 2013
Definiert eine Katalogschaltfläche.
<GalleryButton
Alt="Text"
Command="Text"
CommandPreview="Text"
CommandRevert="Text"
CommandType="General | OptionSelect | IgnoredByMenu"
CommandValueId="Text"
ElementDimensions="Size16by16 | Size32by32 | Size48by48 | Size72by96 | Size96by72 | Size96by96 | Size128by128 | Size190by30 | Size190by40 | Size190by50 | Size190by60"
Id="Text"
Image="Url"
ImageClass="CSS Selector"
ImageLeft="Negative Integer"
ImageTop="Negative Integer"
InnerHTML="HTML"
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"
/>
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. |
| Befehl |
Optional. Der Name des Befehls, der ausgeführt werden soll, wenn das Steuerelement ausgewählt ist. 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. |
| CommandPreview |
Optional. Der Name des auszuführenden Befehls beim Anzeigen einer Vorschau für eine Auswahl. |
| CommandRevert |
Optional. Der Name des auszuführenden Befehls zum Zurückgeben des Status, der vor der Anzeige einer Vorschau für eine Auswahl vorhanden war. |
| 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. |
| CommandValueId |
Optional. Eine Zeichenfolge, die mit dem Befehlsereignis gesendet wird, wenn die Schaltfläche ausgewählt ist. |
| ElementDimensions |
Erforderlich. Ein Enumerationswert, mit dem die Dimensionen des Rechtecks angegeben werden, in dem die Schaltfläche gerendert wird. Dimensionen werden in Pixeln angegeben und besitzen das Format "Breite mal Höhe". Größe 16by16 Size32by32 Größe 48by48 Größe 72by96 Size96by72 Size96by96 Größe 128by128 Größe190by30 Größe190by40 Größe190by50 Größe190by60 |
| ID |
Erforderlich. Eine Zeichenfolge, die das Element identifiziert, z. B. "buttonStaticStyle1". |
| Image |
Optional. Eine serverrelative URL zu einer Datei, die ein als Symbol zu verwendendes Bild enthält. Falls kein Image-Attribut definiert ist, muss ein InnerHTML-Attribut definiert sein. |
| Imageclass |
Optional. Der Name einer CSS-Klassenauswahl, die auf das Bild angewendet werden soll. |
| ImageLeft |
Optional. Eine negative ganze Zahl, die den Abstand für die linke Seite des Bilds darstellt. Verwenden Sie dieses Attribut, wenn das Image-Attribut auf eine Bilddatei zeigt, die Bilder für mehrere Symbole enthält. |
| ImageTop |
Optional. Eine negative ganze Zahl, die den Abstand für die obere Seite des Bilds darstellt. Verwenden Sie dieses Attribut, wenn das Image-Attribut auf eine Bilddatei zeigt, die Bilder für mehrere Symbole enthält. |
| Innerhtml |
Optional. HTML-Markup, der die von der Schaltfläche dargestellte Auswahl darstellt. Falls das InnerHTML-Attribut nicht definiert ist, muss das Image-Attribut definiert sein. |
| 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 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. |
| ToolTipImage32by32 |
Optional. Eine serverrelative URL zu einer Datei, die ein Bild mit 32 x 32 Pixeln 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 zeigt, die die Bilder für viele Symbole enthält. Der Wert des ToolTipImage32by32Left-Attributs wird zum Festlegen des CSS-Attributs left 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 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 Stichwort. |
| ToolTipShortcutKey |
Optional. Der für die Tastenkombination in der QuickInfo anzuzeigende Text. Wenn die Tastenkombination für das Steuerelement beispielsweise ALT+J lautet, lautet der Wert für dieses Attribut "ALT+J". Die QuickInfo zeigt den Text für die Tastenkombination in Klammern hinter dem QuickInfo-Titel an: "(ALT+J)". |
Untergeordnete Elemente
Keines
Übergeordnete Elemente
- CommandUIDefinition
- Controls (Group)
Vorkommen
- Minimum: 0
- Maximum: Unbegrenzt
Beispiel
Das folgende Beispiel stellt ein XML-Fragment dar, das eine Gruppe der Katalogschaltflächen-Steuerelemente definiert, die zum Anwenden einer Formatierung verwendet werden.
<Group
Id="grpStyles"
Description=""
Title="Group Styles"
Template="tmpStyles">
<Controls>
<GalleryButton
Id="buttonStaticStyle1"
Command="ApplyStyle"
QueryCommand="QueryStyle"
InnerHTML="&lt;DIV class=&quot;PreviewStyleContainer&quot;&gt;&lt;P class=&quot;PreviewStaticStyle1&quot; id=&quot;labelPreviewContent0&quot;&gt;&lt;/P&gt;&lt;P class=&quot;PreviewStyleLabel&quot; id=&quot;labelPreviewStyle0&quot;&gt;&lt;/P&gt;&lt;/DIV&gt;"
ElementDimensions="Size64by48"
LabelText="Heading1"
Alt="Heading1"
TemplateAlias="preview1"/>
<GalleryButton
Id="buttonStaticStyle2"
Command="ApplyStyle"
QueryCommand="QueryStyle"
InnerHTML="&lt;DIV class=&quot;PreviewStyleContainer&quot;&gt;&lt;P class=&quot;PreviewStaticStyle2&quot; id=&quot;labelPreviewContent1&quot;&gt;&lt;/P&gt;&lt;P class=&quot;PreviewStyleLabel&quot; id=&quot;labelPreviewStyle1&quot;&gt;&lt;/P&gt;&lt;/DIV&gt;"
ElementDimensions="Size64by48"
LabelText="Heading2"
Alt="Heading2"
TemplateAlias="preview2"/>
<GalleryButton
Id="buttonStaticStyle3"
QueryCommand="QueryStyle"
Command="ApplyStyle"
InnerHTML="&lt;DIV class=&quot;PreviewStyleContainer&quot;&gt;&lt;P class=&quot;PreviewStaticStyle3&quot; id=&quot;labelPreviewContent2&quot;&gt;&lt;/P&gt;&lt;P class=&quot;PreviewStyleLabel&quot; id=&quot;labelPreviewStyle2&quot;&gt;&lt;/P&gt;&lt;/DIV&gt;"
ElementDimensions="Size64by48"
LabelText="Heading3"
Alt="Heading3"
TemplateAlias="preview3"/>
<GalleryButton
Id="buttonStaticStyle4"
Command="ApplyStyle"
QueryCommand="QueryStyle"
InnerHTML="&lt;DIV class=&quot;PreviewStyleContainer&quot;&gt;&lt;P class=&quot;PreviewStaticStyle4&quot; id=&quot;labelPreviewContent3&quot;&gt;&lt;/P&gt;&lt;P class=&quot;PreviewStyleLabel&quot; id=&quot;labelPreviewStyle3&quot;&gt;&lt;/P&gt;&lt;/DIV&gt;"
ElementDimensions="Size64by48"
LabelText="Quote"
Alt="Quote"
TemplateAlias="preview4"/>
<GalleryButton
Id="buttonStaticStyle5"
Command="ApplyStyle"
QueryCommand="QueryStyle"
InnerHTML="&lt;DIV class=&quot;PreviewStyleContainer&quot;&gt;&lt;P class=&quot;PreviewStaticStyle5&quot; id=&quot;labelPreviewContent4&quot;&gt;&lt;/P&gt;&lt;P class=&quot;PreviewStyleLabel&quot; id=&quot;labelPreviewStyle4&quot;&gt;&lt;/P&gt;&lt;/DIV&gt;"
ElementDimensions="Size64by48"
LabelText="Citation"
Alt="Citation"
TemplateAlias="preview5"/>
<FlyoutAnchor
Alt="STR@L_MenuMoreStyles"
Id="fsfaMoreStyles"
Command="MenuOpenEditOnly"
MenuAlt="STR@L_MenuMoreStyles"
LabelText="STR@L_MenuMoreStyles"
Image32by32="IMGMAP@one@UxGalWordQuickFormatsHH"
TemplateAlias="morestyles"
PopulateDynamically="true"
PopulateOnlyOnce="false"
PopulateQueryCommand="PopulateMenuMoreStyles"
CommandMenuClose="MenuClose"
CacheMenuVersions="false">
</FlyoutAnchor>
</Controls>
</Group>