MenuItem クラス (System.Windows.Forms)

すべて縮小

言語フィルタ

このページは次のバージョンについて記述しています。

Microsoft Visual Studio 2005/.NET Framework 2.0

その他のバージョンについては、以下の情報を参照してください。

.NET Framework クラスライブラリ

MenuItem クラス

MainMenu または ContextMenu 内に表示される個別の項目を表します。ToolStripMenuItem は以前のバージョンの MenuItem コントロールの機能を置換または追加しますが、選択により、下位互換性および将来の使用のために MenuItem を保持することもできます。

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

構文

Visual Basic (宣言)

Public Class MenuItem
    Inherits Menu

Visual Basic (使用法)

Dim instance As MenuItem

public class MenuItem : Menu

C++

public ref class MenuItem : public Menu

public class MenuItem extends Menu

JScript

public class MenuItem extends Menu

解説

MenuItem を表示するには、MainMenu または ContextMenu に追加する必要があります。サブメニューを作成するには、MenuItem オブジェクトを親 MenuItem の MenuItems プロパティに追加します。

MenuItem クラスには、メニュー項目の外観と機能を設定するためのプロパティがあります。メニュー項目の横にチェックマークを表示するには、Checked プロパティを使用します。この機能を使用すると、一度に 1 つしか選択できない複数のメニュー項目の中で、選択されている 1 つのメニュー項目を識別できます。たとえば、TextBox コントロールのテキストの色を設定するメニュー項目が複数ある場合、Checked プロパティを使用して、現在選択されている色を識別できます。Shortcut プロパティを使用すると、組み合わせて押すことによってメニュー項目を選択できるショートカットキーを定義できます。

マルチドキュメントインターフェイス (MDI: Multiple Document Interface) アプリケーションに表示される MenuItem オブジェクトの場合、MergeMenu メソッドを使用して、MDI 親のメニューと、その子フォームのメニューをマージし、統合したメニュー構造を作成できます。MenuItem は、複数の場所 (MainMenu と ContextMenu など) で同時には使用できないため、別の場所で使用する場合は、CloneMenu メソッドを使用して MenuItem のコピーを作成できます。

Popup イベントを使用すると、メニューを表示する前にタスクを実行できるようになります。たとえば、このイベントを処理するイベントハンドラを作成し、コードの状態に基づいてメニュー項目を表示したり非表示にしたりできます。Select イベントを使用すると、ユーザーがアプリケーションのメニュー項目上にマウスポインタを置いたときに、その項目に関する詳しいヘルプを表示するなどのタスクを実行できます。

使用例

フォームで使用するメニュー構造を作成するコード例を次に示します。この例では、トップレベルメニューの項目を表す MenuItem を追加して、フォントサイズを選択するためのサブメニュー項目を追加します。さらに、そのサブメニュー項目にアプリケーションの大小のフォントの選択肢を表す 2 つのサブメニュー項目を追加します。この例では、mainMenu1 という名前の MainMenu オブジェクト、および menuItem1、menuItem2、menuItem3、menuItem4 という名前の 4 つの MenuItem オブジェクトが作成されている必要があります。

Visual Basic

Public Sub CreateMyMenu()
    ' Set the caption for the top-level menu item.
    menuItem1.Text = "Edit"
    ' Set the caption for the first submenu.
    menuItem2.Text = "Font Size"
    ' Set the caption for menuItem2's first submenu.
    menuItem3.Text = "Small"
    ' Set the checked property to true since this is the default value.
    menuItem3.Checked = True
    ' Define a shortcut key combination for the menu item.
    menuItem3.Shortcut = Shortcut.CtrlS
    ' Set the caption of the second sub menu item of menuItem2.
    menuItem4.Text = "Large"
    ' Define a shortcut key combination for the menu item.
    menuItem4.Shortcut = Shortcut.CtrlL
    ' Set the index of the menu item so it is placed below the first submenu item.
    menuItem4.Index = 1
    ' Add menuItem3 and menuItem4 to menuItem2's list of menu items.
    menuItem2.MenuItems.Add(menuItem3)
    menuItem2.MenuItems.Add(menuItem4)
    ' Add menuItem2 to menuItem1's list of menu items.
    menuItem1.MenuItems.Add(menuItem2)
    ' Add menuItem1 to the MainMenu for displaying.
    mainMenu1.MenuItems.Add(menuItem1)
End Sub

public void CreateMyMenu()
    {
    // Set the caption for the top-level menu item.
    menuItem1.Text = "Edit";
    // Set the caption for the first submenu.
    menuItem2.Text = "Font Size";
    // Set the caption for menuItem2's first submenu.
    menuItem3.Text = "Small";
    // Set the checked property to true since this is the default value.
    menuItem3.Checked = true;
    // Define a shortcut key combination for the menu item.
    menuItem3.Shortcut = Shortcut.CtrlS;
    // Set the caption of the second sub menu item of menuItem2.
    menuItem4.Text = "Large";
    // Define a shortcut key combination for the menu item.
    menuItem4.Shortcut = Shortcut.CtrlL;
    // Set the index of the menu item so it is placed below the first submenu item.
    menuItem4.Index = 1;
    // Add menuItem3 and menuItem4 to menuItem2's list of menu items.
    menuItem2.MenuItems.Add(menuItem3);
    menuItem2.MenuItems.Add(menuItem4);
    // Add menuItem2 to menuItem1's list of menu items.
    menuItem1.MenuItems.Add(menuItem2);
    // Add menuItem1 to the MainMenu for displaying.
    mainMenu1.MenuItems.Add(menuItem1);
    }

C++

public:
   void CreateMyMenu()
   {
      // Set the caption for the top-level menu item.
      menuItem1->Text = "Edit";
      // Set the caption for the first submenu.
      menuItem2->Text = "Font Size";
      // Set the caption for menuItem2's first submenu.
      menuItem3->Text = "Small";
      // Set the checked property to true since this is the default value.
      menuItem3->Checked = true;
      // Define a shortcut key combination for the menu item.
      menuItem3->Shortcut = Shortcut::CtrlS;
      // Set the caption of the second sub menu item of menuItem2.
      menuItem4->Text = "Large";
      // Define a shortcut key combination for the menu item.
      menuItem4->Shortcut = Shortcut::CtrlL;
      // Set the index of the menu item so it is placed below the first submenu item.
      menuItem4->Index = 1;
      // Add menuItem3 and menuItem4 to menuItem2's list of menu items.
      menuItem2->MenuItems->Add( menuItem3 );
      menuItem2->MenuItems->Add( menuItem4 );
      // Add menuItem2 to menuItem1's list of menu items.
      menuItem1->MenuItems->Add( menuItem2 );
      // Add menuItem1 to the MainMenu for displaying.
      mainMenu1->MenuItems->Add( menuItem1 );
   }

public void CreateMyMenu()
{
    // Set the caption for the top-level menu item.
    menuItem1.set_Text("Edit");

    // Set the caption for the first submenu.
    menuItem2.set_Text("Font Size");

    // Set the caption for menuItem2's first submenu.
    menuItem3.set_Text("Small");

    // Set the checked property to true since this is the default value.
    menuItem3.set_Checked(true);

    // Define a shortcut key combination for the menu item.
    menuItem3.set_Shortcut(Shortcut.CtrlS);

    // Set the caption of the second sub menu item of menuItem2.
    menuItem4.set_Text("Large");

    // Define a shortcut key combination for the menu item.
    menuItem4.set_Shortcut(Shortcut.CtrlL);

    // Set the index of the menu item so it is placed below
    //the first submenu item.
    menuItem4.set_Index(1);

    // Add menuItem3 and menuItem4 to menuItem2's list of menu items.
    menuItem2.get_MenuItems().Add(menuItem3);
    menuItem2.get_MenuItems().Add(menuItem4);

    // Add menuItem2 to menuItem1's list of menu items.
    menuItem1.get_MenuItems().Add(menuItem2);

    // Add menuItem1 to the MainMenu for displaying.
    mainMenu1.get_MenuItems().Add(menuItem1);
} //CreateMyMenu

継承階層

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

スレッドセーフ

この型の 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

参照

.NET Framework

.NET Compact Framework

関連項目