MenuItem クラス

リファレンス

定義

名前空間:: System.Windows.Forms

アセンブリ:: System.Windows.Forms.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

MainMenu または ContextMenu 内に表示される個別の項目を表します。

このクラスは .NET Core 3.1 以降のバージョンでは利用できません。代わりにを使用 ToolStripMenuItem します。これはコントロールを MenuItem 置き換えます。

public ref class MenuItem : System::Windows::Forms::Menu

public class MenuItem : System.Windows.Forms.Menu

type MenuItem = class
    inherit Menu

Public Class MenuItem
Inherits Menu

継承: Object

MarshalByRefObject

Component

Menu
MenuItem

例

次のコード例では、フォームのメニュー構造を作成します。このコード例では、を追加 MenuItem して最上位のメニュー項目を表し、フォントサイズを選択するためのサブメニュー項目を追加し、そのメニュー項目に 2 つのサブメニュー項目を追加します。このサブメニュー項目は、アプリケーション内の大小のフォント選択を表します。この例では、という名前の MainMenu オブジェクトと、、 menuItem4menuItem3menuItem2という名前menuItem1の 4 つのMenuItemオブジェクトが必要です。mainMenu1

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.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 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

注釈

このクラスは .NET Core 3.1 以降のバージョンでは利用できません。代わりに、ToolStripMenuItem を使用してください。

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

クラスには MenuItem 、メニュー項目の外観と機能を構成できるプロパティが用意されています。メニュー項目の横にチェックマークを表示するには、プロパティをChecked使用します。この機能を使用すると、相互に排他的なメニュー項目の一覧で選択されているメニュー項目を識別できます。たとえば、コントロール内のテキスト TextBox の色を設定するためのメニュー項目のセットがある場合は、プロパティを Checked 使用して、現在選択されている色を識別できます。プロパティを Shortcut 使用して、メニュー項目を選択するために押すことができるキーボードの組み合わせを定義できます。

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

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

コンストラクター

MenuItem()	空白のキャプションを使用して、MenuItem を初期化します。
MenuItem(MenuMerge, Int32, Shortcut, String, EventHandler, EventHandler, EventHandler, MenuItem[])	キャプション、MenuItem、Click、Select の各イベントに対して定義されているイベントハンドラー、メニュー項目のショートカットキー、マージの種類、およびマージ順序を指定して、Popup クラスの新しいインスタンスを初期化します。
MenuItem(String)	メニュー項目のキャプションを指定して、MenuItem クラスの新しいインスタンスを初期化します。
MenuItem(String, EventHandler)	メニュー項目のキャプション、Click イベントを処理するイベントハンドラーを指定して、クラスの新しいインスタンスを初期化します。
MenuItem(String, EventHandler, Shortcut)	メニュー項目のキャプション、イベントハンドラー、関連付けられているショートカットキーを指定して、クラスの新しいインスタンスを初期化します。
MenuItem(String, MenuItem[])	メニュー項目のキャプション、メニュー項目に対して定義されているサブメニュー項目の配列を指定して、クラスの新しいインスタンスを初期化します。

フィールド

FindHandle	FindMenuItem(Int32, IntPtr) メソッドでハンドルを検索するよう指定します。 (継承元 Menu)
FindShortcut	FindMenuItem(Int32, IntPtr) メソッドでショートカットを検索するよう指定します。 (継承元 Menu)

プロパティ

BarBreak	MenuItem が、新しい行 (MainMenu オブジェクトに追加されたメニュー項目の場合) または新しい列 (ContextMenu に表示されるサブメニュー項目またはメニュー項目の場合) に配置されるかどうかを示す値を取得または設定します。
Break	項目が、新しい行 (MainMenu オブジェクトに追加されたメニュー項目の場合) または新しい列 (ContextMenu に表示されるサブメニュー項目またはメニュー項目の場合) に配置されるかどうかを示す値を取得または設定します。
CanRaiseEvents	コンポーネントがイベントを発生させることがきるかどうかを示す値を取得します。 (継承元 Component)
Checked	メニュー項目のテキストの横にチェックマークを表示するかどうかを示す値を取得または設定します。
Container	IContainer を含む Component を取得します。 (継承元 Component)
DefaultItem	メニュー項目が既定のメニュー項目かどうかを示す値を取得または設定します。
DesignMode	Component が現在デザインモードかどうかを示す値を取得します。 (継承元 Component)
Enabled	メニュー項目が有効であるどうかを示す値を取得または設定します。
Events	Component に結び付けられているイベントハンドラーのリストを取得します。 (継承元 Component)
Handle	メニューのウィンドウハンドルを表している値を取得します。 (継承元 Menu)
Index	親メニュー内のメニュー項目の位置を示す値を取得または設定します。
IsParent	メニュー項目に子メニュー項目が含まれているかどうかを示す値を取得します。
MdiList	メニュー項目に、関連付けられているフォーム内に表示されるマルチドキュメントインターフェイス (MDI) 子ウィンドウのリストを表示するかどうかを示す値を取得または設定します。
MdiListItem	マルチドキュメントインターフェイス (MDI) 子フォームの一覧を表示するために使用される MenuItem を示す値を取得します。 (継承元 Menu)
MenuID	メニュー項目の Windows 識別子を示す値を取得します。
MenuItems	メニューに関連付けられている MenuItem オブジェクトのコレクションを示す値を取得します。 (継承元 Menu)
MergeOrder	メニュー項目が別のメニューにマージされた場合に、そのメニュー項目がマージ後のメニューで占める位置を相対的に示す値を取得または設定します。
MergeType	メニュー項目が別のメニューにマージされた場合に、そのメニュー項目がどのように動作するかを示す値を取得または設定します。
Mnemonic	メニュー項目に関連付けられているニーモニック文字を示す値を取得します。
Name	Menu の名前を取得または設定します。 (継承元 Menu)
OwnerDraw	指定したコードがメニュー項目を描画するのか、Windows がメニュー項目を描画するのかを示す値を取得または設定します。
Parent	このメニュー項目が含まれているメニューを示す値を取得します。
RadioCheck	MenuItem がチェックされている場合、チェックマークの代わりにオプションボタンを表示するかどうかを示す値を取得または設定します。
Shortcut	メニュー項目に関連付けられているショートカットキーを示す値を取得または設定します。
ShowShortcut	メニュー項目のキャプションの横に、そのメニュー項目に関連付けられているショートカットキーを表示するかどうかを示す値を取得または設定します。
Site	Component の ISite を取得または設定します。 (継承元 Component)
Tag	コントロールに関連付けられたユーザー定義のデータを取得または設定します。 (継承元 Menu)
Text	メニュー項目のキャプションを示す値を取得または設定します。
Visible	メニュー項目を表示するかどうかを示す値を取得または設定します。

メソッド

CloneMenu()	現在の MenuItem のコピーを作成します。
CloneMenu(Menu)	現在の Menu にパラメーターとして渡された Menu をコピーします。 (継承元 Menu)
CloneMenu(MenuItem)	指定した MenuItem のコピーを作成します。
CreateMenuHandle()	Menu への新しいハンドルを作成します。 (継承元 Menu)
CreateObjRef(Type)	リモートオブジェクトとの通信に使用するプロキシの生成に必要な情報をすべて格納しているオブジェクトを作成します。 (継承元 MarshalByRefObject)
Dispose()	Component によって使用されているすべてのリソースを解放します。 (継承元 Component)
Dispose(Boolean)	MenuItem で使用されていたリソース (メモリを除く) を解放します。
Equals(Object)	指定されたオブジェクトが現在のオブジェクトと等しいかどうかを判断します。 (継承元 Object)
FindMenuItem(Int32, IntPtr)	指定した値を含む MenuItem を取得します。 (継承元 Menu)
FindMergePosition(Int32)	メニューにおけるメニュー項目の追加位置を返します。 (継承元 Menu)
GetContextMenu()	メニューを格納している ContextMenu を取得します。 (継承元 Menu)
GetHashCode()	既定のハッシュ関数として機能します。 (継承元 Object)
GetLifetimeService()	古い. 対象のインスタンスの有効期間ポリシーを制御する、現在の有効期間サービスオブジェクトを取得します。 (継承元 MarshalByRefObject)
GetMainMenu()	メニューを格納している MainMenu を取得します。 (継承元 Menu)
GetService(Type)	Component またはその Container で提供されるサービスを表すオブジェクトを返します。 (継承元 Component)
GetType()	現在のインスタンスの Type を取得します。 (継承元 Object)
InitializeLifetimeService()	古い. このインスタンスの有効期間ポリシーを制御する有効期間サービスオブジェクトを取得します。 (継承元 MarshalByRefObject)
MemberwiseClone()	現在の Object の簡易コピーを作成します。 (継承元 Object)
MemberwiseClone(Boolean)	現在の MarshalByRefObject オブジェクトの簡易コピーを作成します。 (継承元 MarshalByRefObject)
MergeMenu()	この MenuItem と別の MenuItem をマージし、マージ後に作成された MenuItem を返します。
MergeMenu(Menu)	1 つのメニューの MenuItem オブジェクトを現在のメニューにマージします。 (継承元 Menu)
MergeMenu(MenuItem)	別のメニュー項目とこのメニュー項目をマージします。
OnClick(EventArgs)	Click イベントを発生させます。
OnDrawItem(DrawItemEventArgs)	DrawItem イベントを発生させます。
OnInitMenuPopup(EventArgs)	Popup イベントを発生させます。
OnMeasureItem(MeasureItemEventArgs)	MeasureItem イベントを発生させます。
OnPopup(EventArgs)	Popup イベントを発生させます。
OnSelect(EventArgs)	Select イベントを発生させます。
PerformClick()	Click の MenuItem イベントを生成し、ユーザーによるクリック操作をシミュレートします。
PerformSelect()	このメニュー項目に Select イベントを発生させます。
ProcessCmdKey(Message, Keys)	コマンドキーを処理します。 (継承元 Menu)
ToString()	MenuItem を表す文字列を返します。

イベント

Click	メニュー項目に対して定義されているショートカットキーまたはアクセスキーを使用して、そのメニュー項目がクリックまたは選択されると発生します。
Disposed	Dispose() メソッドの呼び出しによってコンポーネントが破棄されるときに発生します。 (継承元 Component)
DrawItem	メニュー項目の OwnerDraw プロパティが `true` に設定されていて、そのメニュー項目の描画が要求された場合に発生します。
MeasureItem	メニューにメニュー項目を描画する前に、そのメニュー項目のサイズを確認する必要がある場合に発生します。
Popup	メニュー項目のリストが表示される前に発生します。
Select	ユーザーがメニュー項目の上にポインターを置いた場合に発生します。

適用対象

次の方法で共有