ContextMenu.Show Método

Definición

Muestra el menú contextual en la posición especificada.Displays the shortcut menu at the specified position.

Sobrecargas

Show(Control, Point)

Muestra el menú contextual en la posición especificada.Displays the shortcut menu at the specified position.

Show(Control, Point, LeftRightAlignment)

Muestra el menú contextual en la posición y con la alineación especificadas.Displays the shortcut menu at the specified position and with the specified alignment.

Show(Control, Point)

Muestra el menú contextual en la posición especificada.Displays the shortcut menu at the specified position.

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.A Control that specifies the control with which this shortcut menu is associated.

pos
Point

Point que especifica las coordenadas en las que mostrar el menú.A Point that specifies the coordinates at which to display the menu. Estas coordenadas se especifican respecto a las coordenadas de cliente del control especificado en el parámetro control.These coordinates are specified relative to the client coordinates of the control specified in the control parameter.

Excepciones

El parámetro control es null.The control parameter is null.

El identificador del control no existe o el control no está visible.The handle of the control does not exist or the control is not visible.

Ejemplos

En el ejemplo de código siguiente se muestra cómo construir un menú contextual y utilizar el Show método.The following code example demonstrates constructing a shortcut menu and using the Show method. Para ejecutar el ejemplo, pegue el código siguiente en un formulario que contenga un botón denominado Button1.To run the example, paste the following code in a form containing a button named Button1. Asegúrese de que todos los eventos estén asociados a sus métodos de control de eventos.Ensure all events are associated with their event-handling methods.

// 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, ContextMenu se muestra cuando el usuario hace clic con el botón secundario del mouse en un control o área del formulario al que ContextMenu está enlazado.Typically, a ContextMenu is displayed when the user clicks the right mouse button on a control or area of the form that the ContextMenu is bound to. Puede usar este método para mostrar manualmente el menú contextual en una ubicación específica y enlazarlo con un control concreto.You can use this method to manually display the shortcut menu at a specific location and bind it with a specific control. Este método no devuelve ningún resultado hasta que se descarta el menú.This method does not return until the menu is dismissed.

Se aplica a

Show(Control, Point, LeftRightAlignment)

Muestra el menú contextual en la posición y con la alineación especificadas.Displays the shortcut menu at the specified position and with the specified alignment.

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.A Control that specifies the control with which this shortcut menu is associated.

pos
Point

Point que especifica las coordenadas en las que mostrar el menú.A Point that specifies the coordinates at which to display the menu. Estas coordenadas se especifican respecto a las coordenadas de cliente del control especificado en el parámetro control.These coordinates are specified relative to the client coordinates of the control specified in the control parameter.

alignment
LeftRightAlignment

LeftRightAlignment que especifica la alineación del control con relación al parámetro pos.A LeftRightAlignment that specifies the alignment of the control relative to the pos parameter.

Se aplica a