ボタンを Server リボンに追加する
最終更新日: 2011年2月7日
適用対象: SharePoint Foundation 2010
この記事の内容
SharePoint プロジェクトの作成
新しいフィーチャーの追加
カスタム アクションの定義
カスタマイズの展開
このトピックでは、新しいボタンを Microsoft SharePoint Foundation の Server リボンに追加する方法について説明します。
前提条件
Microsoft SharePoint Foundation 2010
Microsoft Visual Studio 2010 の SharePoint 開発者ツール
SharePoint プロジェクトの作成
新しいボタンを追加するには、まず、空の SharePoint プロジェクトを作成します。
SharePoint プロジェクトを作成するには
Microsoft Visual Studio 2010 を起動します。
[ファイル] メニューの [新規作成] をポイントし、[プロジェクト] をクリックします。
[プロジェクトの種類] で、[Visual Basic] または [C#] の [空の SharePoint プロジェクト] を選択します。
プロジェクト名として「AddARibbonButton」と入力します。[OK] をクリックします。
SharePoint カスタマイズ ウィザードで [サンドボックス ソリューションとして配置する] を選択し、[完了] をクリックします。
新しいフィーチャーの追加
フィーチャーを使用してリボンをカスタマイズします。次の手順では、新しいフィーチャーをソリューションに追加します。
新しいフィーチャーを追加するには
ソリューション エクスプローラーで [Features] を右クリックし、[フィーチャーの追加] をクリックします。
フィーチャーの [タイトル] を「Custom Ribbon Button」に変更します。
ソリューション エクスプローラーで [Feature1] を右クリックし、[名前の変更] をクリックします。新しい名前として「CustomRibbonButton」と入力します。
ソリューション エクスプローラーで [AddARibbonButton] プロジェクトを右クリックし、[追加] をポイントし、[新しいアイテム] を選択します。
[新しいアイテムの追加] ダイアログ ボックスで [空の要素] テンプレートを選択します。名前として「CustomRibbonButton」と入力します。
カスタム アクションの定義
リボン ボタンは、カスタム アクション内でリボン XML を使用して定義します。リボン XML の詳細については、「Server リボン XML」を参照してください。
カスタム アクションを定義するには
Elements.xml ファイルを開きます。
次の XML を Elements.xml ファイルに貼り付けます。この XML により、ドキュメント ライブラリの [共有と追跡] グループ内の [ライブラリ] タブに新しいボタンが追加されます。
重要 Image32by32 属性と Image16by16 属性を、有効なイメージの URL に置き換えます。
<?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>
カスタマイズの展開
プロジェクトは、サンドボックス ソリューションとして設定されているので、ソリューション ギャラリーに展開されます。
カスタマイズを展開するには
F5 キーを押します。Visual Studio 2010 の SharePoint 開発者ツールによって、フィーチャーの構築と展開が自動で行われます。
サイトまたはサブサイト内のドキュメント ライブラリに移動します。
[ライブラリ] タブをクリックし、[共有と追跡] グループを確認して、[Hello World] ボタンをクリックします。
関連項目
タスク
[チュートリアル] Server リボンからボタンを削除する