MenuItem Konstruktory

Odwołanie

Definicja

Przestrzeń nazw:: System.Windows.Forms

Zestaw:: System.Windows.Forms.dll

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.

Inicjuje nowe wystąpienie klasy MenuItem.

Przeciążenia

MenuItem()	Inicjuje element MenuItem z pustym podpisem.
MenuItem(String)	Inicjuje MenuItem nowe wystąpienie klasy z określonym podpisem elementu menu.
MenuItem(String, EventHandler)	Inicjuje nowe wystąpienie klasy z określonym podpisem i procedurą obsługi zdarzeń dla Click zdarzenia elementu menu.
MenuItem(String, MenuItem[])	Inicjuje nowe wystąpienie klasy z określonym podpisem i tablicą elementów podrzędnych zdefiniowanych dla elementu menu.
MenuItem(String, EventHandler, Shortcut)	Inicjuje nowe wystąpienie klasy z określonym podpisem, procedurą obsługi zdarzeń i skojarzonym klawiszem skrótu dla elementu menu.
MenuItem(MenuMerge, Int32, Shortcut, String, EventHandler, EventHandler, EventHandler, MenuItem[])	Inicjuje nowe wystąpienie MenuItem klasy z określonym podpisem; zdefiniowane programy obsługi zdarzeń dla Clickzdarzeń i Popup , Select klucz skrótu, typ scalania i kolejność określona dla elementu menu.

MenuItem()

Inicjuje element MenuItem z pustym podpisem.

public:
 MenuItem();

public MenuItem ();

Public Sub New ()

Przykłady

Poniższy przykład kodu tworzy MenuItem przy użyciu tej wersji konstruktora.

public:
   void CreateMyMenu()
   {
      // Create an empty menu item object.
      MenuItem^ menuItem1 = gcnew MenuItem;
      // Intialize the menu item using the parameterless version of the constructor.
      // Set the caption of the menu item.
      menuItem1->Text = "&File";
   }

public void CreateMyMenu()
{
   // Create an empty menu item object.
   MenuItem menuItem1 = new MenuItem();
   // Intialize the menu item using the parameterless version of the constructor.
   // Set the caption of the menu item.
   menuItem1.Text = "&File";
}

Public Sub CreateMyMenu()
    ' Create an empty menu item object.
    Dim menuItem1 As New MenuItem()
    ' Intialize the menu item using the parameterless version of the constructor.
    ' Set the caption of the menu item.
    menuItem1.Text = "&File"
End Sub

Uwagi

Po utworzeniu wartości pustej MenuItem przy użyciu tego konstruktora można użyć właściwości i metod MenuItem klasy, aby określić wygląd i zachowanie klasy MenuItem.

Dotyczy

MenuItem(String)

Inicjuje MenuItem nowe wystąpienie klasy z określonym podpisem elementu menu.

public:
 MenuItem(System::String ^ text);

public MenuItem (string text);

new System.Windows.Forms.MenuItem : string -> System.Windows.Forms.MenuItem

Public Sub New (text As String)

Parametry

text: String

Podpis elementu menu.

Przykłady

Poniższy przykład kodu tworzy element MenuItem określający podpis elementu menu w momencie jego konstruowania.

public:
   void CreateMyMenus()
   {
      // Create an instance of a MenuItem with a specified caption.
      menuItem1 = gcnew MenuItem( "&File" );
   }

public void CreateMyMenus()
{
   // Create an instance of a MenuItem with a specified caption.
   menuItem1 = new MenuItem("&File");
}

Public Sub CreateMyMenus()
    ' Create an instance of a MenuItem with a specified caption.
    menuItem1 = New MenuItem("&File")
End Sub

Uwagi

Ustawienie parametru text na "-" powoduje, że element menu będzie wyświetlany jako separator (linia pozioma), a nie standardowy element menu.

Dotyczy

MenuItem(String, EventHandler)

Inicjuje nowe wystąpienie klasy z określonym podpisem i procedurą obsługi zdarzeń dla Click zdarzenia elementu menu.

public:
 MenuItem(System::String ^ text, EventHandler ^ onClick);

public MenuItem (string text, EventHandler onClick);

new System.Windows.Forms.MenuItem : string * EventHandler -> System.Windows.Forms.MenuItem

Public Sub New (text As String, onClick As EventHandler)

Parametry

text: String

Podpis elementu menu.

onClick: EventHandler

Element EventHandler , który obsługuje Click zdarzenie dla tego elementu menu.

Przykłady

Poniższy przykład kodu tworzy MenuItem obiekt z określonym podpisem i EventHandler pełnomocnikiem połączonym z procedurą obsługi zdarzeń, która obsłuży Click zdarzenie dla elementu menu.

public:
   void CreateMyMenuItem()
   {
      // Create an instance of MenuItem with caption and an event handler
      MenuItem^ menuItem1 = gcnew MenuItem( "&New",gcnew System::EventHandler(
         this, &Form1::MenuItem1_Click ) );
   }

private:
   // This method is an event handler for menuItem1 to use when connecting its event handler.
   void MenuItem1_Click( Object^ sender, System::EventArgs^ e )
   {
      // Code goes here that handles the Click event.
   }

public void CreateMyMenuItem()
{
   // Create an instance of MenuItem with caption and an event handler
   MenuItem menuItem1 = new MenuItem("&New", new System.EventHandler(this.MenuItem1_Click));
}

// This method is an event handler for menuItem1 to use when connecting its event handler.
private void MenuItem1_Click(Object sender, System.EventArgs e) 
{
   // Code goes here that handles the Click event.
}

Public Sub CreateMyMenuItem()
    ' Create an instance of MenuItem with caption and an event 
    ' handler
    Dim MenuItem1 As New MenuItem("&New", New _
        System.EventHandler(AddressOf Me.MenuItem1_Click))
End Sub
' This method is an event handler for MenuItem1 to use when 
' connecting its event handler.
Private Sub MenuItem1_Click(ByVal sender As System.Object, ByVal _
    e as System.EventArgs)
    ' Code goes here that handles the Click event.
End Sub

Uwagi

Ustawienie parametru text na "-" powoduje, że element menu będzie wyświetlany jako separator (linia pozioma), a nie standardowy element menu.

Ponadto można użyć tego konstruktora do określenia delegata, który będzie obsługiwać Click zdarzenie dla tworzonego elementu menu. Przekazany EventHandler do tego konstruktora należy skonfigurować tak, aby wywoływać procedurę obsługi zdarzeń Click , która może obsługiwać to zdarzenie. Aby uzyskać więcej informacji na temat obsługi zdarzeń, zobacz Obsługa i podnoszenie zdarzeń.

Dotyczy

MenuItem(String, MenuItem[])

Inicjuje nowe wystąpienie klasy z określonym podpisem i tablicą elementów podrzędnych zdefiniowanych dla elementu menu.

public:
 MenuItem(System::String ^ text, cli::array <System::Windows::Forms::MenuItem ^> ^ items);

public MenuItem (string text, System.Windows.Forms.MenuItem[] items);

new System.Windows.Forms.MenuItem : string * System.Windows.Forms.MenuItem[] -> System.Windows.Forms.MenuItem

Public Sub New (text As String, items As MenuItem())

Parametry

text: String

Podpis elementu menu.

items: MenuItem[]

Tablica MenuItem obiektów zawierających elementy podrzędne dla tego elementu menu.

Przykłady

Poniższy przykład kodu tworzy obiekt z określonym podpisem, program obsługi zdarzeń połączony z metodą, która obsłuży zdarzenie każdego elementu menu w tablicy elementów podrzędnych.

public:
   void CreateMyMenuItem()
   {
      // submenu item array.
      array<MenuItem^>^ subMenus = gcnew array<MenuItem^>(3);
      // Create three menu items to add to the submenu item array.
      MenuItem^ subMenuItem1 = gcnew MenuItem( "Red" );
      MenuItem^ subMenuItem2 = gcnew MenuItem( "Blue" );
      MenuItem^ subMenuItem3 = gcnew MenuItem( "Green" );
      // Add the submenu items to the array.
      subMenus[ 0 ] = subMenuItem1;
      subMenus[ 1 ] = subMenuItem2;
      subMenus[ 2 ] = subMenuItem3;
      // Create an instance of a MenuItem with caption and an array of submenu
      // items specified.
      MenuItem^ MenuItem1 = gcnew MenuItem( "&Colors",subMenus );
   }

public void CreateMyMenuItem()
{
   // submenu item array.
   MenuItem[] subMenus = new MenuItem[3];
   // Create three menu items to add to the submenu item array.
   MenuItem subMenuItem1 = new MenuItem("Red");
   MenuItem subMenuItem2 = new MenuItem("Blue");
   MenuItem subMenuItem3 = new MenuItem("Green");
   // Add the submenu items to the array.
   subMenus[0] = subMenuItem1;
   subMenus[1] = subMenuItem2;
   subMenus[2] = subMenuItem3;
   // Create an instance of a MenuItem with caption and an array of submenu
   // items specified.
   MenuItem MenuItem1 = new MenuItem("&Colors", subMenus);
}

Public Sub CreateMyMenuItem()
    ' submenu item array.
    Dim subMenus(3) As MenuItem
    ' Create three menu items to add to the submenu item array.
    Dim subMenuItem1 As New MenuItem("Red")
    Dim subMenuItem2 As New MenuItem("Blue")
    Dim subMenuItem3 As New MenuItem("Green")
    ' Add the submenu items to the array.
    subMenus(0) = subMenuItem1
    subMenus(1) = subMenuItem2
    subMenus(2) = subMenuItem3
    ' Create an instance of a MenuItem with caption and an array of submenu
    ' items specified.
    Dim MenuItem1 As New MenuItem("&Colors", subMenus)
End Sub

Uwagi

Ustawienie parametru text na "-" powoduje, że element menu będzie wyświetlany jako separator (linia pozioma), a nie standardowy element menu.

Parametr items umożliwia przypisanie tablicy elementów menu w celu zdefiniowania podmenu tego elementu menu. Każdy element w tablicy może również mieć przypisaną tablicę elementów menu. Umożliwia to tworzenie kompletnych struktur menu i przypisywanie ich do konstruktora dla elementu menu.

Aby uzyskać więcej informacji na temat obsługi zdarzeń, zobacz Obsługa i podnoszenie zdarzeń.

Dotyczy

MenuItem(String, EventHandler, Shortcut)

Inicjuje nowe wystąpienie klasy z określonym podpisem, procedurą obsługi zdarzeń i skojarzonym klawiszem skrótu dla elementu menu.

public:
 MenuItem(System::String ^ text, EventHandler ^ onClick, System::Windows::Forms::Shortcut shortcut);

public MenuItem (string text, EventHandler onClick, System.Windows.Forms.Shortcut shortcut);

new System.Windows.Forms.MenuItem : string * EventHandler * System.Windows.Forms.Shortcut -> System.Windows.Forms.MenuItem

Public Sub New (text As String, onClick As EventHandler, shortcut As Shortcut)

Parametry

text: String

Podpis elementu menu.

onClick: EventHandler

Element EventHandler , który obsługuje Click zdarzenie dla tego elementu menu.

shortcut: Shortcut

Jedna z Shortcut wartości.

Przykłady

Poniższy przykład kodu tworzy obiekt z określonym podpisem, kluczem skrótu i procedurą obsługi zdarzeń połączoną z metodą, która obsłuży zdarzenie dla elementu menu.

public:
   void CreateMyMenuItem()
   {
      // Create a MenuItem with caption, shortcut key, and an event handler
      // specified.
      MenuItem^ MenuItem1 = gcnew MenuItem( "&New",
         gcnew System::EventHandler( this, &Form1::MenuItem1_Click ), Shortcut::CtrlL );
   }

private:
   // The following method is an event handler for menuItem1 to use when
   // connecting the event handler.
   void MenuItem1_Click( Object^ sender, EventArgs^ e )
   {
      // Code goes here that handles the Click event.
   }

public void CreateMyMenuItem()
{
   // Create a MenuItem with caption, shortcut key, and an event handler
   // specified.
   MenuItem MenuItem1 = new MenuItem("&New",
       new System.EventHandler(this.MenuItem1_Click), Shortcut.CtrlL);
}

// The following method is an event handler for menuItem1 to use when
// connecting the event handler.
private void MenuItem1_Click(Object sender, EventArgs e)
{
   // Code goes here that handles the Click event.
}

Public Sub CreateMyMenuItem()
    ' Create a MenuItem with caption, shortcut key, and an event handler
    ' specified.
    Dim MenuItem1 As New MenuItem("&New", _
       New System.EventHandler(AddressOf Me.MenuItem1_Click), Shortcut.CtrlL)
End Sub    
   
' The following method is an event handler for menuItem1 to use when
' connecting the event handler.
Private Sub MenuItem1_Click(sender As Object, e As EventArgs)
    ' Code goes here that handles the Click event.
End Sub

Uwagi

Po określeniu podpisu elementu menu za pomocą parametru text można również określić klucz dostępu, umieszczając znak "&" przed znakiem, który ma być używany jako klucz dostępu. Aby na przykład określić wartość "F" w polu "Plik" jako klucz dostępu, należy określić podpis elementu menu jako "&Plik". Możesz użyć tej funkcji, aby zapewnić nawigację za pomocą klawiatury dla menu. Ten konstruktor umożliwia również określenie klawisza skrótu oprócz klucza dostępu w celu zapewnienia nawigacji za pomocą klawiatury. Klawisze skrótów umożliwiają określenie kombinacji kluczy, których można użyć do aktywowania elementu menu.

Ustawienie parametru text na "-" powoduje, że element menu będzie wyświetlany jako separator (linia pozioma), a nie standardowy element menu.

Dotyczy

MenuItem(MenuMerge, Int32, Shortcut, String, EventHandler, EventHandler, EventHandler, MenuItem[])

Inicjuje nowe wystąpienie MenuItem klasy z określonym podpisem; zdefiniowane programy obsługi zdarzeń dla Clickzdarzeń i Popup , Select klucz skrótu, typ scalania i kolejność określona dla elementu menu.

public:
 MenuItem(System::Windows::Forms::MenuMerge mergeType, int mergeOrder, System::Windows::Forms::Shortcut shortcut, System::String ^ text, EventHandler ^ onClick, EventHandler ^ onPopup, EventHandler ^ onSelect, cli::array <System::Windows::Forms::MenuItem ^> ^ items);

public MenuItem (System.Windows.Forms.MenuMerge mergeType, int mergeOrder, System.Windows.Forms.Shortcut shortcut, string text, EventHandler onClick, EventHandler onPopup, EventHandler onSelect, System.Windows.Forms.MenuItem[] items);

new System.Windows.Forms.MenuItem : System.Windows.Forms.MenuMerge * int * System.Windows.Forms.Shortcut * string * EventHandler * EventHandler * EventHandler * System.Windows.Forms.MenuItem[] -> System.Windows.Forms.MenuItem

Public Sub New (mergeType As MenuMerge, mergeOrder As Integer, shortcut As Shortcut, text As String, onClick As EventHandler, onPopup As EventHandler, onSelect As EventHandler, items As MenuItem())

Parametry

mergeType: MenuMerge

Jedna z MenuMerge wartości.

mergeOrder: Int32

Pozycja względna, którą ten element menu zostanie umieszczony w menu scalanym.

shortcut: Shortcut

Jedna z Shortcut wartości.

text: String

Podpis elementu menu.

onClick: EventHandler

Element EventHandler , który obsługuje Click zdarzenie dla tego elementu menu.

onPopup: EventHandler

Element EventHandler , który obsługuje Popup zdarzenie dla tego elementu menu.

onSelect: EventHandler

Element EventHandler , który obsługuje Select zdarzenie dla tego elementu menu.

items: MenuItem[]

Tablica MenuItem obiektów zawierających elementy podrzędne dla tego elementu menu.

Przykłady

Poniższy przykład kodu tworzy element menu z podpisem i klawiszem skrótu. Element menu zawiera również programy obsługi zdarzeń zdefiniowane dla Popupzdarzeń , Clicki Select zdarzeń. Jeśli ten element menu zostanie scalony, doda element menu do menu z kolejnością scalania zero.

public:
   void CreateMyMenuItem()
   {
      // Submenu item array.
      array<MenuItem^>^ subMenus = gcnew array<MenuItem^>(3);
      // Create three menu items to add to the submenu item array.
      MenuItem^ subMenuItem1 = gcnew MenuItem( "Red" );
      MenuItem^ subMenuItem2 = gcnew MenuItem( "Blue" );
      MenuItem^ subMenuItem3 = gcnew MenuItem( "Green" );
      
      // Add the submenu items to the array.
      subMenus[ 0 ] = subMenuItem1;
      subMenus[ 1 ] = subMenuItem2;
      subMenus[ 2 ] = subMenuItem3;
      /* Create a MenuItem with caption, shortcut key, 
         a Click, Popup, and Select event handler, merge type and order, and an 
         array of submenu items specified.
      */
      MenuItem^ menuItem1 = gcnew MenuItem( MenuMerge::Add, 0,
         Shortcut::CtrlShiftC, "&Colors",
         gcnew EventHandler( this, &Form1::MenuItem1_Click ),
         gcnew EventHandler( this, &Form1::MenuItem1_Popup ),
         gcnew EventHandler( this, &Form1::MenuItem1_Select ), subMenus );
   }

private:
   // The following method is an event handler for menuItem1 to use when connecting the Click event.
   void MenuItem1_Click( Object^ sender, EventArgs^ e )
   {
      // Code goes here that handles the Click event.
   }

   // The following method is an event handler for menuItem1 to use  when connecting the Popup event.
   void MenuItem1_Popup( Object^ sender, EventArgs^ e )
   {
      // Code goes here that handles the Click event.
   }

   // The following method is an event handler for menuItem1 to use  when connecting the Select event
   void MenuItem1_Select( Object^ sender, EventArgs^ e )
   {
      // Code goes here that handles the Click event.
   }

public void CreateMyMenuItem()
{
   // Submenu item array.
   MenuItem[] subMenus = new MenuItem[3];
   // Create three menu items to add to the submenu item array.
   MenuItem subMenuItem1 = new MenuItem("Red");
   MenuItem subMenuItem2 = new MenuItem("Blue");
   MenuItem subMenuItem3 = new MenuItem("Green");

   // Add the submenu items to the array.
   subMenus[0] = subMenuItem1;
   subMenus[1] = subMenuItem2;
   subMenus[2] = subMenuItem3;
   /* Create a MenuItem with caption, shortcut key, 
      a Click, Popup, and Select event handler, merge type and order, and an 
      array of submenu items specified.
   */
   MenuItem menuItem1 = new MenuItem(MenuMerge.Add, 0,
      Shortcut.CtrlShiftC, "&Colors", 
      new EventHandler(this.MenuItem1_Click),
      new EventHandler(this.MenuItem1_Popup),
      new EventHandler(this.MenuItem1_Select), subMenus);
}

// The following method is an event handler for menuItem1 to use when connecting the Click event.
private void MenuItem1_Click(Object sender, EventArgs e)
{
   // Code goes here that handles the Click event.
}

// The following method is an event handler for menuItem1 to use  when connecting the Popup event.
private void MenuItem1_Popup(Object sender, EventArgs e)
{
   // Code goes here that handles the Click event.
}

// The following method is an event handler for menuItem1 to use  when connecting the Select event
private void MenuItem1_Select(Object sender, EventArgs e)
{
   // Code goes here that handles the Click event.
}

Public Sub CreateMyMenuItem()
   ' Submenu item array.
   Dim SubMenus(3) as MenuItem
   ' Create three menu items to add to the submenu item array.
   Dim SubMenuItem1, SubMenuItem2, SubMenuItem3 as MenuItem
   SubMenuItem1 = New MenuItem ("Red")
   SubMenuItem2 = New MenuItem ("Blue")
   SubMenuItem3 = New MenuItem ("Green")
   ' Add the submenu items to the array.
   SubMenus(0) = SubMenuItem1
   SubMenus(1) = SubMenuItem2
   SubMenus(2) = SubMenuItem3
   ' Create a MenuItem with caption, shortcut key, 
   ' a Click, Popup, and Select event handler, menu merge type and order, and an 
   ' array of submenu items specified.
   Dim MenuItem1 As MenuItem
   MenuItem1 = New MenuItem(MenuMerge.Add, 0, Shortcut.CtrlShiftC, "&Colors", _
      AddressOf Me.MenuItem1_Click, _
      AddressOf Me.MenuItem1_Popup, _
      AddressOf Me.MenuItem1_Select, SubMenus)
End Sub

' The following method is an event handler for MenuItem1 to use  when connecting the Click event.
Private Sub MenuItem1_Click(ByVal sender As System.Object, ByVal  e as System.EventArgs)
   ' Code goes here that handles the Click event.
End Sub

' The following method is an event handler for MenuItem1 to use  when connecting the Popup event.
Private Sub MenuItem1_Popup(ByVal sender As System.Object, ByVal  e as System.EventArgs)
   ' Code goes here that handles the Click event.
End Sub

' The following method is an event handler for MenuItem1 to use  when connecting the Select event
Private Sub MenuItem1_Select(ByVal sender As System.Object, ByVal  e as System.EventArgs)
   ' Code goes here that handles the Click event.
End Sub

Uwagi

Ustawienie parametru text na "-" powoduje, że element menu będzie wyświetlany jako separator (linia pozioma), a nie standardowy element menu.

Parametry mergeType i mergeOrder umożliwiają określenie, w jaki sposób ten element menu będzie zachowywał się, gdy element menu jest scalony z innym menu. W zależności od wartości określonej dla parametru mergeType można dodawać, usuwać, zastępować lub scalać element menu i jego elementy podrzędne z menu, z którym jest scalane. Parametr mergeOrder określa lokalizację tworzonego elementu menu po scaleniu menu.

Ponadto możesz użyć tego konstruktora do utworzenia MenuItem obiektu i połączenia go z procedurą obsługi zdarzeń w kodzie, który przetworzy kliknięcie elementu menu. Element EventHandler przekazywany do tego konstruktora powinien być skonfigurowany do wywoływania procedury obsługi zdarzeń, która może obsługiwać Click to zdarzenie. Korzystając z tej wersji konstruktora, można również połączyć zdarzenia Popup i Select w celu określenia, kiedy ten element menu jest zaznaczony. Możesz użyć tych zdarzeń do zadań, takich jak określenie, czy obok elementów podrzędnych ma być wyświetlany znacznik wyboru, czy też włączyć lub wyłączyć elementy menu na podstawie stanu aplikacji. Zdarzenia Select i Click są wywoływane tylko dla MenuItem obiektów, które nie są elementami menu nadrzędnego. Aby uzyskać więcej informacji na temat obsługi zdarzeń, zobacz Obsługa i podnoszenie zdarzeń.

Zobacz też

Dotyczy