MenuItem Sınıf

Başvuru

Tanım

Ad Alanı:: System.Windows.Forms

Bütünleştirilmiş Kod:: System.Windows.Forms.dll

Ö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.

veya ContextMenuiçinde görüntülenen tek bir MainMenu öğeyi temsil eder.

Bu sınıf .NET Core 3.1 ve sonraki sürümlerde kullanılamaz. Bunun yerine, denetimin yerini alan öğesini MenuItem kullanınToolStripMenuItem.

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

Devralma: Object

MarshalByRefObject

Component

Menu
MenuItem

Örnekler

Aşağıdaki kod örneği, form için bir menü yapısı oluşturur. Örnek kod, en üst düzey menü öğesini temsil etmek için bir MenuItem ekler, yazı tipi boyutunu seçmek için buna bir alt menü öğesi ekler ve ardından bu menü öğesine bir uygulamadaki büyük ve küçük yazı tipi seçimlerini temsil eden iki alt menü öğesi ekler. Örnek, adlı bir MainMenu nesnenin ve , menuItem2, menuItem3ve menuItem4adlı menuItem1dört MenuItem nesnenin olmasını mainMenu1 gerektirir.

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

Açıklamalar

Bu sınıf .NET Core 3.1 ve sonraki sürümlerde kullanılamaz. Bunun yerine ToolStripMenuItem kullanın.

bir öğesinin görüntülenmesi için MenuItem bunu veya MainMenu ContextMenuöğesine eklemeniz gerekir. Alt menüler oluşturmak için üst MenuItemöğesinin MenuItems özelliğine nesneler ekleyebilirsinizMenuItem.

sınıfı, MenuItem bir menü öğesinin görünümünü ve işlevselliğini yapılandırmanızı sağlayan özellikler sağlar. Menü öğesinin yanında onay işareti görüntülemek için özelliğini kullanın Checked . Bu özelliği, birbirini dışlayan menü öğeleri listesinde seçilen bir menü öğesini tanımlamak için kullanabilirsiniz. Örneğin, denetimdeki TextBox metnin rengini ayarlamak için bir dizi menü öğeniz varsa, şu anda seçili olan rengi belirlemek için özelliğini kullanabilirsiniz Checked . Shortcut özelliği, menü öğesini seçmek için basılabilir bir klavye bileşimi tanımlamak için kullanılabilir.

MenuItem Birden Çok Belge Arabirimi (MDI) uygulamasında görüntülenen nesneler için yöntemini kullanarak MergeMenu MDI üst öğesinin menülerini alt formlarıyla birleştirerek birleştirilmiş menü yapısı oluşturabilirsiniz. bir ve gibi MainMenu birden çok konumda aynı anda yeniden kullanılamayacağından, başka bir ContextMenukonumda kullanmak üzere bir MenuItem kopyasını oluşturmak için yöntemini kullanabilirsinizCloneMenu.MenuItem

Olay, Popup menü görüntülenmeden önce görevleri gerçekleştirmenizi sağlar. Örneğin, kodunuzun durumuna göre menü öğelerini görüntülemek veya gizlemek için bu olay için bir olay işleyicisi oluşturabilirsiniz. Olay, Select kullanıcı fare işaretçisini bir menü öğesinin üzerine getirdiğinde uygulamanızın menü öğeleri için ayrıntılı yardım sağlama gibi görevleri gerçekleştirmenizi sağlar.

Oluşturucular

MenuItem()	Boş bir başlık ile bir MenuItem başlatır.
MenuItem(MenuMerge, Int32, Shortcut, String, EventHandler, EventHandler, EventHandler, MenuItem[])	sınıfının yeni bir örneğini MenuItem belirtilen başlık; ve Popup olayları için Click Select tanımlanmış olay işleyicileri; bir kısayol tuşu; birleştirme türü ve menü öğesi için belirtilen sıra ile başlatır.
MenuItem(String)	Menü öğesi için belirtilen bir başlık ile sınıfının yeni bir örneğini MenuItem başlatır.
MenuItem(String, EventHandler)	Menü öğesinin olayı için Click belirtilen başlık ve olay işleyicisiyle sınıfının yeni bir örneğini başlatır.
MenuItem(String, EventHandler, Shortcut)	Menü öğesi için belirtilen başlık, olay işleyicisi ve ilişkili kısayol tuşuyla sınıfının yeni bir örneğini başlatır.
MenuItem(String, MenuItem[])	Belirtilen bir başlık ve menü öğesi için tanımlanmış bir alt menü öğeleri dizisiyle sınıfının yeni bir örneğini başlatır.

Alanlar

FindHandle	yönteminin FindMenuItem(Int32, IntPtr) bir tanıtıcı araması gerektiğini belirtir. (Devralındığı yer: Menu)
FindShortcut	yönteminin FindMenuItem(Int32, IntPtr) bir kısayol araması gerektiğini belirtir. (Devralındığı yer: Menu)

Özellikler

BarBreak	öğesinin MenuItem yeni bir satıra mı (nesneye eklenen menü öğesi için) yoksa yeni bir sütuna MainMenu mı (içinde görüntülenen bir alt menü öğesi veya menü öğesi için) yerleştirildiğini belirten bir ContextMenudeğer alır veya ayarlar.
Break	Öğenin yeni bir satıra mı (nesneye eklenen bir menü öğesi için) yoksa yeni bir sütuna MainMenu mı (içinde görüntülenen bir menü öğesi veya alt menü öğesi için) yerleştirildiğini belirten bir ContextMenudeğer alır veya ayarlar.
CanRaiseEvents	Bileşenin olay oluşturup oluşturamayacağını belirten bir değer alır. (Devralındığı yer: Component)
Checked	Menü öğesinin metninin yanında onay işaretinin görünüp görünmediğini belirten bir değer alır veya ayarlar.
Container	öğesini IContainer içeren öğesini Componentalır. (Devralındığı yer: Component)
DefaultItem	Menü öğesinin varsayılan menü öğesi olup olmadığını belirten bir değer alır veya ayarlar.
DesignMode	öğesinin şu anda tasarım modunda olup olmadığını Component gösteren bir değer alır. (Devralındığı yer: Component)
Enabled	Menü öğesinin etkinleştirilip etkinleştirilmediğini belirten bir değer alır veya ayarlar.
Events	Bu Componentöğesine eklenen olay işleyicilerinin listesini alır. (Devralındığı yer: Component)
Handle	Menünün pencere tutamacını temsil eden bir değer alır. (Devralındığı yer: Menu)
Index	Menü öğesinin üst menüsündeki konumunu belirten bir değer alır veya ayarlar.
IsParent	Menü öğesinin alt menü öğeleri içerip içermediğini belirten bir değer alır.
MdiList	Menü öğesinin ilişkili formda görüntülenen Birden Çok Belge Arabirimi (MDI) alt penceresi listesiyle doldurulup doldurulmayacağını belirten bir değer alır veya ayarlar.
MdiListItem	Birden çok belge arabirimi (MDI) alt formu listesini görüntülemek için kullanılan değerini belirten MenuItem bir değer alır. (Devralındığı yer: Menu)
MenuID	Bu menü öğesi için Windows tanımlayıcısını gösteren bir değer alır.
MenuItems	Menüyle ilişkili nesne koleksiyonunu MenuItem gösteren bir değer alır. (Devralındığı yer: Menu)
MergeOrder	Başka bir öğeyle birleştirildiğinde menü öğesinin göreli konumunu gösteren bir değeri alır veya ayarlar.
MergeType	Menüsü başka bir öğeyle birleştirildiğinde bu menü öğesinin davranışını gösteren bir değeri alır veya ayarlar.
Mnemonic	Bu menü öğesiyle ilişkili anımsatıcı karakteri gösteren bir değer alır.
Name	öğesinin adını Menualır veya ayarlar. (Devralındığı yer: Menu)
OwnerDraw	Sağladığınız kodun menü öğesini mi yoksa Windows'un menü öğesini mi çizdiğini belirten bir değer alır veya ayarlar.
Parent	Bu menü öğesini içeren menüyü gösteren bir değer alır.
RadioCheck	işaretliyse onay işareti yerine radyo düğmesi görüntüleyip görüntülemediğini MenuItembelirten bir değer alır veya ayarlar.
Shortcut	Menü öğesiyle ilişkili kısayol tuşunu gösteren bir değeri alır veya ayarlar.
ShowShortcut	Menü öğesiyle ilişkili kısayol tuşunun başlık menü öğesinin yanında görüntülenip görüntülenmeyeceğini belirten bir değer alır veya ayarlar.
Site	öğesini alır veya ayarlar ISite Component. (Devralındığı yer: Component)
Tag	Denetimle ilişkili kullanıcı tanımlı verileri alır veya ayarlar. (Devralındığı yer: Menu)
Text	Menü öğesinin başlık belirten bir değer alır veya ayarlar.
Visible	Menü öğesinin görünür olup olmadığını belirten bir değer alır veya ayarlar.

Yöntemler

CloneMenu()	Geçerli MenuItemöğesinin bir kopyasını oluşturur.
CloneMenu(Menu)	Menu Parametre olarak geçirilen öğesini geçerli Menuöğesine kopyalar. (Devralındığı yer: Menu)
CloneMenu(MenuItem)	Belirtilen MenuItemöğesinin bir kopyasını oluşturur.
CreateMenuHandle()	için Menuyeni bir tanıtıcı oluşturur. (Devralındığı yer: Menu)
CreateObjRef(Type)	Uzak bir nesneyle iletişim kurmak için kullanılan bir ara sunucu oluşturmak için gereken tüm ilgili bilgileri içeren bir nesne oluşturur. (Devralındığı yer: MarshalByRefObject)
Dispose()	Component tarafından kullanılan tüm kaynakları serbest bırakır. (Devralındığı yer: Component)
Dispose(Boolean)	tarafından kullanılan kaynakları (bellek dışında) atlar MenuItem.
Equals(Object)	Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler. (Devralındığı yer: Object)
FindMenuItem(Int32, IntPtr)	MenuItem Belirtilen değeri içeren değerini alır. (Devralındığı yer: Menu)
FindMergePosition(Int32)	Menü öğesinin menüye eklenmesi gereken konumu döndürür. (Devralındığı yer: Menu)
GetContextMenu()	Bu menüyü ContextMenu içeren öğesini alır. (Devralındığı yer: Menu)
GetHashCode()	Varsayılan karma işlevi işlevi görür. (Devralındığı yer: Object)
GetLifetimeService()	Geçersiz. Bu örnek için yaşam süresi ilkesini denetleen geçerli yaşam süresi hizmet nesnesini alır. (Devralındığı yer: MarshalByRefObject)
GetMainMenu()	Bu menüyü MainMenu içeren öğesini alır. (Devralındığı yer: Menu)
GetService(Type)	veya tarafından Component Containersağlanan bir hizmeti temsil eden bir nesnesi döndürür. (Devralındığı yer: Component)
GetType()	Type Geçerli örneğini alır. (Devralındığı yer: Object)
InitializeLifetimeService()	Geçersiz. Bu örneğin yaşam süresi ilkesini denetlemek için bir yaşam süresi hizmet nesnesi alır. (Devralındığı yer: MarshalByRefObject)
MemberwiseClone()	Geçerli Objectöğesinin sığ bir kopyasını oluşturur. (Devralındığı yer: Object)
MemberwiseClone(Boolean)	Geçerli MarshalByRefObject nesnenin sığ bir kopyasını oluşturur. (Devralındığı yer: MarshalByRefObject)
MergeMenu()	Bunu MenuItem başka bir ile birleştirir MenuItem ve sonuçta birleştirilen MenuItemsonucunu döndürür.
MergeMenu(Menu)	Bir menünün MenuItem nesnelerini geçerli menüyle birleştirir. (Devralındığı yer: Menu)
MergeMenu(MenuItem)	Başka bir menü öğesini bu menü öğesiyle birleştirir.
OnClick(EventArgs)	Olayı tetikler Click .
OnDrawItem(DrawItemEventArgs)	Olayı tetikler DrawItem .
OnInitMenuPopup(EventArgs)	Olayı tetikler Popup .
OnMeasureItem(MeasureItemEventArgs)	Olayı tetikler MeasureItem .
OnPopup(EventArgs)	Olayı tetikler Popup .
OnSelect(EventArgs)	Olayı tetikler Select .
PerformClick()	için MenuItembir Click kullanıcı tarafından tıklama benzetimi yaparak bir olay oluşturur.
PerformSelect()	Bu menü öğesi için olayı tetikler Select .
ProcessCmdKey(Message, Keys)	Bir komut anahtarını işler. (Devralındığı yer: Menu)
ToString()	öğesini temsil MenuItemeden bir dize döndürür.

Ekinlikler

Click	Menü öğesi için tanımlanan bir kısayol tuşu veya erişim tuşu kullanılarak menü öğesine tıklandığında veya seçildiğinde gerçekleşir.
Disposed	Bileşen yöntemine Dispose() yapılan bir çağrı tarafından atıldığında gerçekleşir. (Devralındığı yer: Component)
DrawItem	Menü öğesinin OwnerDraw özelliği olarak ayarlandığında `true` ve menü öğesini çizme isteğinde bulunulduğunda gerçekleşir.
MeasureItem	Menünün çizmeden önce menü öğesinin boyutunu bilmesi gerektiğinde gerçekleşir.
Popup	Bir menü öğesinin menü öğeleri listesi görüntülenmeden önce gerçekleşir.
Select	Kullanıcı işaretçiyi bir menü öğesinin üzerine yerleştirdiğinde gerçekleşir.

Şunlara uygulanır

Aracılığıyla paylaş