ContextMenu Classe

Definizione

public ref class ContextMenu : System::Windows::Forms::Menu

public class ContextMenu : System.Windows.Forms.Menu

[System.ComponentModel.Browsable(false)]
[System.Obsolete("`ContextMenu` is provided for binary compatibility with .NET Framework and is not intended to be used directly from your code. Use `ContextMenuStrip` instead.", false, DiagnosticId="WFDEV006", UrlFormat="https://aka.ms/winforms-warnings/{0}")]
public class ContextMenu : System.Windows.Forms.Menu

type ContextMenu = class
    inherit Menu

[<System.ComponentModel.Browsable(false)>]
[<System.Obsolete("`ContextMenu` is provided for binary compatibility with .NET Framework and is not intended to be used directly from your code. Use `ContextMenuStrip` instead.", false, DiagnosticId="WFDEV006", UrlFormat="https://aka.ms/winforms-warnings/{0}")>]
type ContextMenu = class
    inherit Menu

Public Class ContextMenu
Inherits Menu

Ereditarietà

Object

MarshalByRefObject

Component

Menu

ContextMenu

Attributi

BrowsableAttribute ObsoleteAttribute

Esempio

Nell'esempio di codice seguente viene creato un gestore eventi per l'evento Popup di ContextMenu. Il codice nel gestore eventi determina quali di due controlli un PictureBox oggetto denominato e un TextBox denominato pictureBox1textBox1 è il controllo che visualizza il menu di scelta rapida. A seconda del controllo che ha causato la ContextMenu visualizzazione del relativo menu di scelta rapida, il controllo aggiunge gli oggetti appropriati MenuItem all'oggetto ContextMenu. In questo esempio è necessario disporre di un'istanza della ContextMenu classe denominata contextMenu1, definita all'interno del form. In questo esempio è inoltre necessario disporre di un oggetto TextBox e PictureBox aggiunto a una maschera e che la ContextMenu proprietà di questi controlli sia impostata su contextMenu1.

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

Commenti

Questa classe non è disponibile in .NET Core 3.1 e versioni successive. Utilizzare invece ContextMenuStrip.

La ContextMenu classe rappresenta i menu di scelta rapida che possono essere visualizzati quando l'utente fa clic sul pulsante destro del mouse su un controllo o un'area del modulo. I menu di scelta rapida vengono in genere usati per combinare voci di menu diverse da un MainMenu modulo utile per l'utente in base al contesto dell'applicazione. Ad esempio, è possibile utilizzare un menu di scelta rapida assegnato a un TextBox controllo per fornire voci di menu per modificare il tipo di carattere del testo, trovare testo all'interno del controllo o funzionalità degli Appunti per copiare e incollare il testo. È anche possibile visualizzare nuovi MenuItem oggetti in un menu di scelta rapida che non si trova all'interno di un MainMenu oggetto per fornire comandi specifici della situazione che non sono appropriati per la MainMenu visualizzazione di .

In genere, viene visualizzato un menu di scelta rapida quando un utente fa clic sul pulsante destro del mouse su un controllo o sul modulo stesso. I controlli visibili e Form dispongono di una ContextMenu proprietà che associa la ContextMenu classe al controllo che visualizza il menu di scelta rapida. Più controlli possono usare un oggetto ContextMenu. È possibile utilizzare la SourceControl proprietà per determinare l'ultimo controllo visualizzato dal menu di scelta rapida per eseguire attività specifiche del controllo o per modificare il menu di scelta rapida visualizzato per il controllo.

È possibile sapere quando viene visualizzato il menu di scelta rapida per impostare i segni di spunta, disabilitare le voci ed eseguire altre attività di menu prima che il menu venga visualizzato all'utente. È possibile gestire l'evento Popup per determinare quando viene visualizzato il menu di scelta rapida.

Vedi anche

• Menu
• MenuItem
• MainMenu