MenuItem Konstruktory

Reference

Definice

Obor názvů:: System.Windows.Forms

Sestavení:: System.Windows.Forms.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Inicializuje novou instanci MenuItem třídy .

Přetížení

MenuItem()	Inicializuje s prázdnou MenuItem popis.
MenuItem(String)	Inicializuje novou instanci MenuItem třídy se zadaným popis pro položku nabídky.
MenuItem(String, EventHandler)	Inicializuje novou instanci třídy se zadaným popis a obslužnou rutinou Click události pro událost položky nabídky.
MenuItem(String, MenuItem[])	Inicializuje novou instanci třídy se zadaným popis a pole podnabídky položky definované pro položku nabídky.
MenuItem(String, EventHandler, Shortcut)	Inicializuje novou instanci třídy se zadaným popis, obslužnou rutinou události a přidruženou klávesovou zkratkou pro položku nabídky.
MenuItem(MenuMerge, Int32, Shortcut, String, EventHandler, EventHandler, EventHandler, MenuItem[])	Inicializuje novou instanci MenuItem třídy se zadaným popis; definované obslužné rutiny událostí pro Clickudálosti a Select Popup ; klávesová zkratka; typ sloučení; a pořadí zadané pro položku nabídky.

MenuItem()

Inicializuje s prázdnou MenuItem popis.

public:
 MenuItem();

public MenuItem ();

Public Sub New ()

Příklady

Následující příklad kódu vytvoří MenuItem pomocí této verze konstruktoru.

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

Poznámky

Jakmile vytvoříte prázdnou hodnotu MenuItem pomocí tohoto konstruktoru, můžete pomocí vlastností a metod MenuItem třídy určit vzhled a chování vašeho MenuItemobjektu .

Platí pro

MenuItem(String)

Inicializuje novou instanci MenuItem třídy se zadaným popis pro položku nabídky.

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

Popis pro položku nabídky.

Příklady

Následující příklad kódu vytvoří MenuItem , který určuje popis položky nabídky v okamžiku, kdy je vytvořena.

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

Poznámky

Pokud zadáte popis pro položku nabídky pomocí parametru text , můžete také zadat přístupový klíč umístěním znaku "&" před znak, který se má použít jako přístupový klíč. Chcete-li například zadat "F" v "Soubor" jako přístupový klíč, zadejte popis pro položku nabídky jako "&Soubor". Tuto funkci můžete použít k poskytování navigace pomocí klávesnice pro vaše nabídky.

Nastavení parametru text na způsobí-, že se položka nabídky zobrazí jako oddělovač (vodorovná čára) místo standardní položky nabídky.

Platí pro

MenuItem(String, EventHandler)

Inicializuje novou instanci třídy se zadaným popis a obslužnou rutinou Click události pro událost položky nabídky.

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

Popis pro položku nabídky.

onClick: EventHandler

Objekt EventHandler , který zpracovává Click událost pro tuto položku nabídky.

Příklady

Následující příklad kódu vytvoří MenuItem objekt se zadaným popis a delegátem EventHandler připojeným k obslužné rutině události, která bude zpracovávat Click událost položky nabídky.

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

Poznámky

Nastavení parametru text na způsobí-, že se položka nabídky zobrazí jako oddělovač (vodorovná čára) místo standardní položky nabídky.

Kromě toho můžete použít tento konstruktor k určení delegáta, který bude zpracovávat Click událost pro vytvářenou položku nabídky. Objekt EventHandler , který předáte tomuto konstruktoru, musí být nakonfigurován tak, aby volal obslužnou rutinu události, která může zpracovat Click událost. Další informace o zpracování událostí najdete v tématu Zpracování a vyvolávání událostí.

Platí pro

MenuItem(String, MenuItem[])

Inicializuje novou instanci třídy se zadaným popis a pole podnabídky položky definované pro položku nabídky.

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

Popis pro položku nabídky.

items: MenuItem[]

Pole MenuItem objektů, které obsahují položky podnabídky pro tuto položku nabídky.

Příklady

Následující příklad kódu vytvoří objekt se zadaným popis, obslužná rutina události připojená k metodě, která bude zpracovávat událost každé položky nabídky v poli podnabídek položek.

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

Poznámky

Nastavení parametru text na způsobí-, že se položka nabídky zobrazí jako oddělovač (vodorovná čára) místo standardní položky nabídky.

Parametr items umožňuje přiřadit pole položek nabídky k definování podnabídky této položky nabídky. Každá položka v poli může mít také přiřazené pole položek nabídky. To umožňuje vytvořit kompletní struktury nabídek a přiřadit je konstruktoru pro položku nabídky.

Další informace o zpracování událostí najdete v tématu Zpracování a vyvolávání událostí.

Platí pro

MenuItem(String, EventHandler, Shortcut)

Inicializuje novou instanci třídy se zadaným popis, obslužnou rutinou události a přidruženou klávesovou zkratkou pro položku nabídky.

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

Popis pro položku nabídky.

onClick: EventHandler

Objekt EventHandler , který zpracovává Click událost pro tuto položku nabídky.

shortcut: Shortcut

Jedna z Shortcut hodnot.

Příklady

Následující příklad kódu vytvoří objekt se zadaným popis, klávesovou zkratkou a obslužnou rutinou události připojenou k metodě, která bude zpracovávat událost položky nabídky.

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

Poznámky

Pokud zadáte popis pro položku nabídky pomocí parametru text , můžete také zadat přístupový klíč umístěním "&" před znak, který se má použít jako přístupový klíč. Chcete-li například zadat "F" v "Soubor" jako přístupový klíč, zadejte popis pro položku nabídky jako "&Soubor". Tuto funkci můžete použít k poskytování navigace pomocí klávesnice pro vaše nabídky. Tento konstruktor také umožňuje kromě přístupové klávesy zadat klávesovou zkratku pro navigaci pomocí klávesnice. Klávesové zkratky umožňují určit kombinaci kláves, které lze použít k aktivaci položky nabídky.

Nastavení parametru text na způsobí-, že se položka nabídky zobrazí jako oddělovač (vodorovná čára) místo standardní položky nabídky.

Platí pro

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

Inicializuje novou instanci MenuItem třídy se zadaným popis; definované obslužné rutiny událostí pro Clickudálosti a Select Popup ; klávesová zkratka; typ sloučení; a pořadí zadané pro položku nabídky.

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 hodnot.

mergeOrder: Int32

Relativní pozice, kterou bude mít tato položka nabídky ve sloučené nabídce.

shortcut: Shortcut

Jedna z Shortcut hodnot.

text: String

Popis pro položku nabídky.

onClick: EventHandler

Objekt EventHandler , který zpracovává Click událost pro tuto položku nabídky.

onPopup: EventHandler

Objekt EventHandler , který zpracovává Popup událost pro tuto položku nabídky.

onSelect: EventHandler

Objekt EventHandler , který zpracovává Select událost pro tuto položku nabídky.

items: MenuItem[]

Pole MenuItem objektů, které obsahují položky podnabídky pro tuto položku nabídky.

Příklady

Následující příklad kódu vytvoří položku nabídky, která má popis a klávesovou zkratku. Položka nabídky má také definované obslužné rutiny událostí pro Popupudálosti , Clicka Select . Pokud je tato položka nabídky sloučena, přidá položku nabídky do nabídky s nulovým pořadím sloučení.

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

Poznámky

Nastavení parametru text na způsobí-, že se položka nabídky zobrazí jako oddělovač (vodorovná čára) místo standardní položky nabídky.

Parametry mergeType a mergeOrder umožňují určit, jak se bude tato položka nabídky chovat, když je položka nabídky sloučena s jinou nabídkou. V závislosti na hodnotě, kterou pro mergeType parametr zadáte, můžete přidat, odebrat, nahradit nebo sloučit položku nabídky a její podnabídky s nabídkou, se kterou se slučuje. Parametr mergeOrder určuje umístění vytvářené položky nabídky při sloučení nabídky.

Kromě toho můžete pomocí tohoto konstruktoru MenuItem vytvořit objekt a nechat ho připojit k obslužné rutině události ve vašem kódu, která zpracuje kliknutí na položku nabídky. Objekt EventHandler , který předáte do tohoto konstruktoru, by měl být nakonfigurován tak, aby volal obslužnou rutinu Click události, která může událost zpracovat. Pomocí této verze konstruktoru Popup můžete také připojit události a Select k určení, kdy je tato položka nabídky vybrána. Tyto události můžete použít pro úlohy, jako je například určení, zda se má zobrazit značka zaškrtnutí vedle podnabídky, nebo povolit nebo zakázat položky nabídky na základě stavu aplikace. Události Select a Click jsou vyvolány pouze pro MenuItem objekty, které nejsou nadřazené položky nabídky. Další informace o zpracování událostí najdete v tématu Zpracování a vyvolávání událostí.

Viz také

Platí pro

Sdílet prostřednictvím

MenuItem Konstruktory

Definice

Přetížení

MenuItem()

Příklady

Poznámky

Platí pro

MenuItem(String)

Parametry

Příklady

Poznámky

Platí pro

MenuItem(String, EventHandler)

Parametry

Příklady

Poznámky

Platí pro

MenuItem(String, MenuItem[])

Parametry

Příklady

Poznámky

Platí pro

MenuItem(String, EventHandler, Shortcut)

Parametry

Příklady

Poznámky

Platí pro

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

Parametry

Příklady

Poznámky

Viz také

Platí pro

Další materiály