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

  • Artículo

Ú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 el modo de agregar un nuevo botón a la Cinta de Server en 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 agregar un nuevo botón, comience creando un proyecto vacío de SharePoint.

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 AddARibbonButton como nombre del proyecto. 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 Botón personalizado de cinta.

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

  4. En el Explorador de soluciones, haga clic con el botón secundario en el proyecto AddARibbonButton, 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 CustomRibbonButton como el nombre.

Definición de la acción personalizada

El botón de la cinta de opciones se define mediante XML de la cinta de opciones en una acción personalizada. 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 código XML en el archivo Elements.xml. Este XML agrega un nuevo botón en la ficha Biblioteca del grupo Compartir y seguir relativo a una biblioteca de documentos.

    Nota importanteImportante

    Debe reemplazar los atributos Image32by32 y Image16by16 por 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.AddAButton"
    Location="CommandUI.Ribbon"
    RegistrationId="101"
    RegistrationType="List"
    Title="Add a Ribbon Button">
    <CommandUIExtension>
      <CommandUIDefinitions>
        <CommandUIDefinition
          Location="Ribbon.Library.Share.Controls._children">
          <Button Id="Ribbon.Library.Share.NewRibbonButton"
            Command="NewRibbonButtonCommand"
            Image16by16="Insert an image URL here."
            Image32by32="Insert an image URL here."
            LabelText="Hello World"
            TemplateAlias="o2" />
        </CommandUIDefinition>
      </CommandUIDefinitions>
      <CommandUIHandlers>
        <CommandUIHandler 
          Command="NewRibbonButtonCommand"
          CommandAction="javascript:alert('Hello, world');" />
      </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, busque en el grupo Compartir y seguir y haga clic en el botón Hello World.

Vea también

Tareas

Tutorial: Eliminación de un botón de la cinta de opciones del servidor

Conceptos

Personalización declarativa de la cinta de Server