MenuItem Klasa

Definicja

Przestrzeń nazw:

System.Windows.Forms

Zestaw:

System.Windows.Forms.dll

Źródło:

MenuItem.cs

Uwaga

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.

Reprezentuje pojedynczy element wyświetlany w elemencie MainMenu lub ContextMenu.

Ta klasa nie jest dostępna w wersjach .NET Core 3.1 i nowszych. Zamiast tego użyj ToolStripMenuItem polecenia , który zastępuje kontrolkę 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

Dziedziczenie

Object

MarshalByRefObject

Component

Menu

MenuItem

Atrybuty

BrowsableAttribute ObsoleteAttribute

Przykłady

Poniższy przykład kodu tworzy strukturę menu dla formularza. Przykładowy kod dodaje element MenuItem do reprezentowania elementu menu najwyższego poziomu, dodaje do niego element podrzędny służący do wybierania rozmiaru czcionki, a następnie dodaje dwa elementy podrzędne do tego elementu menu reprezentującego duże i małe opcje czcionek w aplikacji. W przykładzie jest wymagany MainMenu obiekt o nazwie i cztery MenuItem obiekty o nazwie mainMenu1menuItem1, menuItem2, menuItem3i menuItem4.

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

Uwagi

Ta klasa nie jest dostępna w wersjach .NET Core 3.1 i nowszych. Użyj ToolStripMenuItem zamiast tego.

Aby element MenuItem był wyświetlany, należy dodać go do elementu MainMenu lub ContextMenu. Aby utworzyć podmenus, można dodać MenuItem obiekty do MenuItems właściwości nadrzędnego MenuItem.

Klasa MenuItem udostępnia właściwości, które umożliwiają skonfigurowanie wyglądu i funkcjonalności elementu menu. Aby wyświetlić znacznik wyboru obok elementu menu, użyj Checked właściwości . Za pomocą tej funkcji można zidentyfikować element menu wybrany na liście wzajemnie wykluczających się elementów menu. Jeśli na przykład masz zestaw elementów menu do ustawiania koloru tekstu w kontrolce TextBox , możesz użyć Checked właściwości , aby określić, który kolor jest aktualnie zaznaczony. Za Shortcut pomocą właściwości można zdefiniować kombinację klawiatury, którą można nacisnąć, aby wybrać element menu.

W przypadku MenuItem obiektów wyświetlanych w aplikacji interfejsu wielu dokumentów (MDI) można użyć MergeMenu metody , aby scalić menu elementu nadrzędnego MDI z formularzami podrzędnymi w celu utworzenia skonsolidowanej struktury menu. MenuItem Ponieważ nie można użyć ponownie w wielu lokalizacjach w tym samym czasie, na przykład w obiekcie MainMenu i ContextMenu, można użyć CloneMenu metody , aby utworzyć kopię MenuItem obiektu do użycia w innej lokalizacji.

Zdarzenie Popup umożliwia wykonywanie zadań przed wyświetleniem menu. Można na przykład utworzyć procedurę obsługi zdarzeń dla tego zdarzenia, aby wyświetlić lub ukryć elementy menu na podstawie stanu kodu. Zdarzenie Select umożliwia wykonywanie zadań, takich jak zapewnienie szczegółowej pomocy dla elementów menu aplikacji, gdy użytkownik umieszcza wskaźnik myszy nad elementem menu.

Konstruktory

Nazwa	Opis
MenuItem()	Przestarzałe. Inicjuje element MenuItem z pustym podpisem.
MenuItem(MenuMerge, Int32, Shortcut, String, EventHandler, EventHandler, EventHandler, MenuItem[])	Przestarzałe. Inicjuje nowe wystąpienie MenuItem klasy z określonym podpisem; zdefiniowane programy obsługi zdarzeń dla Clickzdarzeń i Popup , Select klawisz skrótu, typ scalania i kolejność określoną dla elementu menu.
MenuItem(String, EventHandler, Shortcut)	Przestarzałe. Inicjuje nowe wystąpienie klasy z określonym podpisem, procedurą obsługi zdarzeń i skojarzonym klawiszem skrótu dla elementu menu.
MenuItem(String, EventHandler)	Przestarzałe. Inicjuje nowe wystąpienie klasy z określonym podpisem i procedurą obsługi zdarzeń dla Click zdarzenia elementu menu.
MenuItem(String, MenuItem[])	Przestarzałe. Inicjuje nowe wystąpienie klasy z określonym podpisem i tablicą elementów podrzędnych zdefiniowanych dla elementu menu.
MenuItem(String)	Przestarzałe. Inicjuje nowe wystąpienie MenuItem klasy z określonym podpisem elementu menu.

Pola

Nazwa	Opis
FindHandle	Przestarzałe. Określa, że FindMenuItem(Int32, IntPtr) metoda powinna wyszukać uchwyt. (Odziedziczone po Menu)
FindShortcut	Przestarzałe. Określa, że FindMenuItem(Int32, IntPtr) metoda powinna wyszukiwać skrót. (Odziedziczone po Menu)

Właściwości

Nazwa	Opis
BarBreak	Przestarzałe. Pobiera lub ustawia wartość wskazującą, czy MenuItem element jest umieszczany w nowym wierszu (dla elementu menu dodanego do MainMenu obiektu) lub w nowej kolumnie (dla elementu podrzędnego lub elementu menu wyświetlanego w elemencie ContextMenu).
Break	Przestarzałe. Pobiera lub ustawia wartość wskazującą, czy element jest umieszczany w nowym wierszu (dla elementu menu dodanego do MainMenu obiektu) lub w nowej kolumnie (dla elementu menu lub elementu podrzędnego wyświetlanego w elemencie ContextMenu).
Checked	Przestarzałe. Pobiera lub ustawia wartość wskazującą, czy obok tekstu elementu menu pojawia się znacznik wyboru.
DefaultItem	Przestarzałe. Pobiera lub ustawia wartość wskazującą, czy element menu jest domyślnym elementem menu.
Enabled	Przestarzałe. Pobiera lub ustawia wartość wskazującą, czy element menu jest włączony.
Handle	Przestarzałe. Pobiera wartość reprezentującą uchwyt okna dla menu. (Odziedziczone po Menu)
Index	Przestarzałe. Pobiera lub ustawia wartość wskazującą położenie elementu menu w menu nadrzędnym.
IsParent	Przestarzałe. Pobiera wartość wskazującą, czy element menu zawiera elementy menu podrzędnego.
MdiList	Przestarzałe. Pobiera lub ustawia wartość wskazującą, czy element menu zostanie wypełniony listą okien podrzędnych interfejsu wielu dokumentów (MDI), które są wyświetlane w skojarzonym formularzu.
MdiListItem	Przestarzałe. Pobiera wartość wskazującą MenuItem , która jest używana do wyświetlania listy formularzy podrzędnych interfejsu wielu dokumentów (MDI). (Odziedziczone po Menu)
MenuID	Przestarzałe. Pobiera wartość wskazującą identyfikator systemu Windows dla tego elementu menu.
MenuItems	Przestarzałe. Pobiera wartość wskazującą kolekcję obiektów skojarzonych MenuItem z menu. (Odziedziczone po Menu)
MergeOrder	Przestarzałe. Pobiera lub ustawia wartość wskazującą względną pozycję elementu menu po scaleniu z innym elementem.
MergeType	Przestarzałe. Pobiera lub ustawia wartość wskazującą zachowanie tego elementu menu, gdy jego menu zostanie scalone z innym.
Mnemonic	Przestarzałe. Pobiera wartość wskazującą znak mnemonic skojarzony z tym elementem menu.
Name	Przestarzałe. Pobiera lub ustawia nazwę Menuelementu . (Odziedziczone po Menu)
OwnerDraw	Przestarzałe. Pobiera lub ustawia wartość wskazującą, czy kod, który podajesz, rysuje element menu, czy system Windows rysuje element menu.
Parent	Przestarzałe. Pobiera wartość wskazującą menu zawierające ten element menu.
RadioCheck	Przestarzałe. Pobiera lub ustawia wartość wskazującą, czy MenuItempole wyboru , jeśli jest zaznaczone, wyświetla przycisk radiowy zamiast znacznika wyboru.
Shortcut	Przestarzałe. Pobiera lub ustawia wartość wskazującą klawisz skrótu skojarzony z elementem menu.
ShowShortcut	Przestarzałe. Pobiera lub ustawia wartość wskazującą, czy klucz skrótu skojarzony z elementem menu jest wyświetlany obok podpisu elementu menu.
Tag	Przestarzałe. Pobiera lub ustawia dane zdefiniowane przez użytkownika skojarzone z kontrolką. (Odziedziczone po Menu)
Text	Przestarzałe. Pobiera lub ustawia wartość wskazującą podpis elementu menu.
Visible	Przestarzałe. Pobiera lub ustawia wartość wskazującą, czy element menu jest widoczny.

Metody

Nazwa	Opis
CloneMenu()	Przestarzałe. Tworzy kopię bieżącego MenuItemelementu .
CloneMenu(Menu)	Przestarzałe. Kopiuje element Menu przekazywany jako parametr do bieżącego Menu. (Odziedziczone po Menu)
CloneMenu(MenuItem)	Przestarzałe. Tworzy kopię określonego MenuItemelementu .
CreateMenuHandle()	Przestarzałe. Tworzy nowy dojście do elementu Menu. (Odziedziczone po Menu)
FindMenuItem(Int32, IntPtr)	Przestarzałe. Pobiera element MenuItem zawierający określoną wartość. (Odziedziczone po Menu)
FindMergePosition(Int32)	Przestarzałe. Zwraca pozycję, w której element menu powinien zostać wstawiony do menu. (Odziedziczone po Menu)
GetContextMenu()	Przestarzałe. Pobiera element ContextMenu zawierający to menu. (Odziedziczone po Menu)
GetMainMenu()	Przestarzałe. Pobiera element MainMenu zawierający to menu. (Odziedziczone po Menu)
MergeMenu()	Przestarzałe. Scala to MenuItem z innym MenuItem elementem i zwraca wynikowy scalony MenuItemelement .
MergeMenu(Menu)	Przestarzałe. Scala MenuItem obiekty jednego menu z bieżącym menu. (Odziedziczone po Menu)
MergeMenu(MenuItem)	Przestarzałe. Scala inny element menu z tym elementem menu.
OnClick(EventArgs)	Przestarzałe. Click Wywołuje zdarzenie.
OnDrawItem(DrawItemEventArgs)	Przestarzałe. DrawItem Wywołuje zdarzenie.
OnInitMenuPopup(EventArgs)	Przestarzałe. Popup Wywołuje zdarzenie.
OnMeasureItem(MeasureItemEventArgs)	Przestarzałe. MeasureItem Wywołuje zdarzenie.
OnPopup(EventArgs)	Przestarzałe. Popup Wywołuje zdarzenie.
OnSelect(EventArgs)	Przestarzałe. Select Wywołuje zdarzenie.
PerformClick()	Przestarzałe. Click Generuje zdarzenie dla MenuItemelementu , symulując kliknięcie przez użytkownika.
PerformSelect()	Przestarzałe. Select Wywołuje zdarzenie dla tego elementu menu.
ProcessCmdKey(Message, Keys)	Przestarzałe. Przetwarza klucz polecenia. (Odziedziczone po Menu)

Zdarzenia

Nazwa	Opis
Click	Przestarzałe. Występuje po kliknięciu lub wybraniu elementu menu przy użyciu klawisza skrótu lub klucza dostępu zdefiniowanego dla elementu menu.
DrawItem	Przestarzałe. Występuje, gdy OwnerDraw właściwość elementu menu jest ustawiona na true , a żądanie jest wykonywane w celu narysowania elementu menu.
MeasureItem	Przestarzałe. Występuje, gdy menu musi znać rozmiar elementu menu przed jego rysunkiem.
Popup	Przestarzałe. Występuje przed wyświetleniem listy elementów menu.
Select	Przestarzałe. Występuje, gdy użytkownik umieszcza wskaźnik nad elementem menu.

Zobacz też

• MainMenu
• Menu
• MenuMerge
• ContextMenu