ContextMenu.SourceControl Eigenschaft

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Ruft das Steuerelement ab, das das Kontextmenü anzeigt.

public:
 property System::Windows::Forms::Control ^ SourceControl { System::Windows::Forms::Control ^ get(); };

[System.ComponentModel.Browsable(false)]
public System.Windows.Forms.Control SourceControl { get; }

[<System.ComponentModel.Browsable(false)>]
member this.SourceControl : System.Windows.Forms.Control

Public ReadOnly Property SourceControl As Control

Eigenschaftswert

Control

Ein Control, das das Kontextmenü anzeigende Steuerelement darstellt. Wenn kein Steuerelement das Kontextmenü angezeigt hat, gibt diese Eigenschaft null zurück.

Attribute

BrowsableAttribute

Beispiele

Im folgenden Codebeispiel wird ein Ereignishandler für das Popup -Ereignis von ContextMenuerstellt. Der Code im Ereignishandler bestimmt, welches von zwei Steuerelementen ein PictureBox benanntes pictureBox1 und ein benanntes TextBoxtextBox1 das Steuerelement ist, das das Kontextmenü anzeigt. Je nachdem, durch welches Steuerelement das ContextMenu Kontextmenü angezeigt wurde, fügt das -Steuerelement die entsprechenden MenuItem -Objekte zu hinzu ContextMenu. In diesem Beispiel muss eine instance der -Klasse mit dem ContextMenu Namen contextMenu1innerhalb des Formulars definiert sein. Dieses Beispiel erfordert auch, dass Sie ein TextBox - und PictureBox einem Formular hinzugefügt haben und dass die ContextMenu -Eigenschaft dieser Steuerelemente auf contextMenu1festgelegt ist.

private:
   void MyPopupEventHandler( System::Object^ /*sender*/, System::EventArgs^ /*e*/ )
   {
      // Define the MenuItem objects to display for the TextBox.
      MenuItem^ menuItem1 = gcnew MenuItem( "&Copy" );
      MenuItem^ menuItem2 = gcnew MenuItem( "&Find and Replace" );
      // Define the MenuItem object to display for the PictureBox.
      MenuItem^ menuItem3 = gcnew MenuItem( "C&hange Picture" );
      
      // Clear all previously added MenuItems.
      contextMenu1->MenuItems->Clear();

      if ( contextMenu1->SourceControl == textBox1 )
      {
         
         // Add MenuItems to display for the TextBox.
         contextMenu1->MenuItems->Add( menuItem1 );
         contextMenu1->MenuItems->Add( menuItem2 );
      }
      else if ( contextMenu1->SourceControl == pictureBox1 )
      {
         // Add the MenuItem to display for the PictureBox.
         contextMenu1->MenuItems->Add( menuItem3 );
      }
   }

private void MyPopupEventHandler(System.Object sender, System.EventArgs e)
 {
    // Define the MenuItem objects to display for the TextBox.
    MenuItem menuItem1 = new MenuItem("&Copy");
    MenuItem menuItem2 = new MenuItem("&Find and Replace");
    // Define the MenuItem object to display for the PictureBox.
    MenuItem menuItem3 = new MenuItem("C&hange Picture");

    // Clear all previously added MenuItems.
    contextMenu1.MenuItems.Clear();
 
    if(contextMenu1.SourceControl == textBox1)
    {
       // Add MenuItems to display for the TextBox.
       contextMenu1.MenuItems.Add(menuItem1);
       contextMenu1.MenuItems.Add(menuItem2);
    }
    else if(contextMenu1.SourceControl == pictureBox1)
    {
       // Add the MenuItem to display for the PictureBox.
       contextMenu1.MenuItems.Add(menuItem3);
    }
 }

Private Sub MyPopupEventHandler(sender As System.Object, e As System.EventArgs)
    ' Define the MenuItem objects to display for the TextBox.
    Dim menuItem1 As New MenuItem("&Copy")
    Dim menuItem2 As New MenuItem("&Find and Replace")
    ' Define the MenuItem object to display for the PictureBox.
    Dim menuItem3 As New MenuItem("C&hange Picture")
    
    ' Clear all previously added MenuItems.
    contextMenu1.MenuItems.Clear()
    
    If contextMenu1.SourceControl Is textBox1 Then
        ' Add MenuItems to display for the TextBox.
        contextMenu1.MenuItems.Add(menuItem1)
        contextMenu1.MenuItems.Add(menuItem2)
    ElseIf contextMenu1.SourceControl Is pictureBox1 Then
        ' Add the MenuItem to display for the PictureBox.
        contextMenu1.MenuItems.Add(menuItem3)
    End If
End Sub

Hinweise

Mit dieser Eigenschaft können Sie bestimmen, welches Steuerelement derzeit das im definierten ContextMenuKontextmenü anzeigt. Wenn das Kontextmenü derzeit nicht angezeigt wird, können Sie diese Eigenschaft verwenden, um zu bestimmen, welches Steuerelement zuletzt im Kontextmenü angezeigt wurde. Sie können diese Eigenschaft im Popup -Ereignis verwenden, um sicherzustellen, dass das Steuerelement die richtigen Menüelemente anzeigt. Sie können diese Eigenschaft auch verwenden, um einen Verweis auf das Steuerelement an eine Methode zu übergeben, die die Aufgaben ausführt, die einem Menübefehl zugeordnet sind, der im Kontextmenü angezeigt wird. Da die Form -Klasse von Controlerbt, können Sie diese Eigenschaft auch verwenden, wenn die ContextMenu einem Formular zugeordnet ist.