ContextMenu.Show Método

Definición

Espacio de nombres:

System.Windows.Forms

Ensamblado:

System.Windows.Forms.dll

Muestra el menú contextual en la posición especificada.

Sobrecargas

Show(Control, Point)	Muestra el menú contextual en la posición especificada.
Show(Control, Point, LeftRightAlignment)	Muestra el menú contextual en la posición y con la alineación especificadas.

Show(Control, Point)

Muestra el menú contextual en la posición 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

Un control Control que especifica el control con el que está asociado este menú contextual.

pos

Point

Point que especifica las coordenadas en las que mostrar el menú. Estas coordenadas se especifican respecto a las coordenadas de cliente del control especificado en el parámetro control.

Excepciones

ArgumentNullException

El parámetro control es null.

ArgumentException

El identificador del control no existe o el control no está visible.

Ejemplos

En el ejemplo de código siguiente se muestra cómo construir un menú contextual y usar el Show método . Para ejecutar el ejemplo, pegue el código siguiente en un formulario que contenga un botón denominado Button1. Asegúrese de que todos los eventos están asociados a sus métodos de control 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

Comentarios

Normalmente, se muestra un ContextMenu elemento cuando el usuario hace clic en el botón derecho del mouse en un control o área del formulario al que ContextMenu está enlazado. Puede usar este método para mostrar manualmente el menú contextual en una ubicación específica y enlazarlo con un control específico. Este método no devuelve hasta que se descarta el menú.

Show(Control, Point, LeftRightAlignment)

Muestra el menú contextual en la posición y con la alineación especificadas.

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

Un control Control que especifica el control con el que está asociado este menú contextual.

pos

Point

Point que especifica las coordenadas en las que mostrar el menú. Estas coordenadas se especifican respecto a las coordenadas de cliente del control especificado en el parámetro control.

alignment

LeftRightAlignment

LeftRightAlignment que especifica la alineación del control con relación al parámetro pos.