MenuItem クラス

定義

MainMenu または ContextMenu 内に表示される個別の項目を表します。Represents an individual item that is displayed within a MainMenu or ContextMenu. ToolStripMenuItem コントロールは、以前のバージョンの MenuItem コントロールに代わると共に追加の機能を提供します。ただし、MenuItem コントロールは、下位互換性を保つ目的および将来使用する目的で保持されます。Although ToolStripMenuItem replaces and adds functionality to the MenuItem control of previous versions, MenuItem is retained for both backward compatibility and future use if you choose.

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

次のコード例では、フォームのメニュー構造を作成します。The following code example creates a menu structure for a form. このコード例ではMenuItem 、トップレベルのメニュー項目を表すを追加し、フォントサイズを選択するためにサブメニュー項目を追加して、アプリケーションで大きいフォントと小さいフォントの選択肢を表すメニュー項目に2つのサブメニュー項目を追加します。The example code adds a MenuItem to represent the top-level menu item, adds a submenu item to it for selecting a font size, and then adds two submenu items to that menu item that represent large and small font choices in an application. この例では、というMainMenu名前mainMenu1のオブジェクトとMenuItemmenuItem2menuItem1menuItem3、およびとmenuItem4いう名前の4つのオブジェクトが必要です。The example requires that there is a MainMenu object named mainMenu1 and four MenuItem objects named menuItem1, menuItem2, menuItem3, and menuItem4.

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

注釈

を表示するにMainMenuは、をまたはContextMenuに追加する必要があります。 MenuItemIn order for a MenuItem to be displayed, you must add it to a MainMenu or ContextMenu. サブメニューを作成するにはMenuItem 、親MenuItemMenuItemsプロパティにオブジェクトを追加します。To create submenus, you can add MenuItem objects to the MenuItems property of the parent MenuItem.

クラスMenuItemには、メニュー項目の外観と機能を構成できるようにするプロパティが用意されています。The MenuItem class provides properties that enable you to configure the appearance and functionality of a menu item. メニュー項目の横にチェックマークを表示するには、 Checkedプロパティを使用します。To display a check mark next to a menu item, use the Checked property. この機能を使用すると、相互に排他的なメニュー項目の一覧で選択されているメニュー項目を識別できます。You can use this feature to identify a menu item that is selected in a list of mutually exclusive menu items. たとえば、 TextBoxコントロールのテキストの色を設定するための一連のメニュー項目がある場合は、 Checkedプロパティを使用して、現在選択されている色を識別できます。For example, if you have a set of menu items for setting the color of text in a TextBox control, you can use the Checked property to identify which color is currently selected. Shortcutプロパティを使用して、メニュー項目を選択するために押すことができるキーボードの組み合わせを定義できます。The Shortcut property can be used to define a keyboard combination that can be pressed to select the menu item.

マルチMenuItemドキュメントインターフェイス (mdi) アプリケーションに表示されるオブジェクトの場合は、 MergeMenuメソッドを使用して、の MDI 親のメニューを子フォームと結合して、統合メニュー構造を作成できます。For MenuItem objects displayed in a Multiple Document Interface (MDI) application, you can use the MergeMenu method to merge the menus of an MDI parent for with that of its child forms to create a consolidated menu structure. MenuItem MenuItem CloneMenuとなどContextMenuでは、を同時に複数の場所で再利用することはできないため、メソッドを使用して、別の場所で使用するのコピーを作成できます。 MainMenuBecause a MenuItem cannot be reused in multiple locations at the same time, such as in a MainMenu and a ContextMenu, you can use the CloneMenu method to create a copy of a MenuItem for use in another location.

Popupイベントを使用すると、メニューが表示される前にタスクを実行できます。The Popup event enables you to perform tasks before a menu is displayed. たとえば、このイベントのイベントハンドラーを作成して、コードの状態に基づいてメニュー項目を表示または非表示にすることができます。For example, you can create an event handler for this event to display or hide menu items based on the state of your code. このSelectイベントを使用すると、ユーザーがメニュー項目の上にマウスポインターを置いたときに、アプリケーションのメニュー項目の詳細なヘルプを提供するなどのタスクを実行できます。The Select event enables you to perform tasks such as providing detailed help for your application's menu items when the user places the mouse pointer over a menu item.

コンストラクター

MenuItem()

空白のキャプションを使用して、MenuItem を初期化します。Initializes a MenuItem with a blank caption.

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

キャプション、MenuItemClickSelect の各イベントに対して定義されているイベント ハンドラー、メニュー項目のショートカット キー、マージの種類、およびマージ順序を指定して、Popup クラスの新しいインスタンスを初期化します。Initializes a new instance of the MenuItem class with a specified caption; defined event-handlers for the Click, Select and Popup events; a shortcut key; a merge type; and order specified for the menu item.

MenuItem(String)

メニュー項目のキャプションを指定して、MenuItem クラスの新しいインスタンスを初期化します。Initializes a new instance of the MenuItem class with a specified caption for the menu item.

MenuItem(String, EventHandler)

メニュー項目のキャプション、Click イベントを処理するイベント ハンドラーを指定して、クラスの新しいインスタンスを初期化します。Initializes a new instance of the class with a specified caption and event handler for the Click event of the menu item.

MenuItem(String, EventHandler, Shortcut)

メニュー項目のキャプション、イベント ハンドラー、関連付けられているショートカット キーを指定して、クラスの新しいインスタンスを初期化します。Initializes a new instance of the class with a specified caption, event handler, and associated shortcut key for the menu item.

MenuItem(String, MenuItem[])

メニュー項目のキャプション、メニュー項目に対して定義されているサブメニュー項目の配列を指定して、クラスの新しいインスタンスを初期化します。Initializes a new instance of the class with a specified caption and an array of submenu items defined for the menu item.

フィールド

FindHandle

FindMenuItem(Int32, IntPtr) メソッドでハンドルを検索するよう指定します。Specifies that the FindMenuItem(Int32, IntPtr) method should search for a handle.

(継承元 Menu)
FindShortcut

FindMenuItem(Int32, IntPtr) メソッドでショートカットを検索するよう指定します。Specifies that the FindMenuItem(Int32, IntPtr) method should search for a shortcut.

(継承元 Menu)

プロパティ

BarBreak

MenuItem が、新しい行 (MainMenu オブジェクトに追加されたメニュー項目の場合) または新しい列 (ContextMenu に表示されるサブメニュー項目またはメニュー項目の場合) に配置されるかどうかを示す値を取得または設定します。Gets or sets a value indicating whether the MenuItem is placed on a new line (for a menu item added to a MainMenu object) or in a new column (for a submenu item or menu item displayed in a ContextMenu).

Break

項目が、新しい行 (MainMenu オブジェクトに追加されたメニュー項目の場合) または新しい列 (ContextMenu に表示されるサブメニュー項目またはメニュー項目の場合) に配置されるかどうかを示す値を取得または設定します。Gets or sets a value indicating whether the item is placed on a new line (for a menu item added to a MainMenu object) or in a new column (for a menu item or submenu item displayed in a ContextMenu).

CanRaiseEvents

コンポーネントがイベントを発生させることがきるかどうかを示す値を取得します。Gets a value indicating whether the component can raise an event.

(継承元 Component)
Checked

メニュー項目のテキストの横にチェック マークを表示するかどうかを示す値を取得または設定します。Gets or sets a value indicating whether a check mark appears next to the text of the menu item.

Container

IContainer を格納している Component を取得します。Gets the IContainer that contains the Component.

(継承元 Component)
DefaultItem

メニュー項目が既定のメニュー項目かどうかを示す値を取得または設定します。Gets or sets a value indicating whether the menu item is the default menu item.

DesignMode

Component が現在デザイン モードかどうかを示す値を取得します。Gets a value that indicates whether the Component is currently in design mode.

(継承元 Component)
Enabled

メニュー項目が有効であるどうかを示す値を取得または設定します。Gets or sets a value indicating whether the menu item is enabled.

Events

Component に結び付けられているイベント ハンドラーのリストを取得します。Gets the list of event handlers that are attached to this Component.

(継承元 Component)
Handle

メニューのウィンドウ ハンドルを表している値を取得します。Gets a value representing the window handle for the menu.

(継承元 Menu)
Index

親メニュー内のメニュー項目の位置を示す値を取得または設定します。Gets or sets a value indicating the position of the menu item in its parent menu.

IsParent

メニュー項目に子メニュー項目が含まれているかどうかを示す値を取得します。Gets a value indicating whether the menu item contains child menu items.

MdiList

メニュー項目に、関連付けられているフォーム内に表示されるマルチ ドキュメント インターフェイス (MDI) 子ウィンドウのリストを表示するかどうかを示す値を取得または設定します。Gets or sets a value indicating whether the menu item will be populated with a list of the Multiple Document Interface (MDI) child windows that are displayed within the associated form.

MdiListItem

マルチ ドキュメント インターフェイス (MDI) 子フォームの一覧を表示するために使用される MenuItem を示す値を取得します。Gets a value indicating the MenuItem that is used to display a list of multiple document interface (MDI) child forms.

(継承元 Menu)
MenuID

メニュー項目の Windows 識別子を示す値を取得します。Gets a value indicating the Windows identifier for this menu item.

MenuItems

メニューに関連付けられている MenuItem オブジェクトのコレクションを示す値を取得します。Gets a value indicating the collection of MenuItem objects associated with the menu.

(継承元 Menu)
MergeOrder

メニュー項目が別のメニューにマージされた場合に、そのメニュー項目がマージ後のメニューで占める位置を相対的に示す値を取得または設定します。Gets or sets a value indicating the relative position of the menu item when it is merged with another.

MergeType

メニュー項目が別のメニューにマージされた場合に、そのメニュー項目がどのように動作するかを示す値を取得または設定します。Gets or sets a value indicating the behavior of this menu item when its menu is merged with another.

Mnemonic

メニュー項目に関連付けられているニーモニック文字を示す値を取得します。Gets a value indicating the mnemonic character that is associated with this menu item.

Name

Menu の名前を取得または設定します。Gets or sets the name of the Menu.

(継承元 Menu)
OwnerDraw

指定したコードがメニュー項目を描画するのか、Windows がメニュー項目を描画するのかを示す値を取得または設定します。Gets or sets a value indicating whether the code that you provide draws the menu item or Windows draws the menu item.

Parent

このメニュー項目が含まれているメニューを示す値を取得します。Gets a value indicating the menu that contains this menu item.

RadioCheck

MenuItem がチェックされている場合、チェック マークの代わりにオプション ボタンを表示するかどうかを示す値を取得または設定します。Gets or sets a value indicating whether the MenuItem, if checked, displays a radio-button instead of a check mark.

Shortcut

メニュー項目に関連付けられているショートカット キーを示す値を取得または設定します。Gets or sets a value indicating the shortcut key associated with the menu item.

ShowShortcut

メニュー項目のキャプションの横に、そのメニュー項目に関連付けられているショートカット キーを表示するかどうかを示す値を取得または設定します。Gets or sets a value indicating whether the shortcut key that is associated with the menu item is displayed next to the menu item caption.

Site

ComponentISite を取得または設定します。Gets or sets the ISite of the Component.

(継承元 Component)
Tag

コントロールに関連付けられたユーザー定義のデータを取得または設定します。Gets or sets user-defined data associated with the control.

(継承元 Menu)
Text

メニュー項目のキャプションを示す値を取得または設定します。Gets or sets a value indicating the caption of the menu item.

Visible

メニュー項目を表示するかどうかを示す値を取得または設定します。Gets or sets a value indicating whether the menu item is visible.

メソッド

CloneMenu()

現在の MenuItem のコピーを作成します。Creates a copy of the current MenuItem.

CloneMenu(Menu)

現在の Menu にパラメーターとして渡された Menu をコピーします。Copies the Menu that is passed as a parameter to the current Menu.

(継承元 Menu)
CloneMenu(MenuItem)

指定した MenuItem のコピーを作成します。Creates a copy of the specified MenuItem.

CreateMenuHandle()

Menu への新しいハンドルを作成します。Creates a new handle to the Menu.

(継承元 Menu)
CreateObjRef(Type)

リモート オブジェクトとの通信に使用するプロキシの生成に必要な情報をすべて格納しているオブジェクトを作成します。Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(継承元 MarshalByRefObject)
Dispose()

Component によって使用されているすべてのリソースを解放します。Releases all resources used by the Component.

(継承元 Component)
Dispose(Boolean)

MenuItem で使用されていたリソース (メモリを除く) を解放します。Disposes of the resources (other than memory) used by the MenuItem.

Equals(Object)

指定したオブジェクトが、現在のオブジェクトと等しいかどうかを判断します。Determines whether the specified object is equal to the current object.

(継承元 Object)
FindMenuItem(Int32, IntPtr)

指定した値を含む MenuItem を取得します。Gets the MenuItem that contains the value specified.

(継承元 Menu)
FindMergePosition(Int32)

メニューにおけるメニュー項目の追加位置を返します。Returns the position at which a menu item should be inserted into the menu.

(継承元 Menu)
GetContextMenu()

メニューを格納している ContextMenu を取得します。Gets the ContextMenu that contains this menu.

(継承元 Menu)
GetHashCode()

既定のハッシュ関数として機能します。Serves as the default hash function.

(継承元 Object)
GetLifetimeService()

対象のインスタンスの有効期間ポリシーを制御する、現在の有効期間サービス オブジェクトを取得します。Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(継承元 MarshalByRefObject)
GetMainMenu()

メニューを格納している MainMenu を取得します。Gets the MainMenu that contains this menu.

(継承元 Menu)
GetService(Type)

Component またはその Container で提供されるサービスを表すオブジェクトを返します。Returns an object that represents a service provided by the Component or by its Container.

(継承元 Component)
GetType()

現在のインスタンスの Type を取得します。Gets the Type of the current instance.

(継承元 Object)
InitializeLifetimeService()

このインスタンスの有効期間ポリシーを制御する有効期間サービス オブジェクトを取得します。Obtains a lifetime service object to control the lifetime policy for this instance.

(継承元 MarshalByRefObject)
MemberwiseClone()

現在の Object の簡易コピーを作成します。Creates a shallow copy of the current Object.

(継承元 Object)
MemberwiseClone(Boolean)

現在の MarshalByRefObject オブジェクトの簡易コピーを作成します。Creates a shallow copy of the current MarshalByRefObject object.

(継承元 MarshalByRefObject)
MergeMenu()

この MenuItem と別の MenuItem をマージし、マージ後に作成された MenuItem を返します。Merges this MenuItem with another MenuItem and returns the resulting merged MenuItem.

MergeMenu(Menu)

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

(継承元 Menu)
MergeMenu(MenuItem)

別のメニュー項目とこのメニュー項目をマージします。Merges another menu item with this menu item.

OnClick(EventArgs)

Click イベントを発生させます。Raises the Click event.

OnDrawItem(DrawItemEventArgs)

DrawItem イベントを発生させます。Raises the DrawItem event.

OnInitMenuPopup(EventArgs)

Popup イベントを発生させます。Raises the Popup event.

OnMeasureItem(MeasureItemEventArgs)

MeasureItem イベントを発生させます。Raises the MeasureItem event.

OnPopup(EventArgs)

Popup イベントを発生させます。Raises the Popup event.

OnSelect(EventArgs)

Select イベントを発生させます。Raises the Select event.

PerformClick()

ClickMenuItem イベントを生成し、ユーザーによるクリック操作をシミュレートします。Generates a Click event for the MenuItem, simulating a click by a user.

PerformSelect()

このメニュー項目に Select イベントを発生させます。Raises the Select event for this menu item.

ProcessCmdKey(Message, Keys)

コマンド キーを処理します。Processes a command key.

(継承元 Menu)
ToString()

MenuItem を表す文字列を返します。Returns a string that represents the MenuItem.

イベント

Click

メニュー項目に対して定義されているショートカット キーまたはアクセス キーを使用して、そのメニュー項目がクリックまたは選択されると発生します。Occurs when the menu item is clicked or selected using a shortcut key or access key defined for the menu item.

Disposed

Dispose() メソッドの呼び出しによってコンポーネントが破棄されると発生します。Occurs when the component is disposed by a call to the Dispose() method.

(継承元 Component)
DrawItem

メニュー項目の OwnerDraw プロパティが true に設定されていて、そのメニュー項目の描画が要求された場合に発生します。Occurs when the OwnerDraw property of a menu item is set to true and a request is made to draw the menu item.

MeasureItem

メニューにメニュー項目を描画する前に、そのメニュー項目のサイズを確認する必要がある場合に発生します。Occurs when the menu needs to know the size of a menu item before drawing it.

Popup

メニュー項目のリストが表示される前に発生します。Occurs before a menu item's list of menu items is displayed.

Select

ユーザーがメニュー項目の上にポインターを置いた場合に発生します。Occurs when the user places the pointer over a menu item.

適用対象

こちらもご覧ください