MenuItem クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
MainMenu または ContextMenu 内に表示される個別の項目を表します。
このクラスは .NET Core 3.1 以降のバージョンでは利用できません。 代わりに を使用 ToolStripMenuItem します。これはコントロールを MenuItem 置き換えます。
public ref class MenuItem : System::Windows::Forms::Menupublic class MenuItem : System.Windows.Forms.Menutype MenuItem = class
inherit MenuPublic 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[]) |
キャプション、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() | |
| 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() | |
| PerformSelect() |
このメニュー項目に Select イベントを発生させます。 |
| ProcessCmdKey(Message, Keys) |
コマンド キーを処理します。 (継承元 Menu) |
| ToString() |
MenuItem を表す文字列を返します。 |
events
| Click |
メニュー項目に対して定義されているショートカット キーまたはアクセス キーを使用して、そのメニュー項目がクリックまたは選択されると発生します。 |
| Disposed |
Dispose() メソッドの呼び出しによってコンポーネントが破棄されるときに発生します。 (継承元 Component) |
| DrawItem |
メニュー項目の OwnerDraw プロパティが |
| MeasureItem |
メニューにメニュー項目を描画する前に、そのメニュー項目のサイズを確認する必要がある場合に発生します。 |
| Popup |
メニュー項目のリストが表示される前に発生します。 |
| Select |
ユーザーがメニュー項目の上にポインターを置いた場合に発生します。 |