ContextMenu.Show Método

Definição

Mostra o menu de atalho na posição especificada.

Sobrecargas

Name Description
Show(Control, Point)

Mostra o menu de atalho na posição especificada.

Show(Control, Point, LeftRightAlignment)

Mostra o menu de atalhos na posição especificada e com o alinhamento especificado.

Show(Control, Point)

Mostra o menu de atalho na posição especificada.

public:
 void Show(System::Windows::Forms::Control ^ control, System::Drawing::Point pos);
public void Show(System.Windows.Forms.Control control, System.Drawing.Point pos);
member this.Show : System.Windows.Forms.Control * System.Drawing.Point -> unit
Public Sub Show (control As Control, pos As Point)

Parâmetros

control
Control

A Control que especifica o controlo com que este menu de atalho está associado.

pos
Point

A Point que especifica as coordenadas para mostrar o menu. Estas coordenadas são especificadas em relação às coordenadas cliente do controlo especificado no control parâmetro.

Exceções

O control parâmetro é null.

O cabo do comando não existe ou o comando não é visível.

Exemplos

O exemplo de código seguinte demonstra como construir um menu de atalhos e utilizar o Show método. Para executar o exemplo, cole o seguinte código numa forma contendo um botão chamado Button1. Assegure que todos os eventos estão associados aos seus métodos de gestão de eventos.

// Displays the shortcut menu, offsetting its location 
// from the upper-left corner of Button1 by 20 pixels in each direction. 
void Button1_Click( System::Object^ /*sender*/, System::EventArgs^ /*e*/ )
{
   
   //Declare the menu items and the shortcut menu.
   array<MenuItem^>^menuItems = {gcnew MenuItem( "Some Button Info" ),gcnew MenuItem( "Some Other Button Info" ),gcnew MenuItem( "Exit" )};
   System::Windows::Forms::ContextMenu^ buttonMenu = gcnew System::Windows::Forms::ContextMenu( menuItems );
   buttonMenu->Show( Button1, System::Drawing::Point( 20, 20 ) );
}

// Displays the shortcut menu, offsetting its location 
// from the upper-left corner of Button1 by 20 pixels in each direction. 
private void Button1_Click(System.Object sender, System.EventArgs e)
{

    //Declare the menu items and the shortcut menu.
    MenuItem[] menuItems = new MenuItem[]{new MenuItem("Some Button Info"), 
        new MenuItem("Some Other Button Info"), new MenuItem("Exit")};

    ContextMenu buttonMenu = new ContextMenu(menuItems);
    buttonMenu.Show(Button1, new System.Drawing.Point(20, 20));
}

' Displays the shortcut menu, offsetting its location 
' from the upper-left corner of Button1 by 20 pixels in each direction. 
Private Sub Button1_Click(ByVal sender As System.Object, _
    ByVal e As System.EventArgs) Handles Button1.Click

    'Declare the menu items and the shortcut menu.
    Dim menuItems() As MenuItem = New MenuItem() _
        {New MenuItem("Some Button Info"), _
        New MenuItem("Some Other Button Info"), _
        New MenuItem("Exit")}

    Dim buttonMenu As New ContextMenu(menuItems)
    buttonMenu.Show(Button1, New System.Drawing.Point(20, 20))
End Sub

Observações

Normalmente, a ContextMenu é exibido quando o utilizador clica no botão direito do rato num controlo ou área do formulário a que ContextMenu está vinculado. Podes usar este método para mostrar manualmente o menu de atalhos num local específico e associá-lo a um controlo específico. Este método não retorna até que o menu seja dispensado.

Aplica-se a

Show(Control, Point, LeftRightAlignment)

Mostra o menu de atalhos na posição especificada e com o alinhamento especificado.

public:
 void Show(System::Windows::Forms::Control ^ control, System::Drawing::Point pos, System::Windows::Forms::LeftRightAlignment alignment);
public void Show(System.Windows.Forms.Control control, System.Drawing.Point pos, System.Windows.Forms.LeftRightAlignment alignment);
member this.Show : System.Windows.Forms.Control * System.Drawing.Point * System.Windows.Forms.LeftRightAlignment -> unit
Public Sub Show (control As Control, pos As Point, alignment As LeftRightAlignment)

Parâmetros

control
Control

A Control que especifica o controlo com que este menu de atalho está associado.

pos
Point

A Point que especifica as coordenadas para mostrar o menu. Estas coordenadas são especificadas em relação às coordenadas cliente do controlo especificado no control parâmetro.

alignment
LeftRightAlignment

A LeftRightAlignment que especifica o alinhamento do controlo relativamente ao pos parâmetro.

Aplica-se a