MenuItem Klasa

Definicja

Przestrzeń nazw:

System.Windows.Forms

Zestaw:

System.Windows.Forms.dll

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

public class MenuItem : System.Windows.Forms.Menu

type MenuItem = class
    inherit Menu

Public Class MenuItem
Inherits Menu

Dziedziczenie

Object

MarshalByRefObject

Component

Menu

MenuItem

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 wymagany jest 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 na platformie .NET Core 3.1 i nowszych wersjach. Zamiast tego użyj polecenia cmdlet ToolStripMenuItem.

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 obiektu 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. Właściwość Shortcut może służyć do definiowania kombinacji 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 nadrzędnego MDI z formularzami podrzędnymi w celu utworzenia skonsolidowanej struktury menu. MenuItem Ponieważ nie można użyć ponownie w wielu lokalizacjach jednocześnie, takich jak w obiekcie MainMenu i , ContextMenumożna użyć CloneMenu metody , aby utworzyć kopię elementu MenuItem 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

MenuItem()	Inicjuje element MenuItem z pustym podpis.
MenuItem(MenuMerge, Int32, Shortcut, String, EventHandler, EventHandler, EventHandler, MenuItem[])	Inicjuje nowe wystąpienie MenuItem klasy z określonym podpis; zdefiniowanymi procedurami obsługi zdarzeń dla Clickelementów i SelectPopup , i kluczem skrótu, typem scalania i kolejnością określoną dla elementu menu.
MenuItem(String)	Inicjuje MenuItem nowe wystąpienie klasy z określonym podpis dla elementu menu.
MenuItem(String, EventHandler)	Inicjuje nowe wystąpienie klasy z określonym podpis i procedurą obsługi zdarzeń dla Click zdarzenia elementu menu.
MenuItem(String, EventHandler, Shortcut)	Inicjuje nowe wystąpienie klasy z określonym podpis, procedurą obsługi zdarzeń i skojarzonym klawiszem skrótu dla elementu menu.
MenuItem(String, MenuItem[])	Inicjuje nowe wystąpienie klasy z określonym podpis i tablicą elementów podrzędnych zdefiniowanych dla elementu menu.

Pola

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

Właściwości

BarBreak	Pobiera lub ustawia wartość wskazującą, czy MenuItem element jest umieszczony w nowym wierszu (dla elementu menu dodanego do MainMenu obiektu), czy w nowej kolumnie (dla elementu podrzędnego lub elementu menu wyświetlanego w elemencie ContextMenu).
Break	Pobiera lub ustawia wartość wskazującą, czy element jest umieszczony w nowym wierszu (dla elementu menu dodanego MainMenu do obiektu), czy w nowej kolumnie (dla elementu menu lub elementu podrzędnego wyświetlanego w obiekcie ContextMenu).
CanRaiseEvents	Pobiera wartość wskazującą, czy składnik może zgłosić zdarzenie. (Odziedziczone po Component)
Checked	Pobiera lub ustawia wartość wskazującą, czy obok tekstu elementu menu pojawia się znacznik wyboru.
Container	Pobiera element IContainer zawierający element Component. (Odziedziczone po Component)
DefaultItem	Pobiera lub ustawia wartość wskazującą, czy element menu jest domyślnym elementem menu.
DesignMode	Pobiera wartość wskazującą, czy Component element jest obecnie w trybie projektowania. (Odziedziczone po Component)
Enabled	Pobiera lub ustawia wartość wskazującą, czy element menu jest włączony.
Events	Pobiera listę programów obsługi zdarzeń dołączonych do tego Componentelementu . (Odziedziczone po Component)
Handle	Pobiera wartość reprezentującą uchwyt okna dla menu. (Odziedziczone po Menu)
Index	Pobiera lub ustawia wartość wskazującą położenie elementu menu w menu nadrzędnym.
IsParent	Pobiera wartość wskazującą, czy element menu zawiera elementy menu podrzędnego.
MdiList	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	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	Pobiera wartość wskazującą identyfikator systemu Windows dla tego elementu menu.
MenuItems	Pobiera wartość wskazującą kolekcję obiektów skojarzonych MenuItem z menu. (Odziedziczone po Menu)
MergeOrder	Pobiera lub ustawia wartość wskazującą względną pozycję elementu menu po scaleniu z innym elementem.
MergeType	Pobiera lub ustawia wartość wskazującą zachowanie tego elementu menu, gdy jego menu jest scalane z innym.
Mnemonic	Pobiera wartość wskazującą znak mnemonic skojarzony z tym elementem menu.
Name	Pobiera lub ustawia nazwę .Menu (Odziedziczone po Menu)
OwnerDraw	Pobiera lub ustawia wartość wskazującą, czy kod, który podajesz, rysuje element menu, czy system Windows rysuje element menu.
Parent	Pobiera wartość wskazującą menu zawierające ten element menu.
RadioCheck	Pobiera lub ustawia wartość wskazującą, czy MenuItemwartość , jeśli jest zaznaczona, wyświetla przycisk radiowy zamiast znacznika wyboru.
Shortcut	Pobiera lub ustawia wartość wskazującą klawisz skrótu skojarzony z elementem menu.
ShowShortcut	Pobiera lub ustawia wartość wskazującą, czy klucz skrótu skojarzony z elementem menu jest wyświetlany obok podpis elementu menu.
Site	Pobiera lub ustawia wartość ISite .Component (Odziedziczone po Component)
Tag	Pobiera lub ustawia dane zdefiniowane przez użytkownika skojarzone z kontrolką. (Odziedziczone po Menu)
Text	Pobiera lub ustawia wartość wskazującą podpis elementu menu.
Visible	Pobiera lub ustawia wartość wskazującą, czy element menu jest widoczny.

Metody

CloneMenu()	Tworzy kopię bieżącego MenuItemelementu .
CloneMenu(Menu)	Kopiuje Menu element przekazywany jako parametr do bieżącego Menuelementu . (Odziedziczone po Menu)
CloneMenu(MenuItem)	Tworzy kopię określonego MenuItemelementu .
CreateMenuHandle()	Tworzy nowy dojście do elementu Menu. (Odziedziczone po Menu)
CreateObjRef(Type)	Tworzy obiekt zawierający wszystkie istotne informacje wymagane do wygenerowania serwera proxy używanego do komunikowania się z obiektem zdalnym. (Odziedziczone po MarshalByRefObject)
Dispose()	Zwalnia wszelkie zasoby używane przez element Component. (Odziedziczone po Component)
Dispose(Boolean)	Usuwa zasoby (inne niż pamięć) używane przez program MenuItem.
Equals(Object)	Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object)
FindMenuItem(Int32, IntPtr)	Pobiera element MenuItem zawierający określoną wartość. (Odziedziczone po Menu)
FindMergePosition(Int32)	Zwraca pozycję, w której element menu powinien zostać wstawiony do menu. (Odziedziczone po Menu)
GetContextMenu()	Pobiera element ContextMenu zawierający to menu. (Odziedziczone po Menu)
GetHashCode()	Służy jako domyślna funkcja skrótu. (Odziedziczone po Object)
GetLifetimeService()	Pobiera bieżący obiekt usługi okresu istnienia, który kontroluje zasady okresu istnienia dla tego wystąpienia. (Odziedziczone po MarshalByRefObject)
GetMainMenu()	Pobiera element MainMenu zawierający to menu. (Odziedziczone po Menu)
GetService(Type)	Zwraca obiekt, który reprezentuje usługę dostarczaną przez Component obiekt lub przez element Container. (Odziedziczone po Component)
GetType()	Type Pobiera wartość bieżącego wystąpienia. (Odziedziczone po Object)
InitializeLifetimeService()	Uzyskuje obiekt usługi okresu istnienia w celu kontrolowania zasad okresu istnienia dla tego wystąpienia. (Odziedziczone po MarshalByRefObject)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
MemberwiseClone(Boolean)	Tworzy płytkią kopię bieżącego MarshalByRefObject obiektu. (Odziedziczone po MarshalByRefObject)
MergeMenu()	Scala to MenuItem z innym MenuItem elementem i zwraca wynikowy scalony MenuItemelement .
MergeMenu(Menu)	Scala MenuItem obiekty jednego menu z bieżącym menu. (Odziedziczone po Menu)
MergeMenu(MenuItem)	Scala inny element menu z tym elementem menu.
OnClick(EventArgs)	Click Zgłasza zdarzenie.
OnDrawItem(DrawItemEventArgs)	DrawItem Zgłasza zdarzenie.
OnInitMenuPopup(EventArgs)	Popup Zgłasza zdarzenie.
OnMeasureItem(MeasureItemEventArgs)	MeasureItem Zgłasza zdarzenie.
OnPopup(EventArgs)	Popup Zgłasza zdarzenie.
OnSelect(EventArgs)	Select Zgłasza zdarzenie.
PerformClick()	Click Generuje zdarzenie dla MenuItemelementu , symulując kliknięcie przez użytkownika.
PerformSelect()	Select Zgłasza zdarzenie dla tego elementu menu.
ProcessCmdKey(Message, Keys)	Przetwarza klucz polecenia. (Odziedziczone po Menu)
ToString()	Zwraca ciąg reprezentujący element MenuItem.

Zdarzenia

Click	Występuje po kliknięciu lub wybraniu elementu menu przy użyciu klawisza skrótu lub klucza dostępu zdefiniowanego dla elementu menu.
Disposed	Występuje, gdy składnik jest usuwany przez wywołanie Dispose() metody . (Odziedziczone po Component)
DrawItem	Występuje, gdy OwnerDraw właściwość elementu menu jest ustawiona na true , a żądanie jest wykonywane w celu narysowania elementu menu.
MeasureItem	Występuje, gdy menu musi znać rozmiar elementu menu przed jego rysowaniem.
Popup	Występuje przed wyświetleniem listy elementów menu.
Select	Występuje, gdy użytkownik umieszcza wskaźnik nad elementem menu.

Zobacz też

• MainMenu
• Menu
• MenuMerge
• ContextMenu