IMenuCommandService IMenuCommandService IMenuCommandService IMenuCommandService Interface

定義

グローバル デザイナー動詞とデザイン モードで使用できるメニュー コマンドを管理し、いくつかの種類のショートカット メニューを表示するためのメソッドを提供します。Provides methods to manage the global designer verbs and menu commands available in design mode, and to show some types of shortcut menus.

public interface class IMenuCommandService
[System.Runtime.InteropServices.ComVisible(true)]
public interface IMenuCommandService
type IMenuCommandService = interface
Public Interface IMenuCommandService
派生
属性

この例では、IMenuCommandServiceを追加する、MenuCommandします。This example demonstrates using the IMenuCommandService to add a MenuCommand.

   public ref class CDesigner: public ComponentDesigner
   {
   public:
    [PermissionSetAttribute(SecurityAction::Demand, Name="FullTrust")]
      virtual void Initialize( IComponent^ comp ) override
      {
         ComponentDesigner::Initialize( comp );
         IMenuCommandService^ mcs = static_cast<IMenuCommandService^>(comp->Site->GetService( IMenuCommandService::typeid ));
		 MenuCommand^ mc = gcnew MenuCommand( gcnew EventHandler( this, &CDesigner::OnF1Help ),StandardCommands::F1Help );
         mc->Enabled = true;
         mc->Visible = true;
         mc->Supported = true;
         mcs->AddCommand( mc );
         System::Windows::Forms::MessageBox::Show( "Initialize() has been invoked." );
      }

   private:
      void OnF1Help( Object^ /*sender*/, EventArgs^ /*e*/ )
      {
         System::Windows::Forms::MessageBox::Show( "F1Help has been invoked." );
      }
   };
}
[System.Security.Permissions.PermissionSet(System.Security.Permissions.SecurityAction.Demand, Name = "FullTrust")] 
public class CDesigner : System.ComponentModel.Design.ComponentDesigner 
{
    public override void Initialize(IComponent comp) 
    {
        base.Initialize(comp);

        IMenuCommandService mcs = (IMenuCommandService)comp.Site.
                    GetService(typeof(IMenuCommandService));
        MenuCommand mc = new MenuCommand(new EventHandler(OnF1Help), StandardCommands.F1Help);
        mc.Enabled = true;
        mc.Visible = true;
        mc.Supported = true;
        mcs.AddCommand(mc);
        System.Windows.Forms.MessageBox.Show("Initialize() has been invoked.");
    }

    private void OnF1Help(object sender, EventArgs e) 
    {
        System.Windows.Forms.MessageBox.Show("F1Help has been invoked.");
    }
}
<System.Security.Permissions.PermissionSetAttribute(System.Security.Permissions.SecurityAction.Demand, Name:="FullTrust")> _
Public Class CDesigner
    Inherits System.ComponentModel.Design.ComponentDesigner

    Public Overrides Sub Initialize(ByVal comp As IComponent)
        MyBase.Initialize(comp)

        Dim mcs As IMenuCommandService = CType(comp.Site.GetService(GetType(IMenuCommandService)), IMenuCommandService)
        Dim mc As New MenuCommand(New EventHandler(AddressOf OnF1Help), StandardCommands.F1Help)
        mc.Enabled = True
        mc.Visible = True
        mc.Supported = True
        mcs.AddCommand(mc)
        System.Windows.Forms.MessageBox.Show("Initialize() has been invoked.")
    End Sub

    Private Sub OnF1Help(ByVal sender As Object, ByVal e As EventArgs)
        System.Windows.Forms.MessageBox.Show("F1Help has been invoked.")
    End Sub
End Class

注釈

このインターフェイスでは、メソッドを提供します。This interface provides methods to:

  • 検索、起動、追加およびグローバル デザイナー動詞コマンドを削除します。Find, invoke, add and remove global designer verb commands.

  • 検索を呼び出す、追加、および標準メニュー コマンドを削除します。Find, invoke, add and remove standard menu commands.

  • 標準メニュー コマンドに関連付けられているイベント ハンドラーを変更します。Alter the event handlers associated with standard menu commands.

  • メニューに関連付けられている標準のコマンドのショートカット メニューを表示CommandIDします。Display a shortcut menu of standard commands that is associated with a menu CommandID.

デザイナー動詞は、デザイン モードでのショートカット メニューに表示されるカスタム定義のコマンドを表します。Designer verbs represent custom-defined commands that are listed on the shortcut menu in design mode. デザイナー動詞は、指定したテキスト ラベルを提供できます。A designer verb can provide a specified text label. 各デザイナー動詞が自動的に割り当てられている一意CommandIDします。Each designer verb is automatically assigned a unique CommandID. デザイナーがを通じてデザイナー動詞を指定できます、Verbsプロパティが、これらは使用可能な場合にのみ、デザイナーのコンポーネントが現在選択されています。A designer can provide designer verbs through its Verbs property, but these are only available when the designer's component is currently selected. グローバル デザイナー動詞は、選択したコンポーネントに関係なくデザイン モードのショートカット メニューからアクセスできるデザイナー動詞コマンドです。Global designer verbs are designer verb commands that can be accessed from a design-mode shortcut menu regardless of the selected component. このインターフェイスはデザイン モードで使用できるグローバル デザイナー動詞のセットを管理することができます。This interface allows you to manage the set of global designer verbs that are available in design mode.

グローバル デザイナー動詞を使用して、追加することができます、AddVerbメソッド、グローバル デザイナー動詞を使用して、削除できます、RemoveVerbメソッド。You can add a global designer verb using the AddVerb method, and you can remove a global designer verb using the RemoveVerb method. デザイナー動詞を使用して、呼び出すことができます、GlobalInvokeメソッドがわかっている場合、CommandID動詞。You can invoke a designer verb using the GlobalInvoke method if you know the CommandID of the verb. Verbsこのインターフェイスのプロパティには、現在のショートカット メニューに表示するデザイナー動詞コマンドのセットが含まれています。The Verbs property of this interface contains the current set of designer verb commands to display in a shortcut menu. このデザイナー動詞コマンドのセットは、すべてのグローバル デザイナー動詞と、現在選択されているコンポーネントのデザイナーが提供したデザイナー動詞で構成されます。This set of designer verb commands consists of all global designer verbs and any designer verbs offered by the designer of any currently selected component. この動詞のセットは、デザイナー動詞コマンドを提供しているデザイナーのコンポーネントを選択または選択解除するたびに更新されます。This set of verbs is updated each time a component with a designer offering designer verb commands is selected or deselected.

メニュー コマンドは、定義済みの標準コマンドのセットに制限されます。Menu commands are limited to the set of predefined standard commands. 定義済みの標準コマンドのほとんどが定義されている、StandardCommandsMenuCommands列挙体。Most of the predefined standard commands are defined in the StandardCommands and MenuCommands enumerations. 追加して、削除して、メニュー コマンドを起動するか、およびこのインターフェイスのメソッドを使用してメニューに追加されたメニュー コマンドを検索できます。You can add, remove, and invoke menu commands, and search for menu commands that have been added to a menu using methods of this interface.

使用して標準メニュー コマンドを追加することができます、AddCommandメソッド、および削除を使用して標準メニュー コマンド、RemoveCommandメソッド。You can add a standard menu command using the AddCommand method, and remove a standard menu command using the RemoveCommand method. ドキュメントに記載された手順を実行して、定義済みの標準メニュー コマンドにイベント ハンドラーを結び付けることができます、AddCommandメソッド。You can attach an event handler to a predefined standard menu command by following the procedure detailed in the documentation for the AddCommand method. メニュー コマンドを取得するCommandIDを使用してメニューに追加された場合、FindCommandメソッド。You can retrieve a menu command by CommandID if it has been added to a menu using the FindCommand method. メニュー コマンドや、デザイナー動詞コマンドを呼び出すことができますCommandIDを使用して、GlobalInvokeメソッド。You can invoke a menu command or designer verb command by CommandID using the GlobalInvoke method.

注意

既に既存のメニュー コマンドを追加する試みCommandIDがスローされます、InvalidOperationExceptionします。An attempt to add a menu command with an already existing CommandID will throw an InvalidOperationException. メニュー コマンドを追加するときにすることになっていないを使用してメニューを確認してください、FindCommandメソッド、または使用して例外を上手に処理します。When adding a menu command, be sure to check that it is not already on a menu using the FindCommand method, or use exception handling wisely.

注意

メニュー コマンド、メニューに追加できるいてそのVisibleまたはEnabledプロパティに設定falseします。A menu command can be added to a menu, and have its Visible or Enabled properties set to false. メニューに追加されているメニュー コマンド、視覚的に見つからない場合はこれらのプロパティのいずれかに設定されているfalseします。If you cannot visually locate a menu command that has been added on a menu, one of these properties may have been set to false.

メニュー コマンドを使用して、指定した場所に格納している特定の標準のショートカット メニューを表示することができます、ShowContextMenuメソッド。You can show certain standard shortcut menus containing menu commands at a specified location using the ShowContextMenu method. このメソッドは、ドキュメントには、有効なメニューを表示するを指定するコマンド Id の一覧を示すテーブルが含まれています。The documentation for this method contains a table listing the command IDs that specify the valid menus to show.

プロパティ

Verbs Verbs Verbs Verbs

現在使用できるデザイナー動詞のコレクションを取得します。Gets a collection of the designer verbs that are currently available.

メソッド

AddCommand(MenuCommand) AddCommand(MenuCommand) AddCommand(MenuCommand) AddCommand(MenuCommand)

指定した標準メニュー コマンドをメニューに追加します。Adds the specified standard menu command to the menu.

AddVerb(DesignerVerb) AddVerb(DesignerVerb) AddVerb(DesignerVerb) AddVerb(DesignerVerb)

指定したデザイナー動詞をグローバル デザイナー動詞のセットに追加します。Adds the specified designer verb to the set of global designer verbs.

FindCommand(CommandID) FindCommand(CommandID) FindCommand(CommandID) FindCommand(CommandID)

指定したコマンド ID を検索し、その ID に関連付けられているメニュー コマンドを返します。Searches for the specified command ID and returns the menu command associated with it.

GlobalInvoke(CommandID) GlobalInvoke(CommandID) GlobalInvoke(CommandID) GlobalInvoke(CommandID)

指定したコマンド ID に一致するメニューまたはデザイナー動詞コマンドを呼び出します。Invokes a menu or designer verb command matching the specified command ID.

RemoveCommand(MenuCommand) RemoveCommand(MenuCommand) RemoveCommand(MenuCommand) RemoveCommand(MenuCommand)

指定した標準メニュー コマンドをメニューから削除します。Removes the specified standard menu command from the menu.

RemoveVerb(DesignerVerb) RemoveVerb(DesignerVerb) RemoveVerb(DesignerVerb) RemoveVerb(DesignerVerb)

指定したデザイナー動詞をグローバル デザイナー動詞のコレクションから削除します。Removes the specified designer verb from the collection of global designer verbs.

ShowContextMenu(CommandID, Int32, Int32) ShowContextMenu(CommandID, Int32, Int32) ShowContextMenu(CommandID, Int32, Int32) ShowContextMenu(CommandID, Int32, Int32)

指定した位置に指定したショートカット メニューを表示します。Shows the specified shortcut menu at the specified location.

適用対象

こちらもご覧ください