Menu Klasa

Definicja

Przestrzeń nazw:: System.Windows.Forms

Zestaw:: System.Windows.Forms.dll

Źródło:: Menu.cs

Źródło:: Menu.cs

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.

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 podstawową funkcjonalność wszystkich menu.

Ta klasa nie jest dostępna w wersjach .NET Core 3.1 i nowszych. Użyj ToolStripDropDown poleceń i ToolStripDropDownMenu , które zastępują i rozszerzają kontrolkę Menu .

public ref class Menu abstract : System::ComponentModel::Component

[System.ComponentModel.ListBindable(false)]
public abstract class Menu : System.ComponentModel.Component

[System.ComponentModel.ListBindable(false)]
[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 abstract class Menu : System.ComponentModel.Component

[<System.ComponentModel.ListBindable(false)>]
type Menu = class
    inherit Component

[<System.ComponentModel.ListBindable(false)>]
[<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 Menu = class
    inherit Component

Public MustInherit Class Menu
Inherits Component

Dziedziczenie: Object

MarshalByRefObject

Component
Menu

Pochodne: System.Windows.Forms.ContextMenu

System.Windows.Forms.MainMenu

System.Windows.Forms.MenuItem

Atrybuty: ListBindableAttribute BrowsableAttribute ObsoleteAttribute

Przykłady

W poniższym przykładzie kodu użyto klasy pochodnej , MenuItemaby utworzyć 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 ToolStripDropDown i ToolStripDropDownMenu zamiast tego.

Ta klasa jest klasą bazową dla MainMenuklas , MenuItemi ContextMenu . Nie można utworzyć wystąpienia tej klasy. Menu aplikacji składają się z MenuItem obiektów. Mogą one zawierać inne MenuItem obiekty reprezentujące elementy podrzędne. Obiekty MenuItem mogą być przechowywane w MainMenu obiekcie do wyświetlania jako cała struktura menu formularza lub obiektu ContextMenu używanego do wyświetlania menu skrótów. Ta klasa udostępnia funkcje wspólne dla wszystkich klas menu.

W przeciwieństwie do wielu klas Menu bazowych klasa używa swoich klas pochodnych do zdefiniowania wielu jej właściwości. Jeśli używasz menu w aplikacji interfejsu wielodokumentowego (MDI), możesz użyć MdiListItem właściwości , aby określić MenuItem , która wyświetla listę otwartych formularzy podrzędnych MDI w aplikacji. Właściwość MenuItems zawiera listę obiektów przechowywanych MenuItem w klasie menu. Dla obiektu MainMenu lub ContextMenuta właściwość zawiera wszystkie MenuItem wyświetlane obiekty. W przypadku elementu MenuItem MenuItems właściwość reprezentuje skojarzone z nim elementy podrzędne.

Oprócz właściwości dostępnych dla wszystkich klas Menu menu pochodnych klasa udostępnia również metody, takie jak CloneMenu i MergeMenu, które umożliwiają tworzenie nowych menu z istniejących menu, a także scalanie dwóch struktur menu razem.

Klasa Menu definiuje również klasę Menu.MenuItemCollectionzagnieżdżonych . Ta klasa definiuje kolekcję obiektów używanych MenuItem przez MenuItems właściwość . Metody klasy umożliwiają Menu.MenuItemCollection dodawanie i usuwanie elementów menu z elementu MainMenu, ContextMenulub MenuItem.

Konstruktory

Nazwa	Opis
Menu(MenuItem[])	Przestarzałe. Inicjuje nowe wystąpienie klasy Menu.

Pola

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

Właściwości

Nazwa	Opis
CanRaiseEvents	Przestarzałe. Pobiera wartość wskazującą, czy składnik może zgłosić zdarzenie. (Odziedziczone po Component)
Container	Przestarzałe. Pobiera element IContainer zawierający element Component. (Odziedziczone po Component)
DesignMode	Przestarzałe. Pobiera wartość wskazującą, czy Component element jest obecnie w trybie projektowania. (Odziedziczone po Component)
Events	Przestarzałe. Pobiera listę programów obsługi zdarzeń dołączonych do tego elementu Component. (Odziedziczone po Component)
Handle	Przestarzałe. Pobiera wartość reprezentującą uchwyt okna dla menu.
IsParent	Przestarzałe. Pobiera wartość wskazującą, czy to menu zawiera jakiekolwiek elementy menu. Ta właściwość jest tylko do odczytu.
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).
MenuItems	Przestarzałe. Pobiera wartość wskazującą kolekcję obiektów skojarzonych MenuItem z menu.
Name	Przestarzałe. Pobiera lub ustawia nazwę Menuelementu .
Site	Przestarzałe. Pobiera lub ustawia ISite Component. (Odziedziczone po Component)
Tag	Przestarzałe. Pobiera lub ustawia dane zdefiniowane przez użytkownika skojarzone z kontrolką.

Metody

Nazwa	Opis
CloneMenu(Menu)	Przestarzałe. Kopiuje element Menu przekazywany jako parametr do bieżącego Menu.
CreateMenuHandle()	Przestarzałe. Tworzy nowy dojście do elementu Menu.
CreateObjRef(Type)	Przestarzałe. Tworzy obiekt zawierający wszystkie istotne informacje wymagane do wygenerowania serwera proxy używanego do komunikowania się z obiektem zdalnym. (Odziedziczone po MarshalByRefObject)
Dispose()	Przestarzałe. Zwalnia wszystkie zasoby używane przez program Component. (Odziedziczone po Component)
Dispose(Boolean)	Przestarzałe. Usuwa zasoby, inne niż pamięć, używane przez element Menu.
Equals(Object)	Przestarzałe. Określa, czy określony obiekt jest równy bieżącemu obiektowi. (Odziedziczone po Object)
FindMenuItem(Int32, IntPtr)	Przestarzałe. Pobiera element MenuItem zawierający określoną wartość.
FindMergePosition(Int32)	Przestarzałe. Zwraca pozycję, w której element menu powinien zostać wstawiony do menu.
GetContextMenu()	Przestarzałe. Pobiera element ContextMenu zawierający to menu.
GetHashCode()	Przestarzałe. 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()	Przestarzałe. Pobiera element MainMenu zawierający to menu.
GetService(Type)	Przestarzałe. Zwraca obiekt reprezentujący usługę dostarczaną przez Component obiekt lub przez obiekt Container. (Odziedziczone po Component)
GetType()	Przestarzałe. Pobiera Type 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()	Przestarzałe. Tworzy płytkią kopię bieżącego Object. (Odziedziczone po Object)
MemberwiseClone(Boolean)	Przestarzałe. Tworzy płytkią kopię bieżącego MarshalByRefObject obiektu. (Odziedziczone po MarshalByRefObject)
MergeMenu(Menu)	Przestarzałe. Scala MenuItem obiekty jednego menu z bieżącym menu.
ProcessCmdKey(Message, Keys)	Przestarzałe. Przetwarza klucz polecenia.
ToString()	Przestarzałe. Zwraca kontrolkę String reprezentującą kontrolkę Menu .

Zdarzenia

Nazwa	Opis
Disposed	Przestarzałe. Występuje, gdy składnik jest usuwany przez wywołanie Dispose() metody . (Odziedziczone po Component)

Dotyczy

Zobacz też

Opinia

Czy ta strona była pomocna?