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 イベントのイベント ハンドラーを作成します。 イベント ハンドラーのコードは、PictureBox という名前のpictureBox1と、ショートカット メニューを表示するコントロールTextBoxという名前のtextBox1の 2 つのコントロールを決定します。 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