Linguagem

Control.ContextMenu Propriedade

Definição

Atenção

ContextMenu is provided for binary compatibility with .NET Framework and is not intended to be used directly from your code. Use ContextMenuStrip instead.

Recebe ou define o menu de atalho associado ao controlo.

public:
 virtual property System::Windows::Forms::ContextMenu ^ ContextMenu { System::Windows::Forms::ContextMenu ^ get(); void set(System::Windows::Forms::ContextMenu ^ value); };
public virtual System.Windows.Forms.ContextMenu ContextMenu { get; set; }
[System.ComponentModel.Browsable(false)]
public virtual System.Windows.Forms.ContextMenu ContextMenu { get; set; }
[System.ComponentModel.Browsable(false)]
[System.Obsolete("`ContextMenu` is provided for binary compatibility with .NET Framework and is not intended to be used directly from your code. Use `ContextMenuStrip` instead.", false, DiagnosticId="WFDEV006", UrlFormat="https://aka.ms/winforms-warnings/{0}")]
public virtual System.Windows.Forms.ContextMenu ContextMenu { get; set; }
member this.ContextMenu : System.Windows.Forms.ContextMenu with get, set
[<System.ComponentModel.Browsable(false)>]
member this.ContextMenu : System.Windows.Forms.ContextMenu with get, set
[<System.ComponentModel.Browsable(false)>]
[<System.Obsolete("`ContextMenu` is provided for binary compatibility with .NET Framework and is not intended to be used directly from your code. Use `ContextMenuStrip` instead.", false, DiagnosticId="WFDEV006", UrlFormat="https://aka.ms/winforms-warnings/{0}")>]
member this.ContextMenu : System.Windows.Forms.ContextMenu with get, set
Public Overridable Property ContextMenu As ContextMenu

Valor de Propriedade

A ContextMenu que representa o menu de atalho associado ao controlo.

Atributos

Exemplos

O seguinte exemplo de código mostra o ContextMenu que é atribuído a TreeView quando o botão direito do rato é clicado e libertado. Este código exige que tenhas um Form com um TreeView com a nele. Também é exigido que tenha TreeView um ContextMenu atribuído à sua ContextMenu propriedade.

private:
   void treeView1_MouseUp( Object^ /*sender*/, MouseEventArgs^ e )
   {
      // If the right mouse button was clicked and released,
      // display the shortcut menu assigned to the TreeView.
      if ( e->Button == ::MouseButtons::Right )
      {
         treeView1->ContextMenu->Show( treeView1, Point(e->X,e->Y) );
      }
   }
private void treeView1_MouseUp(object sender, MouseEventArgs e)
{
   // If the right mouse button was clicked and released,
   // display the shortcut menu assigned to the TreeView. 
   if(e.Button == MouseButtons.Right)
   {
      treeView1.ContextMenu.Show(treeView1, new Point(e.X, e.Y) );      
   }
}
Private Sub treeView1_MouseUp(sender As Object, _
  e As MouseEventArgs) Handles treeView1.MouseUp
   ' If the right mouse button was clicked and released,
   ' display the shortcut menu assigned to the TreeView. 
   If e.Button = MouseButtons.Right Then
      treeView1.ContextMenu.Show(treeView1, New Point(e.X, e.Y))
   End If
End Sub

Observações

Use um menu de atalho para oferecer opções específicas de menu contextuais aos utilizadores quando clicam com o botão direito no controlo.

Notas para Herdeiros

Ao sobrescrever a ContextMenu propriedade numa classe derivada, use a propriedade da ContextMenu classe base para estender a implementação base. Caso contrário, deve fornecer toda a implementação. Não é obrigado a anular ambos os get acessórios da set propriedadeContextMenu; só pode anular um, se necessário.

Aplica-se a

Ver também