MenuItem クラス

定義

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
継承

次のコード例では、フォームのメニュー構造を作成します。 このコード例では、 を追加 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と など、 MainMenuContextMenuを複数の場所で同時に再利用することはできないため、 メソッドをCloneMenu使用して、 のコピーを作成して別のMenuItem場所で使用できます。

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

コンストラクター

MenuItem()

空白のキャプションを使用して、MenuItem を初期化します。

MenuItem(MenuMerge, Int32, Shortcut, String, EventHandler, EventHandler, EventHandler, MenuItem[])

キャプション、MenuItemClickSelect の各イベントに対して定義されているイベント ハンドラー、メニュー項目のショートカット キー、マージの種類、およびマージ順序を指定して、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

ComponentISite を取得または設定します。

(継承元 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()

ClickMenuItem イベントを生成し、ユーザーによるクリック操作をシミュレートします。

PerformSelect()

このメニュー項目に Select イベントを発生させます。

ProcessCmdKey(Message, Keys)

コマンド キーを処理します。

(継承元 Menu)
ToString()

MenuItem を表す文字列を返します。

events

Click

メニュー項目に対して定義されているショートカット キーまたはアクセス キーを使用して、そのメニュー項目がクリックまたは選択されると発生します。

Disposed

Dispose() メソッドの呼び出しによってコンポーネントが破棄されるときに発生します。

(継承元 Component)
DrawItem

メニュー項目の OwnerDraw プロパティが true に設定されていて、そのメニュー項目の描画が要求された場合に発生します。

MeasureItem

メニューにメニュー項目を描画する前に、そのメニュー項目のサイズを確認する必要がある場合に発生します。

Popup

メニュー項目のリストが表示される前に発生します。

Select

ユーザーがメニュー項目の上にポインターを置いた場合に発生します。

適用対象

こちらもご覧ください