GalleryButton-Element (Group)

Artikel
09/24/2014

Letzte Änderung: Mittwoch, 13. Oktober 2010

Gilt für: SharePoint Foundation 2010

Inhalt dieses Artikels
Attribute
Untergeordnete Elemente
Übergeordnete Elemente
Vorkommen

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

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.
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. General. 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, mit denen das Menü nicht geschlossen werden soll, wenn darauf geklickt wird.
CommandValueId	Optional. Eine Zeichenfolge, die mit dem Befehlsereignis gesendet wird, wenn auf die Schaltfläche geklickt wird.
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". Size16by16 Size32by32 Size48by48 Size72by96 Size96by72 Size96by96 Size128by128 Size190by30 Size190by40 Size190by50 Size190by60
Id	Erforderlich. Eine Zeichenfolge zur Identifikation des Elements, beispielsweise 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-Klasse, 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 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 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 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 (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>

Freigeben über