MenuItem Konstruktoren

  • Referenz

Definition

Namespace:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

Initialisiert eine neue Instanz der MenuItem-Klasse.

Überlädt

MenuItem()

Initialisiert ein MenuItem mit leerer Beschriftung.
MenuItem(String)

Initialisiert eine neue Instanz der MenuItem-Klasse mit einer angegebenen Beschriftung für das Menüelement.
MenuItem(String, EventHandler)

Initialisiert eine neue Instanz der Klasse mit einer angegebenen Beschriftung und einem Ereignishandler für das Click-Ereignis des Menüelements.
MenuItem(String, MenuItem[])

Initialisiert eine neue Instanz der Klasse mit einer angegebenen Beschriftung und einem Array von Untermenüelementen, die für das Menüelement definiert wurden.
MenuItem(String, EventHandler, Shortcut)

Initialisiert eine neue Instanz der Klasse mit einer angegebenen Beschriftung, einem Ereignishandler und einer zugeordneten Tastenkombination für das Menüelement.
MenuItem(MenuMerge, Int32, Shortcut, String, EventHandler, EventHandler, EventHandler, MenuItem[])

Initialisiert eine neue Instanz der MenuItem-Klasse mit einer angegebenen Beschriftung, definierten Ereignishandlern für die Ereignisse Click, Select und Popup, einer Tastenkombination, einem Zusammenführungstyp und einer Zusammenführungsfolge, die für das Menüelement angegeben sind.

MenuItem()

Initialisiert ein MenuItem mit leerer Beschriftung.

public:
 MenuItem();
public MenuItem ();
Public Sub New ()

Beispiele

Im folgenden Codebeispiel wird eine MenuItem mit dieser Version des Konstruktors erstellt.

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

Hinweise

Nachdem Sie mithilfe dieses Konstruktors ein Leeres MenuItem erstellt haben, können Sie die Eigenschaften und Methoden der MenuItem -Klasse verwenden, um die Darstellung und das Verhalten Ihrer MenuItemanzugeben.

Gilt für:

MenuItem(String)

Initialisiert eine neue Instanz der MenuItem-Klasse mit einer angegebenen Beschriftung für das Menüelement.

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)

Parameter

text
String

Die Beschriftung für das Menüelement.

Beispiele

Im folgenden Codebeispiel wird ein MenuItem erstellt, das die Untertitel des Menüelements zum Zeitpunkt der Erstellung angibt.

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

Hinweise

Wenn Sie einen Untertitel für Ihr Menüelement mit dem text Parameter angeben, können Sie auch einen Zugriffsschlüssel angeben, indem Sie ein "&"-Zeichen vor dem Zeichen platzieren, das als Zugriffsschlüssel verwendet werden soll. Wenn Sie beispielsweise "F" in "Datei" als Zugriffsschlüssel angeben möchten, geben Sie den Untertitel für das Menüelement als "&Datei" an. Sie können dieses Feature verwenden, um die Tastaturnavigation für Ihre Menüs bereitzustellen.

Wenn Sie den text Parameter auf "-" festlegen, wird Ihr Menüelement nicht als Standardmenüelement, sondern als Trennzeichen (horizontale Linie) angezeigt.

Gilt für:

MenuItem(String, EventHandler)

Initialisiert eine neue Instanz der Klasse mit einer angegebenen Beschriftung und einem Ereignishandler für das Click-Ereignis des Menüelements.

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)

Parameter

text
String

Die Beschriftung für das Menüelement.

onClick
EventHandler

Der EventHandler, der das Click-Ereignis für dieses Menüelement behandelt.

Beispiele

Im folgenden Codebeispiel wird ein MenuItem -Objekt mit einem angegebenen Untertitel und einem EventHandler Delegaten erstellt, der mit einem Ereignishandler verbunden ist, der das Click Ereignis für das Menüelement verarbeitet.

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

Hinweise

Wenn Sie einen Untertitel für Ihr Menüelement mit dem text Parameter angeben, können Sie auch einen Zugriffsschlüssel angeben, indem Sie ein "&" vor dem Zeichen platzieren, das als Zugriffsschlüssel verwendet werden soll. Wenn Sie beispielsweise "F" in "Datei" als Zugriffsschlüssel angeben möchten, geben Sie den Untertitel für das Menüelement als "&Datei" an. Sie können dieses Feature verwenden, um die Tastaturnavigation für Ihre Menüs bereitzustellen.

Wenn Sie den text Parameter auf "-" festlegen, wird Ihr Menüelement nicht als Standardmenüelement, sondern als Trennzeichen (horizontale Linie) angezeigt.

Darüber hinaus können Sie diesen Konstruktor verwenden, um einen Delegaten anzugeben, der das Click Ereignis für das zu erstellende Menüelement behandelt. Der EventHandler , den Sie an diesen Konstruktor übergeben, muss konfiguriert sein, um einen Ereignishandler aufzurufen, der das Click Ereignis behandeln kann. Weitere Informationen zum Behandeln von Ereignissen finden Sie unter Behandeln und Auslösen von Ereignissen.

Gilt für:

MenuItem(String, MenuItem[])

Initialisiert eine neue Instanz der Klasse mit einer angegebenen Beschriftung und einem Array von Untermenüelementen, die für das Menüelement definiert wurden.

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

Parameter

text
String

Die Beschriftung für das Menüelement.

items
MenuItem[]

Ein Array von MenuItem-Objekten, das die Untermenüelemente für dieses Menüelement enthält.

Beispiele

Im folgenden Codebeispiel wird ein Objekt mit einem angegebenen Untertitel erstellt, ein Ereignishandler, der mit einer Methode verbunden ist, die das Ereignis jedes Menüelement in einem Array von Untermenüelementen behandelt.

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

Hinweise

Wenn Sie einen Untertitel für Ihr Menüelement mit dem text Parameter angeben, können Sie auch einen Zugriffsschlüssel angeben, indem Sie ein "&" vor dem Zeichen platzieren, das als Zugriffsschlüssel verwendet werden soll. Wenn Sie beispielsweise "F" in "Datei" als Zugriffsschlüssel angeben möchten, geben Sie den Untertitel für das Menüelement als "&Datei" an. Sie können dieses Feature verwenden, um die Tastaturnavigation für Ihre Menüs bereitzustellen.

Wenn Sie den text Parameter auf "-" festlegen, wird Ihr Menüelement nicht als Standardmenüelement, sondern als Trennzeichen (horizontale Linie) angezeigt.

Mit items dem Parameter können Sie ein Array von Menüelementen zuweisen, um ein Untermenü dieses Menüelements zu definieren. Jedem Element im Array kann auch ein Array von Menüelementen zugewiesen sein. Dadurch können Sie vollständige Menüstrukturen erstellen und sie dem Konstruktor für das Menüelement zuweisen.

Weitere Informationen zum Behandeln von Ereignissen finden Sie unter Behandeln und Auslösen von Ereignissen.

Gilt für:

MenuItem(String, EventHandler, Shortcut)

Initialisiert eine neue Instanz der Klasse mit einer angegebenen Beschriftung, einem Ereignishandler und einer zugeordneten Tastenkombination für das Menüelement.

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)

Parameter

text
String

Die Beschriftung für das Menüelement.

onClick
EventHandler

Der EventHandler, der das Click-Ereignis für dieses Menüelement behandelt.

shortcut
Shortcut

Einer der Shortcut-Werte.

Beispiele

Im folgenden Codebeispiel wird ein -Objekt mit einem angegebenen Untertitel, der Tastenkombination und einem Ereignishandler erstellt, der mit einer Methode verbunden ist, die das Ereignis für das Menüelement verarbeitet.

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

Hinweise

Wenn Sie einen Untertitel für Ihr Menüelement mit dem text Parameter angeben, können Sie auch einen Zugriffsschlüssel angeben, indem Sie ein "&" vor dem Zeichen platzieren, das als Zugriffsschlüssel verwendet werden soll. Wenn Sie beispielsweise "F" in "Datei" als Zugriffsschlüssel angeben möchten, geben Sie den Untertitel für das Menüelement als "&Datei" an. Sie können dieses Feature verwenden, um die Tastaturnavigation für Ihre Menüs bereitzustellen. Mit diesem Konstruktor können Sie zusätzlich zu einer Zugriffstaste eine Tastenkombination angeben, um die Tastaturnavigation bereitzustellen. Mit Tastenkombinationen können Sie eine Tastenkombination angeben, die zum Aktivieren des Menüelements verwendet werden kann.

Wenn Sie den text Parameter auf "-" festlegen, wird Ihr Menüelement nicht als Standardmenüelement, sondern als Trennzeichen (horizontale Linie) angezeigt.

Darüber hinaus können Sie diesen Konstruktor verwenden, um einen Delegaten anzugeben, der das Click Ereignis für das zu erstellende Menüelement behandelt. Der EventHandler , den Sie an diesen Konstruktor übergeben, muss konfiguriert sein, um einen Ereignishandler aufzurufen, der das Click Ereignis behandeln kann. Weitere Informationen zum Behandeln von Ereignissen finden Sie unter Behandeln und Auslösen von Ereignissen.

Gilt für:

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

Initialisiert eine neue Instanz der MenuItem-Klasse mit einer angegebenen Beschriftung, definierten Ereignishandlern für die Ereignisse Click, Select und Popup, einer Tastenkombination, einem Zusammenführungstyp und einer Zusammenführungsfolge, die für das Menüelement angegeben sind.

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

Parameter

mergeType
MenuMerge

Einer der MenuMerge-Werte.

mergeOrder
Int32

Die relative Position, die dieses Menüelement in einem zusammengeführten Menü einnimmt.

shortcut
Shortcut

Einer der Shortcut-Werte.

text
String

Die Beschriftung für das Menüelement.

onClick
EventHandler

Der EventHandler, der das Click-Ereignis für dieses Menüelement behandelt.

onPopup
EventHandler

Der EventHandler, der das Popup-Ereignis für dieses Menüelement behandelt.

onSelect
EventHandler

Der EventHandler, der das Select-Ereignis für dieses Menüelement behandelt.

items
MenuItem[]

Ein Array von MenuItem-Objekten, das die Untermenüelemente für dieses Menüelement enthält.

Beispiele

Im folgenden Codebeispiel wird ein Menüelement erstellt, das über eine Untertitel- und Tastenkombination verfügt. Das Menüelement enthält auch Ereignishandler, die für die PopupEreignisse , Clickund Select definiert sind. Wenn dieses Menüelement zusammengeführt wird, wird das Menüelement dem Menü mit der Mergereihenfolge 0 hinzugefügt.

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

Hinweise

Wenn Sie einen Untertitel für Ihr Menüelement mit dem text Parameter angeben, können Sie auch einen Zugriffsschlüssel angeben, indem Sie ein "&" vor dem Zeichen platzieren, das als Zugriffsschlüssel verwendet werden soll. Wenn Sie beispielsweise "F" in "Datei" als Zugriffsschlüssel angeben möchten, geben Sie den Untertitel für das Menüelement als "&Datei" an. Sie können dieses Feature verwenden, um die Tastaturnavigation für Ihre Menüs bereitzustellen.

Wenn Sie den text Parameter auf "-" festlegen, wird Ihr Menüelement nicht als Standardmenüelement, sondern als Trennzeichen (horizontale Linie) angezeigt.

Mit items dem Parameter können Sie ein Array von Menüelementen zuweisen, um ein Untermenü dieses Menüelements zu definieren. Jedem Element im Array kann auch ein Array von Menüelementen zugewiesen sein. Dadurch können Sie vollständige Menüstrukturen erstellen und sie dem Konstruktor für das Menüelement zuweisen.

Mit mergeType den Parametern und mergeOrder können Sie bestimmen, wie sich dieses Menüelement verhält, wenn das Menüelement mit einem anderen Menü zusammengeführt wird. Abhängig vom Wert, den Sie für den mergeType Parameter angeben, können Sie das Menüelement und die zugehörigen Untermenüelemente mit dem Menü, mit dem es zusammengeführt wird, entweder hinzufügen, entfernen, ersetzen oder zusammenführen. Der mergeOrder Parameter bestimmt, wo das zu erstellende Menüelement positioniert wird, wenn das Menü zusammengeführt wird.

Darüber hinaus können Sie diesen Konstruktor verwenden, um einen MenuItem zu erstellen und ihn mit einem Ereignishandler in Ihrem Code zu verbinden, der das Klicken des Menüelements verarbeitet. Die EventHandler , die Sie an diesen Konstruktor übergeben, sollte so konfiguriert werden, dass ein Ereignishandler aufgerufen wird, der das Click Ereignis behandeln kann. Mit dieser Konstruktorversion können Sie auch die Popup Ereignisse und Select verbinden, um zu bestimmen, wann dieses Menüelement ausgewählt ist. Sie können diese Ereignisse für Aufgaben verwenden, z. B. zum Bestimmen, ob neben Untermenüelementen ein Häkchen angezeigt werden soll, oder um Menüelemente basierend auf dem Status der Anwendung zu aktivieren oder zu deaktivieren. Die Select Ereignisse und Click werden nur für MenuItem Objekte ausgelöst, die keine übergeordneten Menüelemente sind. Weitere Informationen zum Behandeln von Ereignissen finden Sie unter Behandeln und Auslösen von Ereignissen.

Weitere Informationen

Gilt für: