Menu.MenuItemCollection.Add 메서드

정의

네임스페이스:: System.Windows.Forms

어셈블리:: System.Windows.Forms.dll

중요

일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.

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

오버로드

Name	Description
Add(String)	지정된 캡션을 사용하여 현재 메뉴의 끝에 새 MenuItem값을 추가합니다.
Add(MenuItem)	이전에 만든 MenuItem 메뉴를 현재 메뉴의 끝에 추가합니다.
Add(Int32, MenuItem)	메뉴 항목 컬렉션 내의 지정된 인덱스에서 이전에 만든 MenuItem 항목을 추가합니다.
Add(String, EventHandler)	지정된 캡션과 이벤트에 대해 Click 지정된 이벤트 처리기를 사용하여 현재 메뉴의 끝에 새 MenuItem 값을 추가합니다.
Add(String, MenuItem[])	지정된 캡션, Click 이벤트 처리기 및 항목을 사용하여 이 메뉴의 끝에 새 MenuItem 항목을 추가합니다.

Source:: Menu.MenuItemCollection.cs

Source:: Menu.MenuItemCollection.cs

지정된 캡션을 사용하여 현재 메뉴의 끝에 새 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 컬렉션에 추가되는 메뉴 항목을 나타내는 A입니다.

예제

다음 코드 예제에서는 파생 클래스를 사용하여 컬렉션에 두 개의 MenuItem 개체가 추가 MenuItems 된 MainMenu 주 메뉴를 mainMenu1만듭니다. 그런 다음 코드는 .의 속성에 Menu Form할당됩니다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

설명

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

추가 정보

Remove(MenuItem)

적용 대상

Source:: Menu.MenuItemCollection.cs

Source:: Menu.MenuItemCollection.cs

이전에 만든 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의 인스턴스를 만들고 개체 컬렉션 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

설명

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

추가 정보

Remove(MenuItem)

적용 대상

Source:: Menu.MenuItemCollection.cs

Source:: Menu.MenuItemCollection.cs

메뉴 항목 컬렉션 내의 지정된 인덱스에서 이전에 만든 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의 인스턴스를 만들고 메뉴 항목 컬렉션의 특정 위치에 있는 개체 컬렉션 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

설명

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

추가 정보

Remove(MenuItem)

적용 대상

Source:: Menu.MenuItemCollection.cs

Source:: Menu.MenuItemCollection.cs

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

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 컬렉션에 추가되는 메뉴 항목을 나타내는 A입니다.

예제

다음 코드 예제에서는 파생 클래스를 사용하여 컬렉션에 두 개의 MenuItem 개체가 추가 MenuItems 된 MainMenu 주 메뉴를 mainMenu1만듭니다. 코드는 이 버전의 메서드를 Add 사용하여 컬렉션에 추가된 두 번째 메뉴 항목의 이벤트에 대한 Click 이벤트 처리기를 정의합니다. 그런 다음 코드는 .의 속성에 Menu Form할당됩니다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

설명

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

메모

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

추가 정보

Remove(MenuItem)

적용 대상

Source:: Menu.MenuItemCollection.cs

Source:: Menu.MenuItemCollection.cs

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

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 컬렉션에 추가되는 메뉴 항목을 나타내는 A입니다.

설명

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

메모

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

추가 정보

Remove(MenuItem)

적용 대상

피드백

이 페이지가 도움이 되었나요?

다음을 통해 공유

Menu.MenuItemCollection.Add 메서드

정의

오버로드

Add(String)

매개 변수

반품

예제

설명

추가 정보

적용 대상

Add(MenuItem)

매개 변수

반품

예제

설명

추가 정보

적용 대상

Add(Int32, MenuItem)

매개 변수

반품

예외

예제

설명

추가 정보

적용 대상

Add(String, EventHandler)

매개 변수

반품

예제

설명

추가 정보

적용 대상

Add(String, MenuItem[])

매개 변수

반품

설명

추가 정보

적용 대상

피드백