ContextMenu ContextMenu ContextMenu ContextMenu Class

Definizione

Viene visualizzato un menu di scelta rapida.Represents a shortcut menu. Benché il controllo ContextMenuStrip sostituisca il controllo ContextMenu delle versioni precedenti aggiungendo funzionalità, il controllo ContextMenu viene mantenuto per compatibilità con le versioni precedenti e per utilizzo futuro se lo si desidera.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
Ereditarietà

Esempi

L'esempio di codice seguente crea un gestore eventi per il Popup eventi del ContextMenu.The following code example creates an event handler for the Popup event of the ContextMenu. Il codice nel gestore dell'evento stabilisce quale dei due controlli una PictureBox denominate pictureBox1 e una TextBox denominato textBox1 controllo, verrà visualizzato il menu di scelta rapida.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. A seconda di quale controllo ha causato il ContextMenu per visualizzare il menu di scelta rapida, il controllo aggiunge appropriato MenuItem gli oggetti per il ContextMenu.Depending on which control caused the ContextMenu to display its shortcut menu, the control adds the appropriate MenuItem objects to the ContextMenu. Questo esempio richiede che si abbia un'istanza del ContextMenu classe, denominata contextMenu1, definito all'interno del form.This example requires that you have an instance of the ContextMenu class, named contextMenu1, defined within the form. In questo esempio richiede anche di avere una TextBox e PictureBox aggiunto a un form e che le ContextMenu di questi controlli è impostata su 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 'MyPopupEventHandler '

Commenti

Il ContextMenu classe rappresenta il menu di scelta rapida che può essere visualizzato quando l'utente fa clic sul pulsante destro del mouse su un controllo o un'area del modulo.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. Menu di scelta rapida sono in genere usati per combinare diverse voci di menu da un MainMenu di un form che sono utili per l'utente nel contesto dell'applicazione.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. Ad esempio, è possibile usare un menu di scelta rapida assegnato a un TextBox controllo per fornire le voci di menu per modificare il tipo di carattere del testo, la ricerca di testo all'interno del controllo o le funzionalità degli Appunti per copiare e incollare il testo.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. È inoltre possibile visualizzare nuovi MenuItem oggetti in un menu di scelta rapida che non si trovano all'interno di un MainMenu per fornire in determinate situazioni, comandi che non sono appropriati per il MainMenu da visualizzare.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.

In genere, viene visualizzato un menu di scelta rapida quando un utente sceglie il pulsante destro del mouse su un controllo o del modulo stesso.Typically, a shortcut menu is displayed when a user clicks the right mouse button over a control or the form itself. I controlli visibili e Form hanno un ContextMenu proprietà cui si associa il ContextMenu classe per il controllo che visualizza il menu di scelta rapida.Visible controls and Form have a ContextMenu property that binds the ContextMenu class to the control that displays the shortcut menu. Più di un controllo è possibile usare un ContextMenu.More than one control can use a ContextMenu. È possibile usare il SourceControl proprietà per determinare quale controllo ha visualizzato il menu di scelta rapida per eseguire attività specifiche per il controllo o per modificare il menu di scelta rapida visualizzato per il controllo.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.

Si potrebbe voler sapere quando verrà visualizzato il menu di scelta rapida per set di segni di spunta, disabilitare gli elementi ed eseguire altre attività di menu prima che venga visualizzato il menu di scelta all'utente.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. È possibile gestire il Popup evento per determinare quando viene visualizzato il menu di scelta rapida.You can handle the Popup event to determine when the shortcut menu is being displayed.

Nota

Per riutilizzarla MenuItem gli oggetti che vengono visualizzati in un MainMenu per l'uso in un ContextMenu, è necessario creare una copia di menu utilizzando la CloneMenu metodo del MenuItem classe.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. È inoltre possibile unire le voci di menu e voci dei relativi sottomenu in un'unica MenuItem utilizzando il MergeMenu metodo il MenuItem classe.You can also merge menu items and their submenu items into a single MenuItem object using the MergeMenu method of the MenuItem class.

Costruttori

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

Inizializza una nuova istanza della classe ContextMenu senza voci di menu specificate.Initializes a new instance of the ContextMenu class with no menu items specified.

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

Inizializza una nuova istanza della classe ContextMenu con un gruppo specificato di oggetti MenuItem.Initializes a new instance of the ContextMenu class with a specified set of MenuItem objects.

Proprietà

CanRaiseEvents CanRaiseEvents CanRaiseEvents CanRaiseEvents

Ottiene un valore che indica se il componente può generare un evento.Gets a value indicating whether the component can raise an event.

(Inherited from Component)
Container Container Container Container

Ottiene il IContainer che contiene il Component.Gets the IContainer that contains the Component.

(Inherited from Component)
DesignMode DesignMode DesignMode DesignMode

Ottiene un valore che indica se il Component si trova in modalità progettazione.Gets a value that indicates whether the Component is currently in design mode.

(Inherited from Component)
Events Events Events Events

Ottiene l'elenco dei gestori eventi allegati a questo Component.Gets the list of event handlers that are attached to this Component.

(Inherited from Component)
Handle Handle Handle Handle

Ottiene un valore che rappresenta l'handle della finestra per il menu.Gets a value representing the window handle for the menu.

(Inherited from Menu)
IsParent IsParent IsParent IsParent

Ottiene un valore che indica se questo menu contiene voci di menu.Gets a value indicating whether this menu contains any menu items. Questa proprietà è di sola lettura.This property is read-only.

(Inherited from Menu)
MdiListItem MdiListItem MdiListItem MdiListItem

Ottiene un valore che indica l'oggetto MenuItem utilizzato per visualizzare un elenco di form figlio Multiple Document Interface (MDI).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

Ottiene un valore che indica l'insieme degli oggetti MenuItem associato al menu.Gets a value indicating the collection of MenuItem objects associated with the menu.

(Inherited from Menu)
Name Name Name Name

Ottiene o imposta il nome di Menu.Gets or sets the name of the Menu.

(Inherited from Menu)
RightToLeft RightToLeft RightToLeft RightToLeft

Ottiene o imposta un valore che indica se la visualizzazione del testo del controllo procede da destra a sinistra.Gets or sets a value indicating whether text displayed by the control is displayed from right to left.

Site Site Site Site

Ottiene o imposta l'oggetto ISite di Component.Gets or sets the ISite of the Component.

(Inherited from Component)
SourceControl SourceControl SourceControl SourceControl

Ottiene il controllo in cui è visualizzato il menu di scelta rapida.Gets the control that is displaying the shortcut menu.

Tag Tag Tag Tag

Ottiene o imposta dati definiti dall'utente associati al controllo.Gets or sets user-defined data associated with the control.

(Inherited from Menu)

Metodi

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

Copia l'oggetto Menu passato come parametro all'oggetto Menu corrente.Copies the Menu that is passed as a parameter to the current Menu.

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

Crea un nuovo handle per l'oggetto Menu.Creates a new handle to the Menu.

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

Consente di creare un oggetto che contiene tutte le informazioni rilevanti necessarie per la generazione del proxy utilizzato per effettuare la comunicazione con un oggetto remoto.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()

Rilascia tutte le risorse usate da Component.Releases all resources used by the Component.

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

Elimina le risorse, diverse dalla memoria, usate da Menu.Disposes of the resources, other than memory, used by the Menu.

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

Determina se l'oggetto specificato è uguale all'oggetto corrente.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)

Ottiene l'oggetto MenuItem che contiene il valore specificato.Gets the MenuItem that contains the value specified.

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

Restituisce la posizione in cui dovrebbe essere inserita una voce all'interno del menu.Returns the position at which a menu item should be inserted into the menu.

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

Ottiene l'oggetto ContextMenu che contiene questo menu.Gets the ContextMenu that contains this menu.

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

Funge da funzione hash predefinita.Serves as the default hash function.

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

Consente di recuperare l'oggetto servizio di durata corrente per controllare i criteri di durata per l'istanza.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

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

Ottiene l'oggetto MainMenu che contiene questo menu.Gets the MainMenu that contains this menu.

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

Consente di restituire un oggetto che rappresenta un servizio fornito da Component o dal relativo Container.Returns an object that represents a service provided by the Component or by its Container.

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

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

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

Ottiene un oggetto servizio di durata per controllare i criteri di durata per questa istanza.Obtains a lifetime service object to control the lifetime policy for this instance.

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

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

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

Crea una copia dei riferimenti dell'oggetto MarshalByRefObject corrente.Creates a shallow copy of the current MarshalByRefObject object.

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

Unisce gli oggetti MenuItem di un menu con il menu corrente.Merges the MenuItem objects of one menu with the current menu.

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

Genera l'evento Collapse.Raises the Collapse event.

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

Genera l'evento Popup.Raises the Popup event

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

Elabora un tasto di comando.Processes a command key.

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

Elabora un tasto di comando.Processes a command key.

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

Visualizza il menu di scelta rapida nella posizione specificata.Displays the shortcut menu at the specified position.

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

Visualizza il menu di scelta rapida in una determinata posizione con l'allineamento specificato.Displays the shortcut menu at the specified position and with the specified alignment.

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

Restituisce una stringa String che rappresenta il controllo Menu.Returns a String that represents the Menu control.

(Inherited from Menu)

Eventi

Collapse Collapse Collapse Collapse

Si verifica quando un menu di scelta rapida viene compresso.Occurs when the shortcut menu collapses.

Disposed Disposed Disposed Disposed

Si verifica quando il componente viene eliminato da una chiamata al metodo Dispose().Occurs when the component is disposed by a call to the Dispose() method.

(Inherited from Component)
Popup Popup Popup Popup

Viene generato prima della visualizzazione del menu di scelta rapida.Occurs before the shortcut menu is displayed.

Campi

FindHandle FindHandle FindHandle FindHandle

Specifica che il metodo FindMenuItem(Int32, IntPtr) deve eseguire la ricerca di un handle.Specifies that the FindMenuItem(Int32, IntPtr) method should search for a handle.

(Inherited from Menu)
FindShortcut FindShortcut FindShortcut FindShortcut

Specifica che il metodo FindMenuItem(Int32, IntPtr) deve eseguire la ricerca di un collegamento.Specifies that the FindMenuItem(Int32, IntPtr) method should search for a shortcut.

(Inherited from Menu)

Si applica a

Vedi anche