Udostępnij za pośrednictwem


MenuItem Klasa

Definicja

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

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()
Przestarzałe.

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()
Przestarzałe.

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.

Dotyczy

Zobacz też