ContextMenu.Show Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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
- 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
O parâmetro control
é null
.
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.
Aplica-se a
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
- 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
.