MenuItem Sınıf

Tanım

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

Ö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 MainMenuContextMenuöğ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 ClickSelect 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 ISiteComponent.

(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 ComponentContainersağ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

Ayrıca bkz.