ContextMenu Класс

Определение

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

Наследование

Object

MarshalByRefObject

Component

Menu

ContextMenu

Примеры

В следующем примере кода создается обработчик событий для Popup события ContextMenuобъекта . Код в обработчике событий определяет, какой из двух элементов управления именованный PictureBoxpictureBox1 и именованный TextBoxtextBox1 является элементом управления, отображающим контекстное меню. В зависимости от того, какой элемент управления привел к отображению ContextMenu контекстного меню, элемент управления добавляет соответствующие MenuItem объекты в ContextMenu. В этом примере требуется, чтобы в форме был определен экземпляр ContextMenu класса с именем contextMenu1. В этом примере также требуется добавить TextBox и PictureBox в форму, а свойству ContextMenu этих элементов управления присвоено значение 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

Комментарии

Этот класс недоступен в .NET Core 3.1 и более поздних версиях. Взамен рекомендуется использовать ContextMenuStrip.

Класс ContextMenu представляет контекстные меню, которые могут отображаться при нажатии правой кнопки мыши над элементом управления или областью формы. Контекстные меню обычно используются для объединения различных пунктов меню из MainMenu формы, которые полезны для пользователя в контексте приложения. Например, можно использовать контекстное меню, назначенное элементу TextBox управления, чтобы предоставить пункты меню для изменения шрифта текста, поиска текста в элементе управления или функции буфера обмена для копирования и вставки текста. Вы также можете отображать новые MenuItem объекты в контекстном меню, которые не находятся в , чтобы предоставить команды для конкретной MainMenu ситуации MainMenu , которые не подходят для отображения.

Как правило, контекстное меню отображается, когда пользователь щелкает правую кнопку мыши над элементом управления или самой формой. Видимые элементы управления и Form имеют ContextMenu свойство , которое привязывает ContextMenu класс к элементу управления, отображающего контекстное меню. Несколько элементов управления могут использовать ContextMenu. Вы можете использовать SourceControl свойство , чтобы определить, какой элемент управления последний раз отображался в контекстном меню, чтобы выполнять задачи, относящиеся к элементу управления, или изменить контекстное меню, отображаемое для элемента управления.

Вы можете узнать, когда отображается контекстное меню, чтобы задать проверка метки, отключить элементы и выполнить другие задачи меню перед отображением меню для пользователя. Вы можете обработать Popup событие, чтобы определить, когда отображается контекстное меню.

Конструкторы

Поля

Свойства

Методы

События

Применяется к

См. также раздел

• Menu
• MenuItem
• MainMenu