MenuItem Konstruktory

Definicja

Przestrzeń nazw:

System.Windows.Forms

Zestaw:

System.Windows.Forms.dll

Inicjuje nowe wystąpienie klasy MenuItem.

Przeciążenia

MenuItem()	Inicjuje element MenuItem z pustym podpis.
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, MenuItem[])	Inicjuje nowe wystąpienie klasy z określonym podpis i tablicą elementów podrzędnych zdefiniowanych dla 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(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()

Inicjuje element MenuItem z pustym podpis.

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 pustego MenuItem przy użyciu tego konstruktora możesz użyć właściwości i metod MenuItem klasy, aby określić wygląd i zachowanie klasy MenuItem.

MenuItem(String)

Inicjuje MenuItem nowe wystąpienie klasy z określonym podpis dla 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 obiekt 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

Po określeniu podpis dla 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ć "F" w pliku "Plik" jako klucz dostępu, należy określić podpis dla elementu menu jako "plik &". Możesz użyć tej funkcji, aby zapewnić nawigację za pomocą klawiatury dla menu.

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

MenuItem(String, EventHandler)

Inicjuje nowe wystąpienie klasy z określonym podpis 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 podpis i EventHandler delegatem połączonym z procedurą obsługi zdarzeń, która będzie obsługiwać 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

Po określeniu podpis dla elementu menu za pomocą parametru text można również określić klucz dostępu, umieszczając znak "&" przed użyciem znaku jako klucza dostępu. Aby na przykład określić "F" w pliku "Plik" jako klucz dostępu, należy określić podpis dla elementu menu jako "plik &". Możesz użyć tej funkcji, aby zapewnić nawigację za pomocą klawiatury dla menu.

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. Element EventHandler przekazywany do tego konstruktora musi być skonfigurowany do wywoływania procedury obsługi zdarzeń, która może obsłużyć Click zdarzenie. Aby uzyskać więcej informacji na temat obsługi zdarzeń, zobacz Obsługa i podnoszenie zdarzeń.

MenuItem(String, MenuItem[])

Inicjuje nowe wystąpienie klasy z określonym podpis 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, która zawiera elementy podrzędne dla tego elementu menu.

Przykłady

Poniższy przykład kodu tworzy obiekt z określonym podpis, program obsługi zdarzeń połączony z metodą, która będzie obsługiwać 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

Po określeniu podpis dla elementu menu za pomocą parametru text można również określić klucz dostępu, umieszczając znak "&" przed użyciem znaku jako klucza dostępu. Aby na przykład określić "F" w pliku "Plik" jako klucz dostępu, należy określić podpis dla elementu menu jako "plik &". Możesz użyć tej funkcji, aby zapewnić nawigację za pomocą klawiatury dla menu.

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. Dzięki temu można tworzyć kompletne struktury menu i przypisywać je do konstruktora dla elementu menu.

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

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.

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

Shortcut Jedna z wartości.

Przykłady

Poniższy przykład kodu tworzy obiekt z określonym podpis, klawiszem skrótu i procedurą obsługi zdarzeń połączoną z metodą, która będzie obsługiwać 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 podpis dla elementu menu za pomocą parametru text można również określić klucz dostępu, umieszczając znak "&" przed użyciem znaku jako klucza dostępu. Aby na przykład określić "F" w pliku "Plik" jako klucz dostępu, należy określić podpis dla 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 klawisza dostępu w celu zapewnienia nawigacji za pomocą klawiatury. Klawisze skrótów umożliwiają określenie kombinacji klawiszy, 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.

Ponadto można użyć tego konstruktora do określenia delegata, który będzie obsługiwać Click zdarzenie dla tworzonego elementu menu. Element EventHandler przekazywany do tego konstruktora musi być skonfigurowany do wywoływania procedury obsługi zdarzeń, która może obsłużyć Click zdarzenie. Aby uzyskać więcej informacji na temat obsługi zdarzeń, zobacz Obsługa i podnoszenie zdarzeń.

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.

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

MenuMerge Jedna z wartości.

mergeOrder

Int32

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

shortcut

Shortcut

Shortcut Jedna z 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, która zawiera elementy podrzędne dla tego elementu menu.

Przykłady

Poniższy przykład kodu tworzy element menu, który ma podpis i klawisz skrótu. Element menu zawiera również programy obsługi zdarzeń zdefiniowane dla zdarzeń Popup, Clicki Select . Jeśli ten element menu zostanie scalony, doda element menu do menu z kolejnością scalania zerem.

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

Po określeniu podpis dla elementu menu za pomocą parametru text można również określić klucz dostępu, umieszczając znak "&" przed użyciem znaku jako klucza dostępu. Aby na przykład określić "F" w pliku "Plik" jako klucz dostępu, należy określić podpis dla elementu menu jako "plik &". Możesz użyć tej funkcji, aby zapewnić nawigację za pomocą klawiatury dla menu.

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. Dzięki temu można tworzyć kompletne struktury menu i przypisywać je do konstruktora dla elementu menu.

Parametry mergeType i mergeOrder umożliwiają określenie, jak ten element menu będzie zachowywał się po scaleniu elementu menu z innym menu. W zależności od wartości określonej dla parametru mergeType można dodać, usunąć, zastąpić lub scalić 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żna 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łużyć Click 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. Tych zdarzeń można używać do zadań, takich jak określanie, czy obok elementów podmenu 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ż

• Popup
• Select
• Click
• MergeType
• MergeOrder