ContextMenu ContextMenu ContextMenu ContextMenu Class

定義

ショートカット メニューを表します。Represents a shortcut menu. ContextMenuStrip コントロールは、以前のバージョンの ContextMenu コントロールに代わると共に追加の機能を提供します。ただし、ContextMenu コントロールは、下位互換性を保つ目的および将来使用する目的で保持されます。Although ContextMenuStrip replaces and adds functionality to the ContextMenu control of previous versions, ContextMenu is retained for both backward compatibility and future use if you choose.

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
継承

次のコード例では、 Popup ContextMenuのイベントのイベントハンドラーを作成します。The following code example creates an event handler for the Popup event of the ContextMenu. イベントハンドラーのコードでは、とPictureBoxいう名前pictureBox1 TextBox textBox1の2つのコントロールのうち、ショートカットメニューを表示するコントロールを指定します。The code in the event handler determines which of two controls a PictureBox named pictureBox1 and a TextBox named textBox1 is the control displaying the shortcut menu. コントロールによって、がContextMenuそのショートカットメニューを表示する原因となったMenuItemコントロールに応じContextMenuて、適切なオブジェクトがに追加されます。Depending on which control caused the ContextMenu to display its shortcut menu, the control adds the appropriate MenuItem objects to the ContextMenu. この例では、という名前ContextMenu contextMenu1のクラスのインスタンスがフォーム内で定義されている必要があります。This example requires that you have an instance of the ContextMenu class, named contextMenu1, defined within the form. また、このTextBox例では、 PictureBoxを持っていて、フォームにをContextMenu追加し、これらのコントロールのcontextMenu1プロパティがに設定されている必要もあります。This example also requires that you have a TextBox and PictureBox added to a form and that the ContextMenu property of these controls is set to 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

注釈

クラスContextMenuは、ユーザーがコントロールまたはフォームの領域上でマウスの右ボタンをクリックしたときに表示されるショートカットメニューを表します。The ContextMenu class represents shortcut menus that can be displayed when the user clicks the right mouse button over a control or area of the form. ショートカットメニューは、通常、ユーザーがアプリケーションのコンテキストMainMenuを指定した場合に便利な、フォームのからさまざまなメニュー項目を結合するために使用されます。Shortcut menus are typically used to combine different menu items from a MainMenu of a form that are useful for the user given the context of the application. たとえば、 TextBoxコントロールに割り当てられたショートカットメニューを使用して、テキストのフォントの変更、コントロール内のテキストの検索、テキストのコピーと貼り付けを行うためのクリップボード機能を提供できます。For example, you can use a shortcut menu assigned to a TextBox control to provide menu items for changing the font of the text, finding text within the control, or Clipboard features for copying and pasting text. また、に含まれMenuItemていないMainMenuショートカットメニューに新しいオブジェクトを表示して、 MainMenuの表示に適していない状況固有のコマンドを提供することもできます。You can also display new MenuItem objects in a shortcut menu that are not located within a MainMenu to provide situation specific commands that are not appropriate for the MainMenu to display.

通常、ユーザーがコントロールまたはフォーム自体でマウスの右ボタンをクリックすると、ショートカットメニューが表示されます。Typically, a shortcut menu is displayed when a user clicks the right mouse button over a control or the form itself. 表示されるFormコントロールとContextMenu 、ショートカットメニュー ContextMenuを表示するコントロールにクラスをバインドするプロパティがあります。Visible controls and Form have a ContextMenu property that binds the ContextMenu class to the control that displays the shortcut menu. 複数のコントロールでをContextMenu使用できます。More than one control can use a ContextMenu. SourceControlプロパティを使用して、コントロールに固有のタスクを実行したり、コントロールに表示されるショートカットメニューを変更したりするために、最後にショートカットメニューを表示したコントロールを確認できます。You can use the SourceControl property to determine which control last displayed the shortcut menu in order to perform tasks specific to the control or to modify the shortcut menu displayed for the control.

メニューがユーザーに表示される前に、チェックマークを設定したり、項目を無効にしたり、その他のメニュータスクを実行したりするために、ショートカットメニューがいつ表示されるかを確認したい場合があります。You might want to know when the shortcut menu is being displayed in order to set check marks, disable items, and perform other menu tasks before the menu is displayed to the user. イベントをPopup処理して、ショートカットメニューが表示されていることを確認できます。You can handle the Popup event to determine when the shortcut menu is being displayed.

注意

MenuItem使用MenuItem CloneMenuするためにで表示されるオブジェクトを再利用するには、クラスのメソッドを使用してメニューのコピーを作成する必要があります。ContextMenu MainMenuIn order to reuse MenuItem objects that are displayed in a MainMenu for use in a ContextMenu, you must create a copy of the menu using the CloneMenu method of the MenuItem class. クラスのMergeMenu MenuItem メソッドを使用して、メニュー項目とそのサブメニュー項目を1つのオブジェクトにマージすることもできます。MenuItemYou can also merge menu items and their submenu items into a single MenuItem object using the MergeMenu method of the MenuItem class.

コンストラクター

ContextMenu() ContextMenu() ContextMenu() ContextMenu()

メニュー項目を指定せずに、ContextMenu クラスの新しいインスタンスを初期化します。Initializes a new instance of the ContextMenu class with no menu items specified.

ContextMenu(MenuItem[]) ContextMenu(MenuItem[]) ContextMenu(MenuItem[]) ContextMenu(MenuItem[])

一連の ContextMenu オブジェクトを指定して、MenuItem クラスの新しいインスタンスを初期化します。Initializes a new instance of the ContextMenu class with a specified set of MenuItem objects.

プロパティ

CanRaiseEvents CanRaiseEvents CanRaiseEvents CanRaiseEvents

コンポーネントがイベントを発生させることがきるかどうかを示す値を取得します。Gets a value indicating whether the component can raise an event.

(Inherited from Component)
Container Container Container Container

IContainer を格納している Component を取得します。Gets the IContainer that contains the Component.

(Inherited from Component)
DesignMode DesignMode DesignMode DesignMode

Component が現在デザイン モードかどうかを示す値を取得します。Gets a value that indicates whether the Component is currently in design mode.

(Inherited from Component)
Events Events Events Events

Component に結び付けられているイベント ハンドラーのリストを取得します。Gets the list of event handlers that are attached to this Component.

(Inherited from Component)
Handle Handle Handle Handle

メニューのウィンドウ ハンドルを表している値を取得します。Gets a value representing the window handle for the menu.

(Inherited from Menu)
IsParent IsParent IsParent IsParent

このメニューにメニュー項目が格納されているかどうかを示す値を取得します。Gets a value indicating whether this menu contains any menu items. このプロパティは読み取り専用です。This property is read-only.

(Inherited from Menu)
MdiListItem MdiListItem MdiListItem MdiListItem

マルチ ドキュメント インターフェイス (MDI) 子フォームの一覧を表示するために使用される MenuItem を示す値を取得します。Gets a value indicating the MenuItem that is used to display a list of multiple document interface (MDI) child forms.

(Inherited from Menu)
MenuItems MenuItems MenuItems MenuItems

メニューに関連付けられている MenuItem オブジェクトのコレクションを示す値を取得します。Gets a value indicating the collection of MenuItem objects associated with the menu.

(Inherited from Menu)
Name Name Name Name

Menu の名前を取得または設定します。Gets or sets the name of the Menu.

(Inherited from Menu)
RightToLeft RightToLeft RightToLeft RightToLeft

コントロールがテキストを右から左に表示するかどうかを示す値を取得または設定します。Gets or sets a value indicating whether text displayed by the control is displayed from right to left.

Site Site Site Site

ComponentISite を取得または設定します。Gets or sets the ISite of the Component.

(Inherited from Component)
SourceControl SourceControl SourceControl SourceControl

ショートカット メニューを表示しているコントロールを取得します。Gets the control that is displaying the shortcut menu.

Tag Tag Tag Tag

コントロールに関連付けられたユーザー定義のデータを取得または設定します。Gets or sets user-defined data associated with the control.

(Inherited from Menu)

メソッド

CloneMenu(Menu) CloneMenu(Menu) CloneMenu(Menu) CloneMenu(Menu)

現在の Menu にパラメーターとして渡された Menu をコピーします。Copies the Menu that is passed as a parameter to the current Menu.

(Inherited from Menu)
CreateMenuHandle() CreateMenuHandle() CreateMenuHandle() CreateMenuHandle()

Menu への新しいハンドルを作成します。Creates a new handle to the Menu.

(Inherited from Menu)
CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type)

リモート オブジェクトとの通信に使用するプロキシの生成に必要な情報をすべて格納しているオブジェクトを作成します。Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Inherited from MarshalByRefObject)
Dispose() Dispose() Dispose() Dispose()

Component によって使用されているすべてのリソースを解放します。Releases all resources used by the Component.

(Inherited from Component)
Dispose(Boolean) Dispose(Boolean) Dispose(Boolean) Dispose(Boolean)

Menu によって使用されているリソース (メモリを除く) を解放します。Disposes of the resources, other than memory, used by the Menu.

(Inherited from Menu)
Equals(Object) Equals(Object) Equals(Object) Equals(Object)

指定したオブジェクトが、現在のオブジェクトと等しいかどうかを判断します。Determines whether the specified object is equal to the current object.

(Inherited from Object)
FindMenuItem(Int32, IntPtr) FindMenuItem(Int32, IntPtr) FindMenuItem(Int32, IntPtr) FindMenuItem(Int32, IntPtr)

指定した値を含む MenuItem を取得します。Gets the MenuItem that contains the value specified.

(Inherited from Menu)
FindMergePosition(Int32) FindMergePosition(Int32) FindMergePosition(Int32) FindMergePosition(Int32)

メニューにおけるメニュー項目の追加位置を返します。Returns the position at which a menu item should be inserted into the menu.

(Inherited from Menu)
GetContextMenu() GetContextMenu() GetContextMenu() GetContextMenu()

メニューを格納している ContextMenu を取得します。Gets the ContextMenu that contains this menu.

(Inherited from Menu)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

既定のハッシュ関数として機能します。Serves as the default hash function.

(Inherited from Object)
GetLifetimeService() GetLifetimeService() GetLifetimeService() GetLifetimeService()

対象のインスタンスの有効期間ポリシーを制御する、現在の有効期間サービス オブジェクトを取得します。Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
GetMainMenu() GetMainMenu() GetMainMenu() GetMainMenu()

メニューを格納している MainMenu を取得します。Gets the MainMenu that contains this menu.

(Inherited from Menu)
GetService(Type) GetService(Type) GetService(Type) GetService(Type)

Component またはその Container で提供されるサービスを表すオブジェクトを返します。Returns an object that represents a service provided by the Component or by its Container.

(Inherited from Component)
GetType() GetType() GetType() GetType()

現在のインスタンスの Type を取得します。Gets the Type of the current instance.

(Inherited from Object)
InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService()

このインスタンスの有効期間ポリシーを制御する有効期間サービス オブジェクトを取得します。Obtains a lifetime service object to control the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

現在の Object の簡易コピーを作成します。Creates a shallow copy of the current Object.

(Inherited from Object)
MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean)

現在の MarshalByRefObject オブジェクトの簡易コピーを作成します。Creates a shallow copy of the current MarshalByRefObject object.

(Inherited from MarshalByRefObject)
MergeMenu(Menu) MergeMenu(Menu) MergeMenu(Menu) MergeMenu(Menu)

1 つのメニューの MenuItem オブジェクトを現在のメニューにマージします。Merges the MenuItem objects of one menu with the current menu.

(Inherited from Menu)
OnCollapse(EventArgs) OnCollapse(EventArgs) OnCollapse(EventArgs) OnCollapse(EventArgs)

Collapse イベントを発生させます。Raises the Collapse event.

OnPopup(EventArgs) OnPopup(EventArgs) OnPopup(EventArgs) OnPopup(EventArgs)

Popup イベントを発生させます。Raises the Popup event

ProcessCmdKey(Message, Keys) ProcessCmdKey(Message, Keys) ProcessCmdKey(Message, Keys) ProcessCmdKey(Message, Keys)

コマンド キーを処理します。Processes a command key.

(Inherited from Menu)
ProcessCmdKey(Message, Keys, Control) ProcessCmdKey(Message, Keys, Control) ProcessCmdKey(Message, Keys, Control) ProcessCmdKey(Message, Keys, Control)

コマンド キーを処理します。Processes a command key.

Show(Control, Point) Show(Control, Point) Show(Control, Point) Show(Control, Point)

指定した位置にショートカット メニューを表示します。Displays the shortcut menu at the specified position.

Show(Control, Point, LeftRightAlignment) Show(Control, Point, LeftRightAlignment) Show(Control, Point, LeftRightAlignment) Show(Control, Point, LeftRightAlignment)

位置および配置を指定してショートカット メニューを表示します。Displays the shortcut menu at the specified position and with the specified alignment.

ToString() ToString() ToString() ToString()

String コントロールを表す Menu を返します。Returns a String that represents the Menu control.

(Inherited from Menu)

イベント

Collapse Collapse Collapse Collapse

ショートカット メニューが折りたたまれたときに発生します。Occurs when the shortcut menu collapses.

Disposed Disposed Disposed Disposed

Dispose() メソッドの呼び出しによってコンポーネントが破棄されると発生します。Occurs when the component is disposed by a call to the Dispose() method.

(Inherited from Component)
Popup Popup Popup Popup

ショートカット メニューが表示される前に発生します。Occurs before the shortcut menu is displayed.

フィールド

FindHandle FindHandle FindHandle FindHandle

FindMenuItem(Int32, IntPtr) メソッドでハンドルを検索するよう指定します。Specifies that the FindMenuItem(Int32, IntPtr) method should search for a handle.

(Inherited from Menu)
FindShortcut FindShortcut FindShortcut FindShortcut

FindMenuItem(Int32, IntPtr) メソッドでショートカットを検索するよう指定します。Specifies that the FindMenuItem(Int32, IntPtr) method should search for a shortcut.

(Inherited from Menu)

適用対象

こちらもご覧ください