Partager via


GalleryButton, élément (Group)

Dernière modification : mercredi 13 octobre 2010

S’applique à : SharePoint Foundation 2010

Dans cet article
Attributs
Éléments enfants
Éléments parents
Occurrences

Définit un bouton de galerie.

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

Attributs

Attribut

Description

Alt

Facultatif. Texte de remplacement utilisé pour le contrôle.

Command

Facultatif. Nom de la commande à exécuter lorsque l’utilisateur clique sur le contrôle. Si le contrôle se trouve dans un élément CommandUIDefinition, la valeur de l’attribut Command du contrôle doit être identique à la valeur de l’attribut Command d’un élément CommandUIHandler correspondant.

CommandPreview

Facultatif. Nom de la commande à exécuter pour obtenir un aperçu d’une sélection.

CommandRevert

Facultatif. Nom de la commande à exécuter pour retourner l’état qui existait avant l’obtention de l’aperçu d’une sélection.

CommandType

Facultatif. Valeur d’énumération qui spécifie le type de commande.

  • General. Type de commande non spécifique.

  • OptionSelection. Commande générée lorsqu’un utilisateur sélectionne une option dans un groupe d’options.

  • IgnoredByMenu. Commande utilisée pour les contrôles qui ne doivent pas fermer le menu lorsque l’utilisateur clique sur ces contrôles.

CommandValueId

Facultatif. Chaîne envoyée avec l’événement de commande lorsque l’utilisateur clique sur le bouton.

ElementDimensions

Obligatoire. Valeur d’énumération qui spécifie les dimensions du rectangle dans lequel le bouton est affiché. Les dimensions sont exprimées en pixels au format « largeur par hauteur ».

  • Size16by16

  • Size32by32

  • Size48by48

  • Size72by96

  • Size96by72

  • Size96by96

  • Size128by128

  • Size190by30

  • Size190by40

  • Size190by50

  • Size190by60

Id

Obligatoire. Chaîne qui identifie l’élément, telle « buttonStaticStyle1 ».

Image

Facultatif. URL relative de serveur d’un fichier qui contient une image à utiliser comme icône.

Si un attribut Image n’est pas défini, un attribut InnerHTML doit être défini.

ImageClass

Facultatif. Nom d’un sélecteur de classe CSS à appliquer à l’image.

ImageLeft

Facultatif. Entier négatif qui représente un décalage pour le bord gauche de l’image. Utilisez cet attribut lorsque l’attribut Image pointe vers un fichier image qui contient des images de plusieurs icônes.

ImageTop

Facultatif. Entier négatif qui représente un décalage pour le bord supérieur de l’image. Utilisez cet attribut lorsque l’attribut Image pointe vers un fichier image qui contient des images de plusieurs icônes.

InnerHTML

Facultatif. Marquage HTML qui illustre le choix représenté par le bouton.

Si l’attribut InnerHTML n’est pas défini, l’attribut Image doit être défini.

MenuItemId

Facultatif. Chaîne qui identifie l’élément de menu où se trouve le bouton.

QueryCommand

Facultatif. Nom de la commande à exécuter lors de l’interrogation des informations d’état.

Sequence

Facultatif. Entier qui spécifie l’ordre d’emplacement dans les nœuds XML frères.

TemplateAlias

Facultatif. Chaîne qui correspond à la valeur de l’attribut TemplateAlias pour un élément ControlRef, un élément OverflowArea ou un élément OverflowSection dans un élément GroupTemplate. L’attribut TemplateAlias permet de dimensionner et de positionner les contrôles dans un groupe lorsqu’un modèle est appliqué au groupe.

ToolTipImage32by32

Facultatif. URL relative de serveur vers un fichier qui contient une image de 32 pixels de côté à utiliser dans l’info-bulle, telle que « /_layouts/1033/images/formatmap32x32.png ».

ToolTipImage32by32Class

Facultatif. Nom d’un sélecteur CSS à appliquer à l’image de l’info-bulle.

ToolTipImage32by32Left

Facultatif. Entier négatif qui représente un décalage pour le bord gauche de l’image. Utilisez cet attribut lorsque l’attribut ToolTipImage32by32 pointe vers un fichier image qui contient les images de nombreuses icônes. La valeur de l’attribut ToolTipImage32by32Left permet de définir l’attribut CSS left lorsque la page est créée.

ToolTipImage32by32Top

Facultatif. Entier négatif qui représente un décalage pour le bord supérieur de l’image. Utilisez cet attribut lorsque l’attribut ToolTipImage32by32 pointe vers un fichier image qui contient les images de nombreuses icônes. La valeur de l’attribut ToolTipImage32by32Top permet de définir l’attribut CSS top lorsque la page est créée.

ToolTipTitle

Facultatif. Texte qui apparaît comme titre de l’info-bulle.

ToolTipDescription

Facultatif. Texte qui apparaît dans le corps de l’info-bulle.

ToolTipHelpKeyWord

Facultatif. Mot clé utilisé par l’aide contextuelle.

ToolTipShortcutKey

Facultatif. Texte à afficher pour la touche de raccourci dans l’info-bulle. Par exemple, si la touche de raccourci pour le contrôle est ALT + J, la valeur de cet attribut est « ALT + J ». L’info-bulle affiche le texte de la touche de raccourci entre parenthèses après le titre de l’info-bulle « (ALT + J) ».

Éléments enfants

Aucun

Éléments parents

CommandUIDefinition

Controls (Group)

Occurrences

Minimum : 0

Maximum : pas de limite

Exemple

L’exemple suivant est un fragment XML qui définit un groupe de contrôles de bouton de galerie utilisés pour l’application d’un style de mise en forme.

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