MainMenu クラス

.NET Framework クラス ライブラリ リファレンス

MainMenu クラス

フォームのメニュー構造を表します。MenuStrip では、以前のバージョンの MainMenu コントロールの機能が置換または追加されていますが、下位互換性を維持し、必要に応じて今後も使用できるように、MainMenu も残されています。

名前空間: System.Windows.Forms
アセンブリ: System.Windows.Forms (system.windows.forms.dll 内)
構文

Visual Basic (宣言)

Public Class MainMenu
    Inherits Menu

Visual Basic (使用法)

Dim instance As MainMenu

C#

public class MainMenu : Menu

C++

public ref class MainMenu : public
 Menu

J#

public class MainMenu extends Menu

JScript

public class MainMenu extends
 Menu

解説

MainMenu コントロールは、フォームのメニュー構造のコンテナを表します。メニューは、メニュー構造のそれぞれのメニュー コマンドを表す MenuItem オブジェクトで構成されます。各 MenuItem は、アプリケーションのコマンドである場合と、ほかのサブメニュー項目の親メニューである場合とがあります。MainMenu を表示するために Form にそのメイン メニューを関連付けるには、MainMenu を適切な Form の Menu プロパティに割り当てます。

複数言語をサポートするアプリケーションの場合は、RightToLeft プロパティを使用してメニューのテキストを右から左に向かって表示し、アラビア語などの言語をサポートできます。

異なる MainMenu オブジェクトを作成して、フォームで使用するさまざまなメニュー構造を表すことができます。特定の MainMenu に格納されているメニュー構造を再利用する場合、CloneMenu メソッドを使用してコピーを作成できます。メニュー構造のコピーを作成したら、そのコピーを適宜変更し、新しいメニュー構造を完成させることができます。

メモ
デザイナでフォーム上のメニュー項目を切り取り、別のフォームへ貼り付けても、貼り付け先のフォームにメニュー項目が定義されていないと、期待どおりに動作しません。

使用例

MainMenu を作成して 2 つの MenuItem オブジェクトを割り当て、その MainMenu をフォームに関連付けるコード例を次に示します。この例では、Form1 という名前の Form が作成されている必要があります。

Visual Basic

Public Sub CreateMyMainMenu()
    ' Create an empty MainMenu.
    Dim mainMenu1 As New
 MainMenu()
       
    Dim menuItem1 As New
 MenuItem()
    Dim menuItem2 As New
 MenuItem()
       
    menuItem1.Text = "File"
    menuItem2.Text = "Edit"
    ' Add two MenuItem objects to the MainMenu.
    mainMenu1.MenuItems.Add(menuItem1)
    mainMenu1.MenuItems.Add(menuItem2)
       
    ' Bind the MainMenu to Form1.
    Menu = mainMenu1
End Sub

C#

public void CreateMyMainMenu()
{
   // Create an empty MainMenu.
   MainMenu mainMenu1 = new MainMenu();

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

   menuItem1.Text = "File";
   menuItem2.Text = "Edit";
   // Add two MenuItem objects to the MainMenu.
   mainMenu1.MenuItems.Add(menuItem1);
   mainMenu1.MenuItems.Add(menuItem2);
   
   // Bind the MainMenu to Form1.
   Menu = mainMenu1;   
}

C++

void CreateMyMainMenu()
{
   // Create an empty MainMenu.
   MainMenu^ mainMenu1 = gcnew MainMenu;
   MenuItem^ menuItem1 = gcnew MenuItem;
   MenuItem^ menuItem2 = gcnew MenuItem;
   menuItem1->Text = "File";
   menuItem2->Text = "Edit";

   // Add two MenuItem objects to the MainMenu.
   mainMenu1->MenuItems->Add( menuItem1 );
   mainMenu1->MenuItems->Add( menuItem2 );

   // Bind the MainMenu to Form1.
   Menu = mainMenu1;
}

J#

public void CreateMyMainMenu()
{
    // Create an empty MainMenu.
    MainMenu mainMenu1 = new MainMenu();
    MenuItem menuItem1 = new MenuItem();
    MenuItem menuItem2 = new MenuItem();

    menuItem1.set_Text("File");
    menuItem2.set_Text("Edit");

    // Add two MenuItem objects to the MainMenu.
    mainMenu1.get_MenuItems().Add(menuItem1);
    mainMenu1.get_MenuItems().Add(menuItem2);

    // Bind the MainMenu to Form1.
    set_Menu(mainMenu1);
} //CreateMyMainMenu

継承階層

System.Object
   System.MarshalByRefObject
     System.ComponentModel.Component
       System.Windows.Forms.Menu
        System.Windows.Forms.MainMenu

スレッド セーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
MainMenu メンバ
System.Windows.Forms 名前空間
MenuItem
Menu.MenuItemCollection.Add
Form.Menu プロパティ
Menu.MenuItems
MenuStrip
ContextMenuStrip クラス
その他の技術情報
MenuStrip コントロール (Windows フォーム)