Tutorial: Adición de una ficha a 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 agregar una nueva ficha a la Cinta de Server en Microsoft SharePoint Foundation.
Requisitos previos
SharePoint Foundation 2010
Herramientas de desarrollo de SharePoint en Microsoft Visual Studio 2010
Creación de un proyecto de SharePoint
Para agregar una ficha nueva, primero debe crear un proyecto de SharePoint vacío.
Para crear un proyecto de SharePoint
Inicie Visual Studio 2010.
En el menú Archivo, elija Nuevo y, a continuación, haga clic en Proyecto.
En Tipos de proyecto, en Visual Basic o C#, seleccione Proyecto de SharePoint vacío.
Escriba AddARibbonTab como el nombre del proyecto y, a continuación, haga clic en Aceptar.
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
Personalice la cinta de opciones mediante el uso de una característica. Los siguientes pasos agregan una nueva característica a la solución.
Para agregar una nueva característica
En el Explorador de soluciones, haga clic con el botón secundario en Características y, a continuación, seleccione Agregar característica.
Cambie el título de la característica a Ficha de cinta personalizada.
En el Explorador de soluciones, haga clic con el botón secundario en Feature1 y, a continuación, seleccione Cambiar nombre. Escriba CustomRibbonTab como el nuevo nombre.
En el Explorador de soluciones, haga clic con el botón secundario en el proyecto AddARibbonTab, elija Agregar y, a continuación, haga clic en Nuevo elemento.
En el cuadro de diálogo Agregar nuevo elemento, seleccione la plantilla Elemento vacío. Escriba CustomRibbonTab como el nombre.
Definición de la acción personalizada
La personalización de la cinta de opciones se define mediante el uso de XML de la cinta de opciones en una acción personalizada. Para obtener una explicación detallada del XML de la cinta de opciones, vea XML de la cinta de Server.
Para definir la acción personalizada
Abra el archivo Elements.xml.
Pegue el siguiente XML de la cinta de opciones en el archivo Elements.xml. Esto agrega una nueva ficha My Custom Tab con un grupo y tres botones en una biblioteca de documentos.
<?xml version="1.0" encoding="utf-8"?> <Elements xmlns="https://schemas.microsoft.com/sharepoint/"> <CustomAction Id="MyCustomRibbonTab" Location="CommandUI.Ribbon.ListView" RegistrationId="101" RegistrationType="List"> <CommandUIExtension> <CommandUIDefinitions> <CommandUIDefinition Location="Ribbon.Tabs._children"> <Tab Id="Ribbon.CustomTabExample" Title="My Custom Tab" Description="This holds my custom commands!" Sequence="501"> <Scaling Id="Ribbon.CustomTabExample.Scaling"> <MaxSize Id="Ribbon.CustomTabExample.MaxSize" GroupId="Ribbon.CustomTabExample.CustomGroupExample" Size="OneLargeTwoMedium"/> <Scale Id="Ribbon.CustomTabExample.Scaling.CustomTabScaling" GroupId="Ribbon.CustomTabExample.CustomGroupExample" Size="OneLargeTwoMedium" /> </Scaling> <Groups Id="Ribbon.CustomTabExample.Groups"> <Group Id="Ribbon.CustomTabExample.CustomGroupExample" Description="This is a custom group!" Title="Custom Group" Sequence="52" Template="Ribbon.Templates.CustomTemplateExample"> <Controls Id="Ribbon.CustomTabExample.CustomGroupExample.Controls"> <Button Id="Ribbon.CustomTabExample.CustomGroupExample.HelloWorld" Command="CustomTabExample.HelloWorldCommand" Sequence="15" Description="Says hello to the World!" LabelText="Hello, World!" TemplateAlias="cust1"/> <Button Id="Ribbon.CustomTabExample.CustomGroupExample.GoodbyeWorld" Command="CustomTabExample.GoodbyeWorldCommand" Sequence="17" Description="Says good-bye to the World!" LabelText="Good-bye, World!" TemplateAlias="cust2"/> <Button Id="Ribbon.CustomTabExample.CustomGroupExample.LoveWorld" Command="CustomTabExample.LoveWorldCommand" Sequence="19" Description="Says I love the World!" LabelText="I love you, World!" TemplateAlias="cust3"/> </Controls> </Group> </Groups> </Tab> </CommandUIDefinition> <CommandUIDefinition Location="Ribbon.Templates._children"> <GroupTemplate Id="Ribbon.Templates.CustomTemplateExample"> <Layout Title="OneLargeTwoMedium" LayoutTitle="OneLargeTwoMedium"> <Section Alignment="Top" Type="OneRow"> <Row> <ControlRef DisplayMode="Large" TemplateAlias="cust1" /> </Row> </Section> <Section Alignment="Top" Type="TwoRow"> <Row> <ControlRef DisplayMode="Medium" TemplateAlias="cust2" /> </Row> <Row> <ControlRef DisplayMode="Medium" TemplateAlias="cust3" /> </Row> </Section> </Layout> </GroupTemplate> </CommandUIDefinition> </CommandUIDefinitions> <CommandUIHandlers> <CommandUIHandler Command="CustomTabExample.HelloWorldCommand" CommandAction="javascript:alert('Hello, world!');" /> <CommandUIHandler Command="CustomTabExample.GoodbyeWorldCommand" CommandAction="javascript:alert('Good-bye, world!');" /> <CommandUIHandler Command="CustomTabExample.LoveWorldCommand" CommandAction="javascript:alert('I love you, world!');" /> </CommandUIHandlers> </CommandUIExtension> </CustomAction> </Elements>
Implementación de la personalización
Puesto que el proyecto se configuró como una solución de espacio aislado, se implementa en la galería de soluciones.
Para implementar la personalización
Presione F5. Herramientas de desarrollo de SharePoint en Visual Studio 2010 compilará e implementará automáticamente la característica.
Navegue a una biblioteca de documentos en el sitio o subsitio.
Haga clic en la pestaña My Custom Tab, observe Custom Group y, a continuación, haga clic en los botones Hello, World, Good-bye, World o I Love You, World.