グループを Server リボンに追加する

  • [アーティクル]

最終更新日: 2011年2月7日

適用対象: SharePoint Foundation 2010

この記事の内容
SharePoint プロジェクトの作成
新しいフィーチャーの追加
カスタム アクションの定義
カスタマイズの展開

このトピックでは、新しいグループを Microsoft SharePoint Foundation の Server リボンに追加する方法について説明します。グループを追加するには、グループが表示されるリボンのタブを識別します。さらに、グループ内のコントロールを定義し、グループによるこれらのコントロールのレンダリング方法も決定します。次の手順では、新しいグループを Web サイトの [ページ] タブに追加します。

前提条件

Microsoft SharePoint Foundation 2010

Microsoft Visual Studio 2010 の SharePoint 開発者ツール

SharePoint プロジェクトの作成

新しいグループを追加するには、まず、空の SharePoint プロジェクトを作成します。

SharePoint プロジェクトを作成するには

  1. Visual Studio 2010 を起動します。

  2. [ファイル] メニューの [新規作成] をポイントし、[プロジェクト] をクリックします。

  3. [プロジェクトの種類] で、[Visual Basic] または [C#] の [空の SharePoint プロジェクト] を選択します。

  4. プロジェクト名として「AddARibbonGroup」と入力し、[OK] をクリックします。

  5. SharePoint カスタマイズ ウィザードで [サンドボックス ソリューションとして配置する] を選択し、[完了] をクリックします。

新しいフィーチャーの追加

フィーチャーを使用してリボンをカスタマイズします。次の手順では、新しいフィーチャーをソリューションに追加します。

新しいフィーチャーを追加するには

  1. ソリューション エクスプローラーで [Features] を右クリックし、[フィーチャーの追加] を選択します。

  2. フィーチャーの [タイトル] を「Custom Ribbon Tab」に変更します。

  3. ソリューション エクスプローラーで [Feature1] を右クリックし、[名前の変更] を選択します。新しい名前として「CustomRibbonGroup」と入力します。

  4. ソリューション エクスプローラーで [AddARibbonGroup] プロジェクトを右クリックし、[追加] をポイントし、[新しいアイテム] をクリックします。

  5. [新しいアイテムの追加] ダイアログ ボックスで [空の要素] テンプレートを選択します。名前として「CustomRibbonGroup」と入力します。

カスタム アクションの定義

リボン グループは、カスタム アクションのリボン XML を使用して定義します。これにより、リボンのどの場所にグループが表示されるかが識別されます。リボン XML の詳細については、「Server リボン XML」を参照してください。

カスタム アクションを定義するには

  1. Elements.xml ファイルを開きます。

  2. 次の XML を Elements.xml ファイルに貼り付けます。この XML により、新しいカスタム グループと 2 つのボタンが Web サイトの [ページ] タブに追加されます。

    重要重要

    Image32by32 属性と Image16by16 属性を、有効なイメージの URL に置き換えます。

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

カスタマイズの展開

プロジェクトは、サンドボックス ソリューションとして設定されているので、ソリューション ギャラリーに展開されます。

カスタマイズを展開するには

  1. F5 キーを押します。Visual Studio 2010 の SharePoint 開発者ツールによって、フィーチャーの構築と展開が自動で行われます。

  2. サイトまたはサブサイトのホーム ページに移動します。

  3. [ページ] タブをクリックし、カスタム グループを検索して、[Hello, World] または [Good-bye, World] をクリックします。

関連項目

タスク

[チュートリアル] タブを Server リボンに追加する

概念

Server リボンの宣言型カスタマイズ