方法: ショートカットメニュー項目をカスタム SharePoint プロジェクト項目の種類に追加する

2011-08-09

カスタムの SharePoint プロジェクト項目の種類を定義する場合は、ショートカットメニュー項目にプロパティを追加できます。このメニュー項目は、ユーザーがソリューションエクスプローラーでプロジェクト項目を右クリックすると表示されます。

次の手順は、独自の SharePoint プロジェクト項目の種類が既に定義されていることを前提としています。詳細については、「方法: SharePoint プロジェクト項目の種類を定義する」を参照してください。

ショートカットメニュー項目をカスタムプロジェクト項目の種類に追加するには

ISharePointProjectItemTypeProvider 実装の InitializeType メソッドで、projectItemTypeDefinition パラメーターの ProjectItemMenuItemsRequested イベントを処理します。
ProjectItemMenuItemsRequested イベントのイベントハンドラーで、新しい IMenuItem オブジェクトをイベント引数パラメーターの ViewMenuItems コレクションまたは AddMenuItems コレクションに追加します。
新しい IMenuItem オブジェクトの Click イベントハンドラーで、ユーザーがショートカットメニュー項目をクリックしたときに実行するタスクを実行します。

例

コンテキストメニュー項目をカスタムのプロジェクト項目の種類に追加する方法を次のコード例に示します。ユーザーがソリューションエクスプローラーでプロジェクト項目を右クリックし、[出力ウィンドウへのメッセージの書き込み] メニュー項目をクリックすると、Visual Studio の [出力] ウィンドウにメッセージが表示されます。

Imports System
Imports System.ComponentModel.Composition
Imports Microsoft.VisualStudio.SharePoint

Namespace Contoso.Examples.ProjectItemTypeWithMenu

    <Export(GetType(ISharePointProjectItemTypeProvider))> _
    <SharePointProjectItemType("Contoso.ExampleProjectItemType")> _
    <SharePointProjectItemIcon("ExampleProjectItemType.ProjectItemIcon.ico")> _
    Friend Class ExampleProjectItemTypeWithMenu
        Implements ISharePointProjectItemTypeProvider

        Private Sub InitializeType(ByVal projectItemTypeDefinition As ISharePointProjectItemTypeDefinition) _
            Implements ISharePointProjectItemTypeProvider.InitializeType
            projectItemTypeDefinition.Name = "ExampleProjectItemType"
            projectItemTypeDefinition.SupportedDeploymentScopes = _
                SupportedDeploymentScopes.Site Or SupportedDeploymentScopes.Web
            projectItemTypeDefinition.SupportedTrustLevels = SupportedTrustLevels.All

            AddHandler projectItemTypeDefinition.ProjectItemMenuItemsRequested, AddressOf ProjectItemMenuItemsRequested
        End Sub

        Private Sub ProjectItemMenuItemsRequested(ByVal Sender As Object,
            ByVal e As SharePointProjectItemMenuItemsRequestedEventArgs)
            Dim menuItem As IMenuItem = e.ViewMenuItems.Add("Write Message to Output Window")
            AddHandler menuItem.Click, AddressOf MenuItem_Click
        End Sub

        Private Sub MenuItem_Click(ByVal Sender As Object, ByVal e As MenuItemEventArgs)
            Dim projectItem As ISharePointProjectItem = CType(e.Owner, ISharePointProjectItem)
            projectItem.Project.ProjectService.Logger.WriteLine(
                String.Format("This message was written from a shortcut menu for {0}.", projectItem.Name),
                LogCategory.Status)
        End Sub
    End Class
End Namespace

using System;
using System.ComponentModel.Composition;
using Microsoft.VisualStudio.SharePoint;

namespace Contoso.Examples.ProjectItemTypeWithMenu
{
    [Export(typeof(ISharePointProjectItemTypeProvider))]
    [SharePointProjectItemType("Contoso.ExampleProjectItemType")]
    [SharePointProjectItemIcon("ExampleProjectItemType.ProjectItemIcon.ico")]
    internal class ExampleProjectItemTypeWithMenu : ISharePointProjectItemTypeProvider
    {
        public void InitializeType(ISharePointProjectItemTypeDefinition projectItemTypeDefinition)
        {
            projectItemTypeDefinition.Name = "ExampleProjectItemType";
            projectItemTypeDefinition.SupportedDeploymentScopes =
                SupportedDeploymentScopes.Site | SupportedDeploymentScopes.Web;
            projectItemTypeDefinition.SupportedTrustLevels = SupportedTrustLevels.All;

            projectItemTypeDefinition.ProjectItemMenuItemsRequested += 
                projectItemTypeDefinition_ProjectItemMenuItemsRequested;
        }

        void projectItemTypeDefinition_ProjectItemMenuItemsRequested(object sender,
            SharePointProjectItemMenuItemsRequestedEventArgs e)
        {
            IMenuItem menuItem = e.ViewMenuItems.Add("Write Message to Output Window");
            menuItem.Click += MenuItemExtension_Click;
        }

        void MenuItemExtension_Click(object sender, MenuItemEventArgs e)
        {
            ISharePointProjectItem projectItem = (ISharePointProjectItem)e.Owner;
            projectItem.Project.ProjectService.Logger.WriteLine(
                String.Format("This message was written from a shortcut menu for {0}.", projectItem.Name),
                LogCategory.Status);
        }
    }
}

この例では、SharePoint プロジェクトサービスを使用して、出力ウィンドウにメッセージを書き込みます。詳細については、「SharePoint プロジェクトサービスの使用」を参照してください。

コードのコンパイル

この例では、次のアセンブリへの参照を含むクラスライブラリプロジェクトが必要です。

Microsoft.VisualStudio.SharePoint
System.ComponentModel.Composition

プロジェクト項目の配置

自分が定義したプロジェクト項目を他の開発者が使用できるようにするには、プロジェクトテンプレートまたはプロジェクト項目テンプレートを作成します。詳細については、「SharePoint プロジェクト項目の項目テンプレートとプロジェクトテンプレートの作成」を参照してください。

プロジェクト項目を配置するには、同梱する必要のあるアセンブリやテンプレート、各種ファイルの Visual Studio 拡張機能 (VSIX) パッケージを作成します。詳細については、「Visual Studio での SharePoint ツールの拡張機能の配置」を参照してください。

参照

処理手順

方法: SharePoint プロジェクト項目の種類を定義する

その他の技術情報

方法: プロパティをカスタムの SharePoint プロジェクト項目の種類に追加する

SharePoint プロジェクト項目の種類の定義

次の方法で共有

方法: ショートカット メニュー項目をカスタム SharePoint プロジェクト項目の種類に追加する

ショートカット メニュー項目をカスタム プロジェクト項目の種類に追加するには

例