Menu.MergeMenu(Menu) Menu.MergeMenu(Menu) Menu.MergeMenu(Menu) Menu.MergeMenu(Menu) Method

定義

1 つのメニューの MenuItem オブジェクトを現在のメニューにマージします。Merges the MenuItem objects of one menu with the current menu.

public:
 virtual void MergeMenu(System::Windows::Forms::Menu ^ menuSrc);
public virtual void MergeMenu (System.Windows.Forms.Menu menuSrc);
abstract member MergeMenu : System.Windows.Forms.Menu -> unit
override this.MergeMenu : System.Windows.Forms.Menu -> unit
Public Overridable Sub MergeMenu (menuSrc As Menu)

パラメーター

menuSrc
Menu Menu Menu Menu

現在のメニューのメニュー項目にメニュー項目がマージされている MenuThe Menu whose menu items are merged with the menu items of the current menu.

例外

メニューをそのメニュー自身にマージしようとしました。It was attempted to merge the menu with itself.

この例では、とmainMenu1mainMenu2いう2つのメニューを作成します。This example creates two menus, mainMenu1 and mainMenu2. 最初のメニューにはMenuItemFileが1つ含まれてMenuItemEditます。2つ目のメニューには、が含まれています。The first menu contains one MenuItem, File, and the second contains one MenuItem, Edit. メソッドを使用するmainMenu2と、はmainMenu1とマージされます。 MergeMenuUsing the MergeMenu method, mainMenu2 is merged with mainMenu1. 表示mainMenu1されると、には、 FileEditの2つのメニュー項目が含まれます。When displayed, mainMenu1 will contain the two menu items, File and Edit. この例では、という名前Form Form1のを作成している必要があります。This example requires that you have created a Form named Form1.

private:
   void InitializeMyMainMenu()
   {
      // Create the 2 menus and the menu items to add.
      MainMenu^ mainMenu1 = gcnew MainMenu;
      MainMenu^ mainMenu2 = gcnew MainMenu;
      MenuItem^ menuItem1 = gcnew MenuItem;
      MenuItem^ menuItem2 = gcnew MenuItem;

      // Set the caption for the menu items.
      menuItem1->Text = "File";
      menuItem2->Text = "Edit";

      // Add a menu item to each menu for displaying.
      mainMenu1->MenuItems->Add( menuItem1 );
      mainMenu2->MenuItems->Add( menuItem2 );

      // Merge mainMenu2 with mainMenu1
      mainMenu1->MergeMenu( mainMenu2 );

      // Assign mainMenu1 to the form.
      this->Menu = mainMenu1;
   }
      private void InitializeMyMainMenu()
      {
          // Create the 2 menus and the menu items to add.
          MainMenu mainMenu1 = new MainMenu();
          MainMenu mainMenu2 = new MainMenu();

          MenuItem menuItem1 = new MenuItem();
          MenuItem menuItem2 = new MenuItem();

          // Set the caption for the menu items.
          menuItem1.Text = "File";
          menuItem2.Text = "Edit";

          // Add a menu item to each menu for displaying.
          mainMenu1.MenuItems.Add(menuItem1);
          mainMenu2.MenuItems.Add(menuItem2);

          // Merge mainMenu2 with mainMenu1
          mainMenu1.MergeMenu(mainMenu2);

          // Assign mainMenu1 to the form.
          this.Menu = mainMenu1;
      }
Private Sub InitializeMyMainMenu()
    ' Create the 2 menus and the menu items to add.
    Dim mainMenu1 As New MainMenu()
    Dim mainMenu2 As New MainMenu()

    Dim menuItem1 As New MenuItem()
    Dim menuItem2 As New MenuItem()

    ' Set the caption for the menu items.
    menuItem1.Text = "File"
    menuItem2.Text = "Edit"

    ' Add a menu item to each menu for displaying.
    mainMenu1.MenuItems.Add(menuItem1)
    mainMenu2.MenuItems.Add(menuItem2)

    ' Merge mainMenu2 with mainMenu1
    mainMenu1.MergeMenu(mainMenu2)

    ' Assign mainMenu1 to the form.
    Me.Menu = mainMenu1
End Sub

注釈

このメソッドはMenuItem 、あるメニューのオブジェクトを現在のメニューとマージします。This method merges MenuItem objects from one menu with the current menu. MenuItemオブジェクトは、プロパティMenuItem.MergeTypeMenuItem.MergeOrderプロパティの値に従ってマージされます。MenuItem objects are merged according to the values of the MenuItem.MergeType and MenuItem.MergeOrder properties.

メニューのマージは、通常、マルチドキュメントインターフェイス (MDI) 親フォームのメニューと、アクティブな MDI 子フォームのメニューをマージするために行われます。Menu merging is typically done to merge the menus of a Multiple Document Interface (MDI) parent form with those of its active MDI child form. これは、.NET Framework 共通言語ランタイムによって自動的に実行されます。This is performed automatically by the .NET Framework common language runtime. たとえば、MDI 親フォームにファイルを処理するための一連のメニューが含まれており、MDI 子フォームにファイル関連のメニュー項目がある場合、子フォームが MDI 親フォームに表示されるときに、メニューセットが自動的に1つのファイルメニューセットにマージされます。For example, if an MDI parent form contains a set of menus for handling files and your MDI child form also has file-related menu items, the menu sets will automatically merge into a single file menu set when the child form is displayed in the MDI parent form.

MDI アプリケーションに含まMergeMenuれていない2つのメニュー構造をマージする場合は、メソッドを使用できます。You can use the MergeMenu method if you are merging two menu structures that are not part of an MDI application. この実装は、クラスまたはMainMenu ContextMenuクラスによって呼び出され、から派生する 2 Menuつ以上のオブジェクトをマージできます。This implementation can be called by the MainMenu or ContextMenu classes to merge two or more objects that derive from Menu.

2つMenuItemのオブジェクトをマージMenuItem.MergeMenuするには、メソッドを使用します。To merge two MenuItem objects use the MenuItem.MergeMenu method.

適用対象

こちらもご覧ください