MenuItem.PerformClick Methode

Definition

Generiert ein Click-Ereignis für MenuItem, wobei ein Mausklick durch einen Benutzer simuliert wird.Generates a Click event for the MenuItem, simulating a click by a user.

public:
 void PerformClick();
public void PerformClick ();
member this.PerformClick : unit -> unit
Public Sub PerformClick ()

Beispiele

In diesem Beispiel klicken Sie Programm gesteuert mit der PerformClick-Methode auf ein Menü Element.In this example you programmatically click a menu item by using the PerformClick method. Zuerst erstellen Sie ein Hauptmenü (mainMenu1) und fügen diesem zwei Menü Elemente hinzu, menuItem1 (File) und menuItem2 (Edit).First, you create a main menu (mainMenu1) and add to it two menu items, menuItem1 (File) and menuItem2 (Edit). Außerdem verwenden Sie das Click-Ereignis, um Daten an den Ereignishandler zu senden, wenn auf ein Menü Element geklickt wird.You also use the Click event to send data to the event handler when a menu item is clicked. Anschließend verwenden Sie die PerformClick-Methode, um auf das Menü Element File zu klicken.Then you use the PerformClick method to click the File menu item. Wenn Sie die Anwendung starten, wird das Menü Element File aktiviert, und es wird ein Meldungs Feld mit dem Text "das Menü Datei wird geklickt" angezeigt.When you start the application, the File menu item is activated, and a message box that contains the text "The File menu is clicked." wird auf dem Bildschirm angezeigt.appears on the screen. Das Beispiel erfordert, dass Sie eine Form mit dem Namen Form1erstellt haben.The example requires that you have created a Form named Form1.

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 durch Code zu aktivieren, ohne Ereignis Informationen zu übergeben.You can use this menu to activate a menu item through code without passing any event information. Wenn Sie z. b. ein Menü Element auf der Grundlage einer in der Anwendung auftretende Aktion aktivieren möchten, können Sie die PerformClick-Methode für diese MenuItemabrufen.For example, if you want to activate a menu item based on an action that occurs in your application, you can call the PerformClick method for that MenuItem.

Gilt für: