MenuItem Sınıf

Tanım

Ad Alanı:

System.Windows.Forms

Bütünleştirilmiş Kod:

System.Windows.Forms.dll

Kaynak:

MenuItem.cs

Dikkat

Menu is provided for binary compatibility with .NET Framework and is not intended to be used directly from your code. Use ToolStripDropDown and ToolStripDropDownMenu instead.

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 ToolStripMenuItem yerine, denetimin yerini alan kullanın MenuItem .

public ref class MenuItem : System::Windows::Forms::Menu

[System.ComponentModel.Browsable(false)]
[System.Obsolete("`Menu` is provided for binary compatibility with .NET Framework and is not intended to be used directly from your code. Use `ToolStripDropDown` and `ToolStripDropDownMenu` instead.", false, DiagnosticId="WFDEV006", UrlFormat="https://aka.ms/winforms-warnings/{0}")]
public class MenuItem : System.Windows.Forms.Menu

[<System.ComponentModel.Browsable(false)>]
[<System.Obsolete("`Menu` is provided for binary compatibility with .NET Framework and is not intended to be used directly from your code. Use `ToolStripDropDown` and `ToolStripDropDownMenu` instead.", false, DiagnosticId="WFDEV006", UrlFormat="https://aka.ms/winforms-warnings/{0}")>]
type MenuItem = class
    inherit Menu

Public Class MenuItem
Inherits Menu

Devralma

Object

MarshalByRefObject

Component

Menu

MenuItem

Öznitelikler

BrowsableAttribute ObsoleteAttribute

Örnekler

Aşağıdaki kod örneği, form için bir menü yapısı oluşturur. Örnek kod, en üst düzey menü öğesini göstermek için bir MenuItem ekler, yazı tipi boyutu seçmek için bu öğeye bir alt menü öğesi ekler ve sonra 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.

öğesinin görüntülenebilmesi için MenuItem veya öğesine MainMenuContextMenueklemeniz 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, bir denetimdeki TextBox metnin rengini ayarlamak için bir menü öğeleri kümeniz 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ş bir menü yapısı oluşturabilirsiniz. ve MenuItem gibi MainMenuContextMenubirden çok konumda aynı anda yeniden kullanılamayacağından, yöntemini kullanarak CloneMenu başka bir konumda kullanmak üzere bir MenuItem kopyasını oluşturabilirsiniz.

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

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

Alanlar

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

Özellikler

Name	Description
BarBreak	Geçersiz. öğesinin MenuItem yeni bir satıra mı (nesneye MainMenu eklenen bir menü öğesi için) yoksa yeni bir sütuna 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	Geçersiz. Öğenin yeni bir satıra mı (nesneye MainMenu eklenen bir menü öğesi için) yoksa yeni bir sütuna 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.
Checked	Geçersiz. Menü öğesinin metninin yanında onay işaretinin görünüp görünmediğini belirten bir değer alır veya ayarlar.
DefaultItem	Geçersiz. Menü öğesinin varsayılan menü öğesi olup olmadığını belirten bir değer alır veya ayarlar.
Enabled	Geçersiz. Menü öğesinin etkinleştirilip etkinleştirilmediğini belirten bir değer alır veya ayarlar.
Handle	Geçersiz. Menünün pencere tutamacını temsil eden bir değer alır. (Devralındığı yer: Menu)
Index	Geçersiz. Menü öğesinin üst menüsündeki konumunu gösteren bir değer alır veya ayarlar.
IsParent	Geçersiz. Menü öğesinin alt menü öğeleri içerip içermediğini belirten bir değer alır.
MdiList	Geçersiz. 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	Geçersiz. 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	Geçersiz. Bu menü öğesi için Windows tanımlayıcısını gösteren bir değer alır.
MenuItems	Geçersiz. Menüyle ilişkili nesne koleksiyonunu MenuItem gösteren bir değer alır. (Devralındığı yer: Menu)
MergeOrder	Geçersiz. Menü öğesinin başka bir öğeyle birleştirildiğinde göreli konumunu gösteren bir değer alır veya ayarlar.
MergeType	Geçersiz. Menüsü başka bir menüyle birleştirildiğinde bu menü öğesinin davranışını gösteren bir değer alır veya ayarlar.
Mnemonic	Geçersiz. Bu menü öğesiyle ilişkili anımsatıcı karakteri gösteren bir değer alır.
Name	Geçersiz. öğesinin adını Menualır veya ayarlar. (Devralındığı yer: Menu)
OwnerDraw	Geçersiz. 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	Geçersiz. Bu menü öğesini içeren menüyü gösteren bir değer alır.
RadioCheck	Geçersiz. 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	Geçersiz. Menü öğesiyle ilişkili kısayol tuşunu gösteren bir değer alır veya ayarlar.
ShowShortcut	Geçersiz. Menü öğesi resim yazısının yanında menü öğesiyle ilişkili kısayol tuşunun görüntülenip görüntülenmeyeceğini belirten bir değer alır veya ayarlar.
Tag	Geçersiz. Denetimle ilişkili kullanıcı tanımlı verileri alır veya ayarlar. (Devralındığı yer: Menu)
Text	Geçersiz. Menü öğesinin resim yazısını gösteren bir değer alır veya ayarlar.
Visible	Geçersiz. Menü öğesinin görünür olup olmadığını belirten bir değer alır veya ayarlar.

Yöntemler

Name	Description
CloneMenu()	Geçersiz. Geçerli MenuItembir kopyasını oluşturur.
CloneMenu(Menu)	Geçersiz. Menu Parametresi olarak geçirilen öğesini geçerli Menuöğesine kopyalar. (Devralındığı yer: Menu)
CloneMenu(MenuItem)	Geçersiz. Belirtilen MenuItemöğesinin bir kopyasını oluşturur.
CreateMenuHandle()	Geçersiz. için Menuyeni bir tanıtıcı oluşturur. (Devralındığı yer: Menu)
FindMenuItem(Int32, IntPtr)	Geçersiz. MenuItem Belirtilen değeri içeren değerini alır. (Devralındığı yer: Menu)
FindMergePosition(Int32)	Geçersiz. Menü öğesinin menüye eklenmesi gereken konumu döndürür. (Devralındığı yer: Menu)
GetContextMenu()	Geçersiz. Bu menüyü ContextMenu içeren öğesini alır. (Devralındığı yer: Menu)
GetMainMenu()	Geçersiz. Bu menüyü MainMenu içeren öğesini alır. (Devralındığı yer: Menu)
MergeMenu()	Geçersiz. Bunu MenuItem başka bir ile birleştirir MenuItem ve elde edilen birleştirilmiş MenuItemsonucunu döndürür.
MergeMenu(Menu)	Geçersiz. Bir menünün MenuItem nesnelerini geçerli menüyle birleştirir. (Devralındığı yer: Menu)
MergeMenu(MenuItem)	Geçersiz. Başka bir menü öğesini bu menü öğesiyle birleştirir.
OnClick(EventArgs)	Geçersiz. Olayı tetikler Click .
OnDrawItem(DrawItemEventArgs)	Geçersiz. Olayı tetikler DrawItem .
OnInitMenuPopup(EventArgs)	Geçersiz. Olayı tetikler Popup .
OnMeasureItem(MeasureItemEventArgs)	Geçersiz. Olayı tetikler MeasureItem .
OnPopup(EventArgs)	Geçersiz. Olayı tetikler Popup .
OnSelect(EventArgs)	Geçersiz. Olayı tetikler Select .
PerformClick()	Geçersiz. Click bir kullanıcı tarafından tıklama benzetimi MenuItemyaparak için bir olay oluşturur.
PerformSelect()	Geçersiz. Bu menü öğesi için olayı yükseltir Select .
ProcessCmdKey(Message, Keys)	Geçersiz. Bir komut anahtarını işler. (Devralındığı yer: Menu)

Ekinlikler

Name	Description
Click	Geçersiz. 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.
DrawItem	Geçersiz. Menü öğesinin OwnerDraw özelliği olarak ayarlandığında true ve menü öğesini çizmek için istekte bulunulduğunda gerçekleşir.
MeasureItem	Geçersiz. Menüyü çizmeden önce menü öğesinin boyutunu bilmesi gerektiğinde gerçekleşir.
Popup	Geçersiz. Bir menü öğesinin menü öğeleri listesi görüntülenmeden önce gerçekleşir.
Select	Geçersiz. Kullanıcı işaretçiyi bir menü öğesinin üzerine yerleştirdiğinde gerçekleşir.

Ayrıca bkz.

• MainMenu
• Menu
• MenuMerge
• ContextMenu