Exemplarische Vorgehensweise: Hinzufügen einer Gruppe zum Menüband für die Serverkomponente

Artikel
09/24/2014

Letzte Änderung: Montag, 7. Februar 2011

Gilt für: SharePoint Foundation 2010

Inhalt dieses Artikels
Erstellen eines SharePoint-Projekts
Hinzufügen eines neuen Features
Definieren der benutzerdefinierten Aktion
Bereitstellen der Anpassung

In diesem Thema erfahren Sie, wie Sie dem Menüband für die Serverkomponente in Microsoft SharePoint Foundation eine neue Gruppe hinzufügen. Um eine neue Gruppe hinzuzufügen, müssen Sie die Registerkarte auf dem Menüband angeben, auf der die Gruppe angezeigt werden soll. Außerdem legen Sie die Steuerelemente in der Gruppe sowie deren Darstellung fest. Mit dem folgenden Verfahren wird der Registerkarte Page für eine Website eine neue Gruppe hinzugefügt.

Voraussetzungen

Microsoft SharePoint Foundation 2010

SharePoint-Entwicklungstools in Microsoft Visual Studio 2010

Erstellen eines SharePoint-Projekts

Um eine neue Gruppe hinzuzufügen, erstellen Sie zunächst ein leeres SharePoint-Projekt.

So erstellen Sie ein SharePoint-Projekt

Starten Sie Visual Studio 2010.
Zeigen Sie im Menü Datei auf Neu, und klicken Sie dann auf Projekt.
Wählen Sie in Projekttypen unter Visual Basic oder C# die Option Leeres SharePoint-Projekt aus.
Geben Sie AddARibbonGroup als Projektnamen ein, und klicken Sie auf OK.
Wählen Sie im Assistenten zum Anpassen von SharePoint Als Sandkastenlösung bereitstellen aus, und klicken Sie dann auf Fertig stellen.

Hinzufügen eines neuen Features

Sie können das Menüband mithilfe eines Features anpassen. Mit den folgenden Schritten fügen Sie der Lösung ein neues Feature hinzu.

So fügen Sie ein neues Feature hinzu

Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf Features, und wählen Sie Funktion hinzufügen aus.
Ändern Sie den Titel des Features in Benutzerdefinierte Menübandgruppe.
Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf Feature1, und wählen Sie Umbenennen aus. Geben Sie CustomRibbonGroup als neuen Namen ein.
Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf das Projekt AddARibbonGroup, zeigen Sie auf Hinzufügen, und klicken Sie dann auf Neues Element.
Wählen Sie im Dialogfeld Neues Element hinzufügen die Vorlage Leeres Element aus. Geben Sie CustomRibbonGroup als Namen ein.

Definieren der benutzerdefinierten Aktion

Die Menübandgruppe wird mithilfe von Menüband-XML in einer benutzerdefinierten Aktion definiert. Dabei wird festgelegt, wo die Gruppe auf dem Menüband angezeigt werden soll. Eine ausführliche Erklärung von Menüband-XML finden Sie unter XML für das Menüband für die Serverkomponente.

So definieren Sie die benutzerdefinierte Aktion

Öffnen Sie die Datei Elements.xml.

Kopieren Sie den folgenden XML-Code, und fügen Sie ihn in die Datei Elements.xml ein. Mit diesem XML-Code wird die neue Gruppe Custom mit zwei Schaltflächen zur Registerkarte Page für eine Website hinzugefügt.

Wichtig
Sie müssen die Attribute Image32by32 und Image16by16 durch gültige Bild-URLs ersetzen.

<?xml version="1.0" encoding="utf-8"?>
<Elements xmlns="https://schemas.microsoft.com/sharepoint/">
  <CustomAction 
    Id="Ribbon.WikiPageTab.CustomGroup" 
    Location="CommandUI.Ribbon">
    <CommandUIExtension>
      <CommandUIDefinitions>
        <CommandUIDefinition 
          Location="Ribbon.WikiPageTab.Groups._children">
          <Group 
            Id="Ribbon.WikiPageTab.CustomGroup" 
            Sequence="55" 
            Description="Custom Group" 
            Title="Custom" 
            Command="EnableCustomGroup" 
            Template="Ribbon.Templates.Flexible2">
            <Controls Id="Ribbon.WikiPageTab.CustomGroup.Controls">
              <Button 
                Id="Ribbon.WikiPageTab.CustomGroup.CustomGroupHello" 
                Command="CustomGroupHelloWorld" 
                Image16by16="Insert an image URL here." 
                Image32by32="Insert an image URL here." 
                LabelText="Hello, World" 
                TemplateAlias="o2" 
                Sequence="15" />
              <Button 
                Id="Ribbon.WikiPageTab.CustomGroup.CustomGroupGoodbye" 
                Command="CustomGroupGoodbyeWorld" 
                Image16by16="Insert an image URL here." 
                Image32by32="Insert an image URL here." 
                LabelText="Good-bye, World" 
                TemplateAlias="o2" 
                Sequence="18" />
            </Controls>
          </Group>
        </CommandUIDefinition>
        <CommandUIDefinition 
          Location="Ribbon.WikiPageTab.Scaling._children">
          <MaxSize 
            Id="Ribbon.WikiPageTab.Scaling.CustomGroup.MaxSize" 
            Sequence="15" 
            GroupId="Ribbon.WikiPageTab.CustomGroup" 
            Size="LargeLarge" />
        </CommandUIDefinition>
      </CommandUIDefinitions>
      <CommandUIHandlers>
        <CommandUIHandler 
          Command="EnableCustomGroup"
          CommandAction=”javascript:return true;” />
        <CommandUIHandler 
          Command="CustomGroupHelloWorld" 
          CommandAction="javascript:alert('Hello, world!');" />
        <CommandUIHandler 
          Command="CustomGroupGoodbyeWorld" 
          CommandAction="javascript:alert('Good-bye, world!');" />
      </CommandUIHandlers>
    </CommandUIExtension>
  </CustomAction>
</Elements>

Bereitstellen der Anpassung

Da das Projekt als Lösung mit eingeschränkter Sicherheitsstufe eingerichtet wurde, wird es im Lösungskatalog bereitgestellt.

So stellen Sie die Anpassung bereit

Drücken Sie F5. Die SharePoint-Entwicklungstools in Visual Studio 2010 erstellen das Feature automatisch und stellen es bereit.
Navigieren Sie zur Homepage Ihrer Website oder Unterwebsite.
Klicken Sie auf die Registerkarte Page, suchen Sie die Gruppe Custom, und klicken Sie auf die Schaltfläche Hello, World oder Good-bye, World.

Siehe auch

Aufgaben

Exemplarische Vorgehensweise: Hinzufügen einer Registerkarte zum Menüband für die Serverkomponente

Konzepte

Deklarative Anpassung des Menübands der Serverkomponente

Freigeben über