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 라는 pictureBox1TextBox 라는 textBox1 바로 가기 메뉴를 표시 하는 컨트롤입니다.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. 이 예제에서는 또한 있어야를 TextBoxPictureBox 를 폼에 추가 합니다 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. 표시 컨트롤 및 FormContextMenu 바인딩되는 속성을 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 에 표시 되는 개체를 MainMenu 에서 사용 하기 위해를 ContextMenu를 사용 하 여 메뉴의 복사본을 만들어야 합니다를 CloneMenu 메서드의 MenuItem 클래스입니다.In 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. 단일 메뉴 항목 및 해당 하위 메뉴 항목을 병합할 수도 있습니다 MenuItem 를 사용 하 여 개체를 MergeMenu 메서드를 MenuItem 클래스입니다.You 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)

한 메뉴의 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)

적용 대상

추가 정보