MenuItem 클래스

정의

네임스페이스:

System.Windows.Forms

어셈블리:

System.Windows.Forms.dll

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 최상위 메뉴 항목을 나타내는 글꼴 크기를 선택 하는 것에 대 한 하위 메뉴 항목을 추가 하 고 다음 애플리케이션에서 크고 작은 글꼴 선택 옵션을 나타내는 해당 메뉴 항목에 두 개의 하위 메뉴 항목을 추가 합니다. 예제에는 필요는 MainMenu 개체인 mainMenu1 및 4 MenuItem 명명 된 개체 menuItem1, menuItem2, menuItem3, 및 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

설명

이 클래스는 .NET Core 3.1 이상 버전에서는 사용할 수 없습니다. 대신 ToolStripMenuItem를 사용하세요.

되려면에서를 MenuItem 표시할 추가 해야 하는 MainMenu 또는 ContextMenu합니다. 하위 메뉴를 만들려면 추가할 수 있습니다 MenuItem 개체를 MenuItems 부모 MenuItem합니다.

MenuItem 클래스 모양 및 메뉴 항목의 기능을 구성할 수 있는 속성을 제공 합니다. 메뉴 항목 옆의 확인란을 표시 하려면 사용 된 Checked 속성입니다. 상호 배타적인 메뉴 항목의 목록에서 선택한 메뉴 항목을 식별 하려면이 기능을 사용할 수 있습니다. 예를 들어, 텍스트의 색을 설정 하는 것에 대 한 메뉴 항목 집합이 있는 경우는 TextBox 컨트롤을 사용할 수는 Checked 현재 선택 된 색을 식별 하는 속성입니다. Shortcut 속성 메뉴 항목을 선택 하기 위해 누르는 될 수 있는 키보드 조합을 정의를 사용할 수 있습니다.

에 대 한 MenuItem 인터페이스 MDI (다중 문서) 애플리케이션에서 표시 되는 개체를 사용할 수는 MergeMenu MDI 메뉴 병합 방법 통합된 메뉴 구조를 만들려면 해당 자식 폼의 지 문으로 대 한 부모입니다. 때문에 MenuItem 다시 사용할 수 없는 여러 위치에서 동시에 같은를 MainMenu 및 ContextMenu, 사용할 수 있습니다를 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)	한 메뉴의 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	메뉴 항목 위에 포인터를 놓으면 발생합니다.

추가 정보

• MainMenu
• Menu
• MenuMerge
• ContextMenu