다음을 통해 공유


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 최상위 메뉴 항목을 나타내는 글꼴 크기를 선택 하는 것에 대 한 하위 메뉴 항목을 추가 하 고 다음 애플리케이션에서 크고 작은 글꼴 선택 옵션을 나타내는 해당 메뉴 항목에 두 개의 하위 메뉴 항목을 추가 합니다. 예제에는 필요는 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 다시 사용할 수 없는 여러 위치에서 동시에 같은를 MainMenuContextMenu, 사용할 수 있습니다를 CloneMenu 의 복사본을 만드는 메서드를 MenuItem 다른 위치에서 사용 합니다.

Popup 이벤트를 사용 하는 메뉴가 표시 되기 전에 작업을 수행할 수 있습니다. 예를 들어이 이벤트는 상태 코드에 따라 메뉴 항목 표시 / 숨기기에 대 한 이벤트 처리기를 만들 수 있습니다. Select 이벤트를 사용 하면 메뉴 항목 위로 마우스 포인터를 이동할 때 애플리케이션의 메뉴 항목에 대 한 자세한 도움말을 제공 하는 등의 작업을 수행할 수 있습니다.

생성자

MenuItem()

캡션이 비어 있는 MenuItem을 초기화합니다.

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

메뉴 항목의 지정된 캡션, MenuItem, ClickSelect 이벤트에 대해 지정된 이벤트 처리기, 바로 가기 키, 병합 유형 및 지정된 순서를 사용하여 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)

한 메뉴의 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를 나타내는 문자열을 반환합니다.

이벤트

Click

메뉴 항목에 대해 정의된 바로 가기 키 또는 선택키를 사용하여 메뉴 항목을 클릭하거나 선택할 때 발생합니다.

Disposed

Dispose() 메서드를 호출하여 구성 요소를 삭제할 때 발생합니다.

(다음에서 상속됨 Component)
DrawItem

메뉴 항목의 OwnerDraw 속성이 true로 설정된 경우 메뉴 항목을 그리도록 요청할 때 발생합니다.

MeasureItem

메뉴 항목을 그리기 전에 메뉴에서 해당 메뉴 항목의 크기를 알아야 할 때 발생합니다.

Popup

메뉴 항목의 메뉴 항목 목록이 표시되기 전에 발생합니다.

Select

메뉴 항목 위에 포인터를 놓으면 발생합니다.

적용 대상

추가 정보