다음을 통해 공유

Menu.MenuItemCollection.Add 메서드

  • 참조

정의

네임스페이스:
System.Windows.Forms
어셈블리:
System.Windows.Forms.dll

컬렉션에 새 MenuItem를 추가합니다.

오버로드

Add(String)

지정된 캡션을 사용하여 새 MenuItem을 현재 메뉴의 끝에 추가합니다.
Add(MenuItem)

이전에 만든 MenuItem을 현재 메뉴의 끝에 추가합니다.
Add(Int32, MenuItem)

이전에 만든 MenuItem을 메뉴 항목 컬렉션 내의 지정된 인덱스에 추가합니다.
Add(String, EventHandler)

지정된 캡션 및 MenuItem 이벤트에 대한 이벤트 처리기를 사용하여 새 Click을 현재 메뉴의 끝에 추가합니다.
Add(String, MenuItem[])

지정된 캡션, MenuItem 이벤트 처리기 및 항목을 갖는 새 Click을 이 메뉴의 끝에 추가합니다.

Add(String)

지정된 캡션을 사용하여 새 MenuItem을 현재 메뉴의 끝에 추가합니다.

public:
 virtual System::Windows::Forms::MenuItem ^ Add(System::String ^ caption);
public virtual System.Windows.Forms.MenuItem Add (string caption);
abstract member Add : string -> System.Windows.Forms.MenuItem
override this.Add : string -> System.Windows.Forms.MenuItem
Public Overridable Function Add (caption As String) As MenuItem

매개 변수

caption
String

메뉴 항목의 캡션입니다.

반환

MenuItem

컬렉션에 추가되는 메뉴 항목을 나타내는 MenuItem입니다.

예제

다음 코드 예제에서는 파생 클래스를 사용하여 컬렉션에 두 개의 MenuItem 개체가 추가 MenuItems 된 MainMenu 기본 메뉴를 mainMenu1만듭니다. 그런 다음 코드는 의 Form속성에 Menu 를 할당합니다mainMenu1. 이 예제에서는 이 예제에 정의된 코드가 양식에서 와 함께 있어야 합니다.

private:
   void InitializeMyMainMenu()
   {
      // Create the MainMenu.
      MainMenu^ mainMenu1 = gcnew MainMenu;
      
      /* Use the MenuItems property to call the Add method
         to add two new MenuItem objects to the MainMenu. */
      mainMenu1->MenuItems->Add( "&File" );
      mainMenu1->MenuItems->Add( "&Edit" );
      
      // Assign mainMenu1 to the form.
      this->Menu = mainMenu1;
   }

private void InitializeMyMainMenu()
{
   // Create the MainMenu.
   MainMenu mainMenu1 = new MainMenu();
   
   /* Use the MenuItems property to call the Add method
      to add two new MenuItem objects to the MainMenu. */
   mainMenu1.MenuItems.Add ("&File");
   mainMenu1.MenuItems.Add ("&Edit");

   // Assign mainMenu1 to the form.
   this.Menu = mainMenu1;
}

Private Sub InitializeMyMainMenu()
    ' Create the MainMenu.
    Dim mainMenu1 As New MainMenu()
       
    ' Use the MenuItems property to call the Add method
    ' to add two new MenuItem objects to the MainMenu. 
    mainMenu1.MenuItems.Add("&File")
    mainMenu1.MenuItems.Add("&Edit")
       
    ' Assign mainMenu1 to the form.
    Me.Menu = mainMenu1
End Sub

설명

은 MenuItem 한 번에 하나의 메뉴에만 포함될 수 있으며 동일한 메뉴에 두 번 이상 추가할 수 없습니다. 둘 이상의 메뉴에서 를 MenuItem 다시 사용하려면 클래스의 CloneMenu 메서드를 MenuItem 사용합니다. 이전에 추가한 를 MenuItem 제거하려면 메서드를 Remove 사용합니다.

추가 정보

적용 대상

Add(MenuItem)

이전에 만든 MenuItem을 현재 메뉴의 끝에 추가합니다.

public:
 virtual int Add(System::Windows::Forms::MenuItem ^ item);
public virtual int Add (System.Windows.Forms.MenuItem item);
abstract member Add : System.Windows.Forms.MenuItem -> int
override this.Add : System.Windows.Forms.MenuItem -> int
Public Overridable Function Add (item As MenuItem) As Integer

매개 변수

item
MenuItem

추가할 MenuItem입니다.

반환

Int32

항목이 컬렉션에 저장되는 인덱스(0부터 시작)입니다.

예제

다음 코드 예제에서는 파생 클래스MainMenu의 instance 만들고 개체의 MenuItem 컬렉션에 를 추가합니다MenuItem. 이 예제에서는 이 예제에 정의된 메서드가 폼의 클래스 내에 있고 해당 양식 클래스의 메서드에서 호출되어야 합니다.

private:
   void InitializeMyMainMenu()
   {
      // Create the MainMenu and the MenuItem to add.
      MainMenu^ mainMenu1 = gcnew MainMenu;
      MenuItem^ menuItem1 = gcnew MenuItem( "&File" );
      
      /* Use the MenuItems property to call the Add method
         to add the MenuItem to the MainMenu menu item collection. */
      mainMenu1->MenuItems->Add( menuItem1 );
      
      // Assign mainMenu1 to the form.
      this->Menu = mainMenu1;
   }

private void InitializeMyMainMenu()
{
   // Create the MainMenu and the MenuItem to add.
   MainMenu mainMenu1 = new MainMenu();
   MenuItem menuItem1 = new MenuItem("&File");
   
   /* Use the MenuItems property to call the Add method
      to add the MenuItem to the MainMenu menu item collection. */
   mainMenu1.MenuItems.Add (menuItem1);

   // Assign mainMenu1 to the form.
   this.Menu = mainMenu1;
}

Private Sub InitializeMyMainMenu()
    ' Create the MainMenu and the MenuItem to add.
    Dim mainMenu1 As New MainMenu()
    Dim menuItem1 As New MenuItem("&File")
       
    ' Use the MenuItems property to call the Add method
    ' to add the MenuItem to the MainMenu menu item collection. 
    mainMenu1.MenuItems.Add(menuItem1)
       
    ' Assign mainMenu1 to the form.
    Me.Menu = mainMenu1
End Sub

설명

은 MenuItem 한 번에 하나의 메뉴에만 포함될 수 있으며 동일한 메뉴에 두 번 이상 추가할 수 없습니다. 둘 이상의 메뉴에서 를 MenuItem 다시 사용하려면 클래스의 CloneMenu 메서드를 MenuItem 사용합니다. 이전에 추가한 를 MenuItem 제거하려면 메서드를 Remove 사용합니다.

이 버전의 Add 메서드를 사용하면 이전에 만든 MenuItem 개체를 메뉴 항목 컬렉션의 끝에 추가할 수 있습니다.

추가 정보

적용 대상

Add(Int32, MenuItem)

이전에 만든 MenuItem을 메뉴 항목 컬렉션 내의 지정된 인덱스에 추가합니다.

public:
 virtual int Add(int index, System::Windows::Forms::MenuItem ^ item);
public virtual int Add (int index, System.Windows.Forms.MenuItem item);
abstract member Add : int * System.Windows.Forms.MenuItem -> int
override this.Add : int * System.Windows.Forms.MenuItem -> int
Public Overridable Function Add (index As Integer, item As MenuItem) As Integer

매개 변수

index
Int32

새 항목을 추가할 위치입니다.

item
MenuItem

추가할 MenuItem입니다.

반환

Int32

항목이 컬렉션에 저장되는 인덱스(0부터 시작)입니다.

예외

Exception

추가 중인 MenuItem이 이미 사용되고 있는 경우

ArgumentException

index 매개 변수에 제공된 인덱스가 컬렉션의 크기보다 큰 경우

예제

다음 코드 예제에서는 파생 클래스MainMenu의 instance 만들고 메뉴 항목 컬렉션의 특정 위치에 있는 개체의 MenuItem 컬렉션에 개체를 추가합니다MenuItem. 이 예제에서는 이 예제에 정의된 메서드가 폼의 클래스 내에 있고 해당 양식 클래스의 메서드에서 호출되어야 합니다.

private:
   void InitializeMyMainMenu()
   {
      // Create the MainMenu and the MenuItem to add.
      MainMenu^ mainMenu1 = gcnew MainMenu;
      MenuItem^ menuItem1 = gcnew MenuItem( "&File" );
      
      /* Use the MenuItems property to call the Add method
         to add the MenuItem to mainMenu1 at specific index. */
      mainMenu1->MenuItems->Add( 0, menuItem1 );
      
      // Assign mainMenu1 to the form.
      this->Menu = mainMenu1;
   }

private void InitializeMyMainMenu()
{
   // Create the MainMenu and the MenuItem to add.
   MainMenu mainMenu1 = new MainMenu();
   MenuItem menuItem1 = new MenuItem("&File");
   
   /* Use the MenuItems property to call the Add method
      to add the MenuItem to mainMenu1 at specific index. */
   mainMenu1.MenuItems.Add (0, menuItem1);

   // Assign mainMenu1 to the form.
   this.Menu = mainMenu1;
}

Private Sub InitializeMyMainMenu()
    ' Create the MainMenu and the MenuItem to add.
    Dim mainMenu1 As New MainMenu()
    Dim menuItem1 As New MenuItem("&File")
       
    ' Use the MenuItems property to call the Add method
    ' to add the MenuItem to mainMenu1 at specific index. 
    mainMenu1.MenuItems.Add(0, menuItem1)
       
    ' Assign mainMenu1 to the form.
    Me.Menu = mainMenu1
End Sub

설명

은 MenuItem 한 번에 하나의 메뉴에만 포함될 수 있으며 동일한 메뉴에 두 번 이상 추가할 수 없습니다. 둘 이상의 메뉴에서 를 MenuItem 다시 사용하려면 클래스의 CloneMenu 메서드를 MenuItem 사용합니다. 이전에 추가한 를 MenuItem 제거하려면 메서드를 Remove 사용합니다.

이 버전의 Add 메서드를 사용하면 이전에 만든 MenuItem 개체를 컬렉션 내의 특정 인덱스 위치에 추가할 수 있습니다. MenuItem 현재 해당 인덱스 및 해당 인덱스 뒤의 모든 MenuItem 개체는 컬렉션에서 다음으로 가장 낮은 인덱스로 이동됩니다.

추가 정보

적용 대상

Add(String, EventHandler)

지정된 캡션 및 MenuItem 이벤트에 대한 이벤트 처리기를 사용하여 새 Click을 현재 메뉴의 끝에 추가합니다.

public:
 virtual System::Windows::Forms::MenuItem ^ Add(System::String ^ caption, EventHandler ^ onClick);
public virtual System.Windows.Forms.MenuItem Add (string caption, EventHandler onClick);
abstract member Add : string * EventHandler -> System.Windows.Forms.MenuItem
override this.Add : string * EventHandler -> System.Windows.Forms.MenuItem
Public Overridable Function Add (caption As String, onClick As EventHandler) As MenuItem

매개 변수

caption
String

메뉴 항목의 캡션입니다.

onClick
EventHandler

사용자가 항목을 클릭하거나 해당 메뉴 항목의 액셀러레이터 키 또는 바로 가기 키를 누를 때 호출되는 이벤트 처리기를 나타내는 EventHandler입니다.

반환

MenuItem

컬렉션에 추가되는 메뉴 항목을 나타내는 MenuItem입니다.

예제

다음 코드 예제에서는 파생 클래스를 사용하여 컬렉션에 두 개의 MenuItem 개체가 추가 MenuItems 된 MainMenu 기본 메뉴를 mainMenu1만듭니다. 코드는 이 버전의 메서드를 Add 사용하여 컬렉션에 추가된 두 번째 메뉴 항목의 이벤트에 대한 Click 이벤트 처리기를 정의합니다. 그런 다음 코드는 의 Form속성에 Menu 를 할당합니다mainMenu1. 이 예제에서는 이 예제에 정의된 코드가 양식 내에 있어야 합니다.

private:
   void InitializeMyMainMenu()
   {
      // Create the MainMenu.
      MainMenu^ mainMenu1 = gcnew MainMenu;
      
      /* Use the MenuItems property to call the Add method
         to add two new MenuItem objects to the MainMenu. */
      mainMenu1->MenuItems->Add( "&File" );
      mainMenu1->MenuItems->Add( "&Edit", gcnew EventHandler(
         this, &Form1::menuItem2_Click ) );
      
      // Assign mainMenu1 to the form.
      this->Menu = mainMenu1;
   }

private:
   void menuItem2_Click( System::Object^ sender, System::EventArgs^ e )
   {
      // Insert code to handle Click event.
   }

private void InitializeMyMainMenu()
{
   // Create the MainMenu.
   MainMenu mainMenu1 = new MainMenu();
   
   /* Use the MenuItems property to call the Add method
      to add two new MenuItem objects to the MainMenu. */
   mainMenu1.MenuItems.Add ("&File");
   mainMenu1.MenuItems.Add ("&Edit", new EventHandler (menuItem2_Click));

   // Assign mainMenu1 to the form.
   this.Menu = mainMenu1;
}

private void menuItem2_Click(System.Object sender, System.EventArgs e)
{
   // Insert code to handle Click event.
}

Private Sub InitializeMyMainMenu()
    ' Create the MainMenu.
    Dim mainMenu1 As New MainMenu()
       
    ' Use the MenuItems property to call the Add method
    ' to add two new MenuItem objects to the MainMenu. 
    mainMenu1.MenuItems.Add("&File")
    mainMenu1.MenuItems.Add("&Edit", _
       New EventHandler(AddressOf menuItem2_Click))
       
    ' Assign mainMenu1 to the form.
    Me.Menu = mainMenu1
End Sub    
   
Private Sub menuItem2_Click(sender As System.Object, e As System.EventArgs)
    ' Insert code to handle Click event.
End Sub

설명

은 MenuItem 한 번에 하나의 메뉴에만 포함될 수 있으며 동일한 메뉴에 두 번 이상 추가할 수 없습니다. 둘 이상의 메뉴에서 를 MenuItem 다시 사용하려면 클래스의 CloneMenu 메서드를 MenuItem 사용합니다. 이전에 추가한 를 MenuItem 제거하려면 메서드를 Remove 사용합니다.

이 버전의 Add 메서드를 사용하면 메뉴 항목에 대한 캡션 지정하고 이벤트를 처리 Click 할 대리자를 지정할 수 있습니다. 이 버전을 사용할 수 있습니다는 Add 애플리케이션을 이미 처리 하는 이벤트 처리기에 있는 경우 메서드는 Click 이벤트입니다.

참고

Click 하위 메뉴 항목이 포함된 에 대해 MenuItem 이벤트가 발생하지 않습니다.

추가 정보

적용 대상

Add(String, MenuItem[])

지정된 캡션, MenuItem 이벤트 처리기 및 항목을 갖는 새 Click을 이 메뉴의 끝에 추가합니다.

public:
 virtual System::Windows::Forms::MenuItem ^ Add(System::String ^ caption, cli::array <System::Windows::Forms::MenuItem ^> ^ items);
public virtual System.Windows.Forms.MenuItem Add (string caption, System.Windows.Forms.MenuItem[] items);
abstract member Add : string * System.Windows.Forms.MenuItem[] -> System.Windows.Forms.MenuItem
override this.Add : string * System.Windows.Forms.MenuItem[] -> System.Windows.Forms.MenuItem
Public Overridable Function Add (caption As String, items As MenuItem()) As MenuItem

매개 변수

caption
String

메뉴 항목의 캡션입니다.

items
MenuItem[]

이 MenuItem에 포함될 MenuItem 개체의 배열입니다.

반환

MenuItem

컬렉션에 추가되는 메뉴 항목을 나타내는 MenuItem입니다.

설명

은 MenuItem 한 번에 하나의 메뉴에만 포함될 수 있으며 동일한 메뉴에 두 번 이상 추가할 수 없습니다. 둘 이상의 메뉴에서 를 MenuItem 다시 사용하려면 클래스의 CloneMenu 메서드를 MenuItem 사용합니다. 이전에 추가한 를 MenuItem 제거하려면 메서드를 Remove 사용합니다.

이 버전의 Add 메서드를 사용하면 메뉴 항목에 대한 캡션 및 해당 Click 이벤트를 처리할 대리자를 지정할 수 있습니다. 이 버전을 사용할 수 있습니다는 Add 애플리케이션을 이미 처리 하는 이벤트 처리기에 있는 경우 메서드는 Click 이벤트입니다. 이 버전의 메서드를 사용하면 컬렉션에 추가하려는 이전에 만든 MenuItem 개체의 배열을 지정할 수도 있습니다. 이 기능을 사용하여 메서드를 사용하여 CloneMenu 복제된 기존 MenuItem 개체를 다시 사용할 수 있습니다. 매개 변수가 items 비어 null있지 않거나 이 MenuItem 면 컬렉션에 추가되는 에 하위 메뉴 항목이 포함됩니다.

참고

Click 하위 메뉴 항목이 포함된 에 대해 MenuItem 이벤트가 발생하지 않습니다.

추가 정보

적용 대상