ContextMenu.Show Método

Definição

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

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

Sobrecargas

Show(Control, Point)	Exibe o menu de atalho na posição especificada.
Show(Control, Point, LeftRightAlignment)	Exibe o menu de atalho na posição especificada e com o alinhamento especificado.

Show(Control, Point)

Exibe 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

Um Control que especifica o controle ao qual esse menu de atalho está associado.

pos

Point

Um Point que especifica as coordenadas na qual exibir o menu. Essas coordenadas são especificadas em relação as coordenadas do cliente do controle especificado no parâmetro control.

Exceções

ArgumentNullException

O parâmetro control é null.

ArgumentException

O identificador do controle não existe ou o controle não está visível.

Exemplos

O exemplo de código a seguir demonstra a construção de um menu de atalho e o uso do Show método. Para executar o exemplo, cole o código a seguir em um formulário que contém um botão chamado Button1. Verifique se todos os eventos estão associados aos métodos de tratamento 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

Comentários

Normalmente, um ContextMenu é exibido quando o usuário clica no botão direito do mouse em um controle ou área do formulário ao qual ele ContextMenu está associado. Você pode usar esse método para exibir manualmente o menu de atalho em um local específico e associá-lo a um controle específico. Esse método não retorna até que o menu seja ignorado.

Show(Control, Point, LeftRightAlignment)

Exibe o menu de atalho 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

Um Control que especifica o controle ao qual esse menu de atalho está associado.

pos

Point

Um Point que especifica as coordenadas na qual exibir o menu. Essas coordenadas são especificadas em relação as coordenadas do cliente do controle especificado no parâmetro control.

alignment

LeftRightAlignment

Um LeftRightAlignment que especifica o alinhamento do controle em relação ao parâmetro pos.