ContextMenu Classe

Definição

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

public class ContextMenu : System.Windows.Forms.Menu

type ContextMenu = class
    inherit Menu

Public Class ContextMenu
Inherits Menu

Herança

Object

MarshalByRefObject

Component

Menu

ContextMenu

Exemplos

O exemplo de código seguinte cria um gestor de eventos para o Popup evento do ContextMenu. O código no gestor de eventos determina qual dos dois controlos, um PictureBox nomeado pictureBox1 e um TextBox nomeado textBox1 , é o controlo que exibe o menu de atalho. Dependendo de qual controlo fez com que o ContextMenu apresente o menu de atalhos, o controlo adiciona os objetos apropriados MenuItem ao ContextMenu. Este exemplo exige que tenha uma instância da ContextMenu classe, chamada contextMenu1, definida dentro do formulário. Este exemplo também exige que tenha um TextBox e adicionado a uma forma e que a ContextMenu propriedade destes controlos seja definida para contextMenu1PictureBox .

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

Observações

Esta classe não está disponível no .NET Core 3.1 e versões posteriores. Utilize ContextMenuStrip em substituição.

A ContextMenu classe representa menus de atalho que podem ser exibidos quando o utilizador clica no botão direito do rato sobre um controlo ou área do formulário. Os menus de atalho são tipicamente usados para combinar diferentes itens do menu de um MainMenu formulário que são úteis para o utilizador, dado o contexto da aplicação. Por exemplo, pode usar um menu de atalho atribuído a um TextBox controlo para fornecer itens do menu para alterar a fonte do texto, encontrar texto dentro do controlo, ou funcionalidades de Transferência para copiar e colar texto. Também pode mostrar novos MenuItem objetos num menu de atalho que não estejam localizados MainMenu num para fornecer comandos específicos de situações que não são apropriados para a visualização MainMenu .

Normalmente, um menu de atalho é exibido quando o utilizador clica no botão direito do rato sobre um controlo ou sobre o próprio formulário. Controlos visíveis e Form têm uma ContextMenu propriedade que associa a ContextMenu classe ao controlo que mostra o menu de atalho. Mais do que um controlo pode usar um ContextMenu. Pode usar a SourceControl propriedade para determinar qual dos atalhos do menu de atalhos foi exibido por última vez para realizar tarefas específicas do controlo ou para modificar o menu de atalhos exibido para o controlo.

Pode querer saber quando o menu de atalho está a ser exibido para definir marcas de verificação, desativar itens e realizar outras tarefas do menu antes de o menu ser mostrado ao utilizador. Podes gerir o Popup evento para determinar quando o menu de atalhos está a ser exibido.

Ver também

• Menu
• MenuItem
• MainMenu