MenuItem.PerformClick Methode

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Generiert ein Click-Ereignis für MenuItem, wobei ein Mausklick durch einen Benutzer simuliert wird.

public:
 void PerformClick();

public void PerformClick ();

member this.PerformClick : unit -> unit

Public Sub PerformClick ()

Beispiele

In diesem Beispiel klicken Sie programmgesteuert mit der PerformClick -Methode auf ein Menüelement. Zuerst erstellen Sie ein Standard Menü (mainMenu1) und fügen diesem zwei Menüelemente hinzu, menuItem1 (File) und menuItem2 (Edit). Sie verwenden das Click -Ereignis auch zum Senden von Daten an den Ereignishandler, wenn auf ein Menüelement geklickt wird. Anschließend klicken Sie mit der PerformClick -Methode auf das File Menüelement. Wenn Sie die Anwendung starten, wird das File Menüelement aktiviert, und auf dem Bildschirm wird ein Meldungsfeld mit dem Text "Das Menü Datei wird geklickt" angezeigt. Das Beispiel erfordert, dass Sie einen Form mit dem Namen Form1erstellt haben.

public:
   void CreateMyMenu()
   {
      // Create a main menu object.
      MainMenu^ mainMenu1 = gcnew MainMenu;

      // Create empty menu item objects.
      MenuItem^ menuItem1 = gcnew MenuItem;
      MenuItem^ menuItem2 = gcnew MenuItem;

      // Set the caption of the menu items.
      menuItem1->Text = "&File";
      menuItem2->Text = "&Edit";

      // Add the menu items to the main menu.
      mainMenu1->MenuItems->Add( menuItem1 );
      mainMenu1->MenuItems->Add( menuItem2 );

      // Add functionality to the menu items.
      menuItem1->Click += gcnew System::EventHandler( this, &Form1::menuItem1_Click );
      menuItem2->Click += gcnew System::EventHandler( this, &Form1::menuItem2_Click );

      // Assign mainMenu1 to the form.
      this->Menu = mainMenu1;

      // Perform a click on the File menu item.
      menuItem1->PerformClick();
   }

private:
   void menuItem1_Click( Object^ /*sender*/, System::EventArgs^ /*e*/ )
   {
      MessageBox::Show( "You clicked the File menu.", "The Event Information" );
   }

   void menuItem2_Click( Object^ /*sender*/, System::EventArgs^ /*e*/ )
   {
      MessageBox::Show( "You clicked the Edit menu.", "The Event Information" );
   }

public void CreateMyMenu()
{
    // Create a main menu object.
    MainMenu mainMenu1 = new MainMenu();

    // Create empty menu item objects.
    MenuItem menuItem1 = new MenuItem();
    MenuItem menuItem2 = new MenuItem();

    // Set the caption of the menu items.
    menuItem1.Text = "&File";
    menuItem2.Text = "&Edit";

    // Add the menu items to the main menu.
    mainMenu1.MenuItems.Add(menuItem1);
    mainMenu1.MenuItems.Add(menuItem2);
    
    // Add functionality to the menu items. 
    menuItem1.Click += new System.EventHandler(this.menuItem1_Click);
    menuItem2.Click += new System.EventHandler(this.menuItem2_Click);
    
    // Assign mainMenu1 to the form.
    this.Menu=mainMenu1;

    // Perform a click on the File menu item.
    menuItem1.PerformClick();
}

private void menuItem1_Click(object sender, System.EventArgs e)
{	
    MessageBox.Show("You clicked the File menu.","The Event Information");		
}

private void menuItem2_Click(object sender, System.EventArgs e)
{
    MessageBox.Show("You clicked the Edit menu.","The Event Information");		
}

Public Sub CreateMyMenu()
    ' Create a main menu object.
    Dim mainMenu1 As New MainMenu()

    ' Create empty menu item objects.
    Dim menuItem1 As New MenuItem()
    Dim menuItem2 As New MenuItem()

    ' Set the caption of the menu items.
    menuItem1.Text = "&File"
    menuItem2.Text = "&Edit"

    ' Add the menu items to the main menu.
    mainMenu1.MenuItems.Add(menuItem1)
    mainMenu1.MenuItems.Add(menuItem2)

    ' Add functionality to the menu items. 
    AddHandler menuItem1.Click, AddressOf Me.menuItem1_Click
    AddHandler menuItem2.Click, AddressOf Me.menuItem2_Click

    ' Assign mainMenu1 to the form.
    Me.Menu = mainMenu1

    ' Perform a click on the File menu item.
    menuItem1.PerformClick()
End Sub


Private Sub menuItem1_Click(ByVal sender As Object, ByVal e As System.EventArgs)
    MessageBox.Show("You clicked the File menu.", "The Event Information")
End Sub


Private Sub menuItem2_Click(ByVal sender As Object, ByVal e As System.EventArgs)
    MessageBox.Show("You clicked the Edit menu.", "The Event Information")
End Sub

Hinweise

Sie können dieses Menü verwenden, um ein Menüelement über Code zu aktivieren, ohne Ereignisinformationen zu übergeben. Wenn Sie beispielsweise ein Menüelement basierend auf einer Aktion aktivieren möchten, die in Ihrer Anwendung auftritt, können Sie die PerformClick -Methode für diese MenuItemaufrufen.