Elemento GalleryButton (grupo)

Artículo
09/24/2014

Última modificación: miércoles, 13 de octubre de 2010

Hace referencia a: SharePoint Foundation 2010

En este artículo
Atributos
Elementos secundarios
Elementos primarios
Repeticiones

Define un botón de galería.

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

Atributos

Atributo	Descripción
Alt	Opcional. Texto alternativo que se usa para el control.
Command	Opcional. El nombre del comando que debe ejecutarse al hacer clic en el control. Si el control está en un elemento CommandUIDefinition, el valor del atributo Command del control debe ser el mismo que el valor del atributo Command de un elemento CommandUIHandler correspondiente.
CommandPreview	Opcional. El nombre del comando que debe ejecutarse para obtener la vista previa de una selección.
CommandRevert	Opcional. El nombre del comando que debe ejecutarse para volver al estado que existía antes de obtener la vista previa de una selección.
CommandType	Opcional. Valor de enumeración que especifica el tipo de comando. General. No es un tipo de comando específico. OptionSelection. Comando que se genera cuando un usuario selecciona una opción en un grupo de opciones. IgnoredByMenu. Comando que se usa para los controles que no deben cerrar el menú cuando se hace clic en ellos.
CommandValueId	Opcional. Cadena que se envía con el evento de comando cuando se hace clic en el botón.
ElementDimensions	Obligatorio. Valor de enumeración que especifica las dimensiones del rectángulo en el que se representa el botón. Las dimensiones están en píxeles y en el formato "ancho por alto". Size16by16 Size32by32 Size48by48 Size72by96 Size96by72 Size96by96 Size128by128 Size190by30 Size190by40 Size190by50 Size190by60
Id	Obligatorio. Cadena que identifica el elemento, como "buttonStaticStyle1".
Image	Opcional. Dirección URL relativa a un servidor en un archivo que contiene una imagen que se usará como icono. Si no se define el atributo Image, debe definirse un atributo InnerHTML.
ImageClass	Opcional. El nombre de un selector de clases CSS que se aplicará a la imagen.
ImageLeft	Opcional. Entero negativo que representa un desplazamiento del borde izquierdo de la imagen. Use este atributo cuando el atributo Image señale a un archivo de imagen que contenga imágenes de varios iconos.
ImageTop	Opcional. Entero negativo que representa un desplazamiento del borde superior de la imagen. Use este atributo cuando el atributo Image señale a un archivo de imagen que contenga imágenes de varios iconos.
InnerHTML	Opcional. Formato HTML que ilustra la elección que representa el botón. Si no se define el atributo InnerHTML, debe definirse el atributo Image.
MenuItemId	Opcional. Cadena que identifica el elemento de menú en el que se ubica el botón.
QueryCommand	Opcional. El nombre del comando que debe ejecutarse cuando se realiza un sondeo de la información de estado.
Sequence	Opcional. Entero que especifica el orden de colocación entre nodos XML del mismo nivel.
TemplateAlias	Opcional. Cadena que coincide con el valor del atributo TemplateAlias de un elemento ControlRef, un elemento OverflowArea o un elemento OverflowSection en un elemento GroupTemplate. El atributo TemplateAlias se usa para cambiar el tamaño de los controles y posicionarlos dentro de un grupo cuando se aplica una plantilla al grupo.
ToolTipImage32by32	Opcional. Dirección URL relativa a un servidor en un archivo que contiene una imagen de 32x32 píxeles que se usará en la información sobre herramientas, tal como "/_layouts/1033/images/formatmap32x32.png".
ToolTipImage32by32Class	Opcional. El nombre del selector CSS que se aplicará a la imagen de la información sobre herramientas.
ToolTipImage32by32Left	Opcional. Entero negativo que representa un desplazamiento del borde izquierdo de la imagen. Use este atributo cuando el atributo ToolTipImage32by32 señale a un archivo de imagen que contenga las imágenes de varios iconos. El valor del atributo ToolTipImage32by32Left se usa para establecer el atributo left de CSS cuando se crea la página.
ToolTipImage32by32Top	Opcional. Entero negativo que representa un desplazamiento del borde superior de la imagen. Use este atributo cuando el atributo ToolTipImage32by32 señale a un archivo de imagen que contenga las imágenes de varios iconos. El valor del atributo ToolTipImage32by32Top se usa para establecer el atributo top de CSS cuando se crea la página.
ToolTipTitle	Opcional. El texto que aparece como título de la información sobre herramientas.
ToolTipDescription	Opcional. El texto que aparece en el cuerpo de la información sobre herramientas.
ToolTipHelpKeyWord	Opcional. La palabra clave que se usa en la ayuda contextual.
ToolTipShortcutKey	Opcional. El texto para mostrar en la tecla de método abreviado de la información sobre herramientas. Por ejemplo, si la tecla de método abreviado para el control es ALT + J, el valor de este atributo es "ALT + J". La información sobre herramientas mostrará el texto para la tecla de método abreviado entre paréntesis después del título de la información sobre herramientas: "(ALT + J)".

Elementos secundarios

Ninguno

Elementos primarios

Elemento CommandUIDefinition

Elemento Controls (Grupo)

Repeticiones

Mínimo: 0

Máximo: sin límite

Ejemplo

El siguiente ejemplo es un fragmento de XML que define un grupo de controles de botones de galería usados para aplicar un estilo de formato.

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

Compartir a través de