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 a ContextMenuseguir cria um manipulador de eventos para o Popup evento do . O código no manipulador de eventos determina qual dos dois controles um PictureBox nomeado pictureBox1 e um TextBox nomeado textBox1 é o controle que exibe o menu de atalho. Dependendo de qual controle fez com que o ContextMenu exibisse seu menu de atalho, o controle adiciona os objetos apropriados MenuItem ao ContextMenu. Este exemplo exige que você tenha uma instância da ContextMenu classe, chamada contextMenu1, definida dentro do formulário. Este exemplo também requer que você tenha um TextBox e PictureBox adicionado a um formulário e que a ContextMenu propriedade desses controles seja definida contextMenu1como .

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

Comentários

Esta classe não está disponível no .NET Core 3.1 nem em versões posteriores. Use ContextMenuStrip em seu lugar.

A ContextMenu classe representa menus de atalho que podem ser exibidos quando o usuário clica no botão direito do mouse sobre um controle ou área do formulário. Os menus de atalho normalmente são usados para combinar diferentes itens de menu de um MainMenu formulário que são úteis para o usuário, considerando o contexto do aplicativo. Por exemplo, você pode usar um menu de atalho atribuído a um TextBox controle para fornecer itens de menu para alterar a fonte do texto, localizar texto dentro do controle ou recursos da Área de Transferência para copiar e colar texto. Você também pode exibir novos MenuItem objetos em um menu de atalho que não estão localizados em um MainMenu para fornecer comandos específicos de situação que não são apropriados para exibição MainMenu .

Normalmente, um menu de atalho é exibido quando um usuário clica no botão direito do mouse sobre um controle ou o próprio formulário. Controles visíveis e Form têm uma ContextMenu propriedade que associa a ContextMenu classe ao controle que exibe o menu de atalho. Mais de um controle pode usar um ContextMenu. Você pode usar a SourceControl propriedade para determinar qual controle exibiu pela última vez o menu de atalho para executar tarefas específicas ao controle ou modificar o menu de atalho exibido para o controle.

Talvez você queira saber quando o menu de atalho está sendo exibido para definir marcar marcas, desabilitar itens e executar outras tarefas de menu antes que o menu seja exibido para o usuário. Você pode manipular o Popup evento para determinar quando o menu de atalho está sendo exibido.

Construtores

Campos

Propriedades

Métodos

Eventos

Aplica-se a

Confira também

• Menu
• MenuItem
• MainMenu