MenuItem Klasa
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
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 mainMenu1
menuItem1
, menuItem2
, menuItem3
i 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 |
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. |