Menu Klasa

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Windows.Forms
Zestaw:
System.Windows.Forms.dll

Reprezentuje podstawową funkcjonalność wszystkich menu.

Ta klasa nie jest dostępna na platformie .NET Core 3.1 i nowszych wersjach. Użyj poleceń ToolStripDropDown 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)>]
type Menu = class
    inherit Component
Public MustInherit Class Menu
Inherits Component
Dziedziczenie
Object
MarshalByRefObject
Component
Menu
Pochodne
Atrybuty
ListBindableAttribute

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 wymagany jest MainMenu obiekt o nazwie i cztery MenuItem obiekty o nazwie mainMenu1 menuItem1, 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. Użyj poleceń 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, ContextMenu który służy do wyświetlania menu skrótów. Ta klasa udostępnia funkcje wspólne dla wszystkich klas menu.

W przeciwieństwie do wielu klas bazowych klasa Menu używa jej 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 MenuItemMenuItems właściwość reprezentuje skojarzone z nią 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.

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

Menu(MenuItem[])

Inicjuje nowe wystąpienie klasy Menu.

Pola

FindHandle

Określa, że FindMenuItem(Int32, IntPtr) metoda powinna wyszukać uchwyt.
FindShortcut

Określa, że FindMenuItem(Int32, IntPtr) metoda powinna wyszukać skrót.

Właściwości

CanRaiseEvents

Pobiera wartość wskazującą, czy składnik może zgłosić zdarzenie.

(Odziedziczone po Component)
Container

Pobiera element IContainer zawierający element Component.

(Odziedziczone po Component)
DesignMode

Pobiera wartość wskazującą, czy Component element jest obecnie w trybie projektowania.

(Odziedziczone po Component)
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.
IsParent

Pobiera wartość wskazującą, czy to menu zawiera jakiekolwiek elementy menu. Ta właściwość jest tylko do odczytu.
MdiListItem

Pobiera wartość wskazującą MenuItem , która jest używana do wyświetlania listy formularzy podrzędnych interfejsu wielu dokumentów (MDI).
MenuItems

Pobiera wartość wskazującą kolekcję obiektów skojarzonych MenuItem z menu.
Name

Pobiera lub ustawia nazwę elementu Menu.
Site

Pobiera lub ustawia ISite element .Component

(Odziedziczone po Component)
Tag

Pobiera lub ustawia dane zdefiniowane przez użytkownika skojarzone z kontrolką.

Metody

CloneMenu(Menu)

Kopiuje Menu element przekazywany jako parametr do bieżącego Menuelementu .
CreateMenuHandle()

Tworzy nowy dojście do elementu 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 element Menu.
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ść.
FindMergePosition(Int32)

Zwraca pozycję, w której element menu powinien zostać wstawiony do menu.
GetContextMenu()

Pobiera element ContextMenu zawierający to menu.
GetHashCode()

Służy jako domyślna funkcja skrótu.

(Odziedziczone po Object)
GetLifetimeService()
Nieaktualne.

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.
GetService(Type)

Zwraca obiekt reprezentujący usługę dostarczaną przez Component obiekt lub przez obiekt Container.

(Odziedziczone po Component)
GetType()

Type Pobiera wartość bieżącego wystąpienia.

(Odziedziczone po Object)
InitializeLifetimeService()
Nieaktualne.

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(Menu)

Scala MenuItem obiekty jednego menu z bieżącym menu.
ProcessCmdKey(Message, Keys)

Przetwarza klucz polecenia.
ToString()

Zwraca kontrolkę reprezentującą String kontrolkę Menu .

Zdarzenia

Disposed

Występuje, gdy składnik jest usuwany przez wywołanie Dispose() metody .

(Odziedziczone po Component)

Dotyczy

Zobacz też