Tutorial: Reemplazar un botón de la cinta de Server

Última modificación: lunes, 07 de febrero de 2011

Hace referencia a: SharePoint Foundation 2010

En este artículo
Creación de un proyecto de SharePoint
Adición de una nueva característica
Definición de la acción personalizada
Implementación de la personalización

En este tema se describe cómo reemplazar un botón de la Cinta de Server de Microsoft SharePoint Foundation.

Requisitos previos

Microsoft SharePoint Foundation 2010

Herramientas de desarrollo de SharePoint en Microsoft Visual Studio 2010

Creación de un proyecto de SharePoint

Para personalizar la cinta de opciones, comience creando un proyecto de SharePoint vacío.

Para crear un proyecto de SharePoint

1. Inicie Microsoft Visual Studio 2010.

2. En el menú Archivo, elija Nuevo y, a continuación, haga clic en Proyecto.

3. En Tipos de proyecto, en Visual Basic o C#, seleccione Proyecto de SharePoint vacío.

4. Escriba ReplaceARibbonButton como nombre del proyecto y, a continuación, haga clic en Aceptar.

5. En el Asistente para la personalización de SharePoint, seleccione Implementar como solución en espacio aislado y, a continuación, haga clic en Finalizar.

Adición de una nueva característica

Para personalizar la cinta de opciones se usa una característica. Realice los siguientes pasos para agregar una nueva característica a la solución.

Para agregar una nueva característica

1. En el Explorador de soluciones, haga clic con el botón secundario en Features y, a continuación, haga clic en Agregar característica.

2. Cambie el título de la característica a Reemplazar un botón de la cinta de opciones.

3. En el Explorador de soluciones, haga clic con el botón secundario en Feature1 y, a continuación, seleccione Cambiar nombre. Escriba ReplaceARibbonButton como el nombre nuevo.

4. En el Explorador de soluciones, haga clic con el botón secundario en el proyecto ReplaceARibbonButton, elija Agregar y, a continuación, seleccione Nuevo elemento.

5. En el cuadro de diálogo Agregar nuevo elemento, seleccione la plantilla Elemento vacío. Escriba ReplaceARibbonButton como el nombre.

Definición de la acción personalizada

El botón de la cinta de opciones se reemplaza mediante el atributo Location del elemento CommandUIDefinition. Los valores predeterminados para botones de cinta de opciones se enumeran en Ubicaciones predeterminadas de las personalizaciones de la cinta de Server. Si desea obtener una explicación más detallada sobre el XML de la cinta de opciones, vea XML de la cinta de Server.

Para definir la acción personalizada

1. Abra el archivo Elements.xml.

2. Pegue el siguiente XML en el archivo Elements.xml. Este XML reemplaza el botón Conectar con Outlook en la ficha Biblioteca del grupo Conectar y exportar de una biblioteca de documentos.

   Importante
   Debe reemplazar los atributos Image32by32 y Image16by16 con direcciones URL de imagen válidas.

   <?xml version="1.0" encoding="utf-8"?>
   <Elements xmlns="https://schemas.microsoft.com/sharepoint/">
     <CustomAction Id="Ribbon.Library.Actions.ReplacementButton"
       Location="CommandUI.Ribbon"
       RegistrationId="101"
       RegistrationType="List"
       Title="Replace a Ribbon Button">
       <CommandUIExtension>
         <CommandUIDefinitions>
           <CommandUIDefinition
             Location="Ribbon.Library.Actions.ConnectToClient">
                <Button Id="Ribbon.Library.Actions.ConnectToClient.ReplacementButton"
                  Command="ReplacementButtonCommand"
                  Image16by16="Insert an image URL here."
                  Image32by32="Insert an image URL here."
                  LabelText="Replaced Button"
                  TemplateAlias="o2" />
           </CommandUIDefinition>
         </CommandUIDefinitions>
         <CommandUIHandlers>
           <CommandUIHandler
             Command="ReplacementButtonCommand"
             CommandAction="javascript:alert('This button has been replaced.');" />
         </CommandUIHandlers>
       </CommandUIExtension>
     </CustomAction>
   </Elements>
   

Implementación de la personalización

Puesto que el proyecto se estableció como una solución de espacio aislado, se implementa en la galería de soluciones.

Para implementar la personalización

1. Presione F5. Herramientas de desarrollo de SharePoint en Visual Studio 2010 compilará e implementará automáticamente la característica.

2. Navegue a una biblioteca de documentos en el sitio o subsitio.

3. Haga clic en la pestaña Biblioteca, consulte el grupo Conectar y exportar y observe la ausencia del botón Conectar con Outlook.

Vea también

Tareas

Tutorial: Agregar un botón a la cinta de Server

Conceptos

Personalización declarativa de la cinta de Server