Menu.MenuItemCollection.Add Yöntem
Tanım
Önemli
Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.
Koleksiyona yeni MenuItem bir ekler.
Aşırı Yüklemeler
Add(String) |
Geçerli menünün sonuna belirtilen başlık MenuItemyeni bir ekler. |
Add(MenuItem) |
Geçerli menünün sonuna önceden oluşturulmuş MenuItem bir ekler. |
Add(Int32, MenuItem) |
Menü öğesi koleksiyonu içinde belirtilen dizinde daha önce oluşturulmuş MenuItem bir ekler. |
Add(String, EventHandler) |
Geçerli menünün sonuna belirtilen başlık ve olay için belirtilen olay işleyicisiyle Click yeni MenuItem bir ekler. |
Add(String, MenuItem[]) |
Belirtilen başlık, Click olay işleyicisi ve öğelerle bu menünün sonuna yeni MenuItem bir ekler. |
Add(String)
Geçerli menünün sonuna belirtilen başlık MenuItemyeni bir ekler.
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
Parametreler
- caption
- String
Menü öğesinin başlık.
Döndürülenler
MenuItem Koleksiyona eklenen menü öğesini temsil eden bir.
Örnekler
Aşağıdaki kod örneği, mainMenu1
türetilmiş sınıfını MainMenu kullanarak koleksiyonuna iki MenuItem nesne eklenmiş MenuItems olan bir ana menü oluşturur. Kod daha sonra özelliğini Formatar mainMenu1
Menu. Bu örnekte tanımlanan kodun formda bulunması gerekir.
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çıklamalar
bir MenuItem kerede yalnızca bir menüde bulunabilir ve aynı menüye birden çok kez eklenemez. Birden fazla menüde yeniden MenuItem kullanmak için sınıfının yöntemini MenuItem kullanınCloneMenu. Daha önce eklediğiniz bir MenuItem öğesini kaldırmak için yöntemini kullanın Remove .
Ayrıca bkz.
Şunlara uygulanır
Add(MenuItem)
Geçerli menünün sonuna önceden oluşturulmuş MenuItem bir ekler.
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
Parametreler
Döndürülenler
Öğenin koleksiyonda depolandığı sıfır tabanlı dizin.
Örnekler
Aşağıdaki kod örneği, MainMenutüretilmiş sınıfının bir örneğini oluşturur ve nesne koleksiyonuna MenuItem bir MenuItem ekler. Bu örnek, bu örnekte tanımlanan yöntemin bir formun sınıfında yer alıp bu form sınıfındaki bir yöntem tarafından çağrılır.
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
Açıklamalar
bir MenuItem kerede yalnızca bir menüde bulunabilir ve aynı menüye birden çok kez eklenemez. Birden fazla menüde yeniden MenuItem kullanmak için sınıfının yöntemini MenuItem kullanınCloneMenu. Daha önce eklediğiniz bir MenuItem öğesini kaldırmak için yöntemini kullanın Remove .
Yöntemin Add bu sürümü, menü öğesi koleksiyonunun sonuna önceden oluşturulmuş MenuItem nesneler eklemenize olanak tanır.
Ayrıca bkz.
Şunlara uygulanır
Add(Int32, MenuItem)
Menü öğesi koleksiyonu içinde belirtilen dizinde daha önce oluşturulmuş MenuItem bir ekler.
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
Parametreler
- index
- Int32
Yeni öğenin ekleneceği konum.
Döndürülenler
Öğenin koleksiyonda depolandığı sıfır tabanlı dizin.
Özel durumlar
parametresinde index
sağlanan dizin koleksiyonun boyutundan daha büyük.
Örnekler
Aşağıdaki kod örneği türetilmiş MainMenusınıfının bir örneğini oluşturur ve menü öğesi koleksiyonunda belirli bir konumdaki nesne koleksiyonuna MenuItem bir MenuItem nesnesi ekler. Bu örnek, bu örnekte tanımlanan yöntemin bir formun sınıfında yer alıp bu form sınıfındaki bir yöntem tarafından çağrılır.
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
Açıklamalar
bir MenuItem kerede yalnızca bir menüde bulunabilir ve aynı menüye birden çok kez eklenemez. Birden fazla menüde yeniden MenuItem kullanmak için sınıfının yöntemini MenuItem kullanınCloneMenu. Daha önce eklediğiniz bir MenuItem öğesini kaldırmak için yöntemini kullanın Remove .
Yönteminin Add bu sürümü, daha önce oluşturulmuş MenuItem nesneleri koleksiyon içindeki belirli bir dizin konumuna eklemenize olanak tanır. Şu anda bu dizinde bulunan tüm MenuItem nesneler ve bu dizinden sonraki tüm MenuItem nesneler koleksiyondaki bir sonraki en düşük dizine taşınır.
Ayrıca bkz.
Şunlara uygulanır
Add(String, EventHandler)
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
Parametreler
- caption
- String
Menü öğesinin başlık.
- onClick
- EventHandler
Öğeye EventHandler kullanıcı tarafından tıklandığında veya bir kullanıcı menü öğesi için bir hızlandırıcıya veya kısayol tuşuna bastığında çağrılan olay işleyicisini temsil eden bir.
Döndürülenler
MenuItem Koleksiyona eklenen menü öğesini temsil eden bir.
Örnekler
Aşağıdaki kod örneği, mainMenu1
türetilmiş sınıfını MainMenu kullanarak koleksiyonuna iki MenuItem nesne eklenmiş MenuItems olan bir ana menü oluşturur. Kod, yöntemin Add bu sürümünü kullanarak koleksiyona eklenen ikinci menü öğesinin Click olayı için bir olay işleyicisi tanımlar. Kod daha sonra özelliğini Formatar mainMenu1
Menu. Bu örnekte tanımlanan kodun bir formda bulunması gerekir.
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
Açıklamalar
bir MenuItem kerede yalnızca bir menüde bulunabilir ve aynı menüye birden çok kez eklenemez. Birden fazla menüde yeniden MenuItem kullanmak için sınıfının yöntemini MenuItem kullanınCloneMenu. Daha önce eklediğiniz bir MenuItem öğesini kaldırmak için yöntemini kullanın Remove .
Yöntemin Add bu sürümü, menü öğesi için bir başlık ve olayı işlemek Click için bir temsilci belirtmenize olanak tanır. Uygulamanızın Add olayı işlemek için zaten bir olay işleyicisi varsa yöntemin Click bu sürümünü kullanabilirsiniz.
Ayrıca bkz.
Şunlara uygulanır
Add(String, 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
Parametreler
- caption
- String
Menü öğesinin başlık.
Döndürülenler
MenuItem Koleksiyona eklenen menü öğesini temsil eden bir.
Açıklamalar
bir MenuItem kerede yalnızca bir menüde bulunabilir ve aynı menüye birden çok kez eklenemez. Birden fazla menüde yeniden MenuItem kullanmak için sınıfının yöntemini MenuItem kullanınCloneMenu. Daha önce eklediğiniz bir MenuItem öğesini kaldırmak için yöntemini kullanın Remove .
Yöntemin Add bu sürümü, menü öğesi için bir başlık ve olayını işleyecek bir temsilci belirtmenize Click olanak tanır. Uygulamanızın Add olayı işlemek için zaten bir olay işleyicisi varsa yöntemin Click bu sürümünü kullanabilirsiniz. Yöntemin bu sürümü, koleksiyona eklemek istediğiniz önceden oluşturulmuş MenuItem bir nesne dizisi belirtmenize de olanak tanır. Yöntemi kullanılarak CloneMenu kopyalanmış mevcut MenuItem nesneleri yeniden kullanmak için bu özelliği kullanabilirsiniz.
items
parametresi veya null
MenuItem boş değilse, koleksiyona eklenen alt menü öğelerini içerir.