ContextMenu.Show Méthode

Définition

Espace de noms:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Affiche le menu contextuel à la position spécifiée.

Surcharges

Show(Control, Point)	Affiche le menu contextuel à la position spécifiée.
Show(Control, Point, LeftRightAlignment)	Affiche le menu contextuel à la position spécifiée et avec l'alignement spécifié.

Show(Control, Point)

Affiche le menu contextuel à la position spécifiée.

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)

Paramètres

control

Control

Control qui spécifie le contrôle auquel est associé le menu contextuel.

pos

Point

Point qui spécifie les coordonnées au niveau desquelles doit être affiché le menu. Ces coordonnées sont spécifiées par rapport aux coordonnées clientes du contrôle spécifié dans le paramètre control.

Exceptions

ArgumentNullException

Le paramètre control a la valeur null.

ArgumentException

Le handle du contrôle n'existe pas ou le contrôle n'est pas visible.

Exemples

L’exemple de code suivant illustre la construction d’un menu contextuel et l’utilisation de la Show méthode . Pour exécuter l’exemple, collez le code suivant dans un formulaire contenant un bouton nommé Button1. Vérifiez que tous les événements sont associés à leurs méthodes de gestion des événements.

// 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

Remarques

En règle générale, un ContextMenu s’affiche lorsque l’utilisateur clique sur le bouton droit de la souris sur un contrôle ou une zone du formulaire auquel ContextMenu est lié. Vous pouvez utiliser cette méthode pour afficher manuellement le menu contextuel à un emplacement spécifique et le lier à un contrôle spécifique. Cette méthode ne retourne pas tant que le menu n’est pas ignoré.

Show(Control, Point, LeftRightAlignment)

Affiche le menu contextuel à la position spécifiée et avec l'alignement spécifié.

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)

Paramètres

control

Control

Control qui spécifie le contrôle auquel est associé le menu contextuel.

pos

Point

Point qui spécifie les coordonnées au niveau desquelles doit être affiché le menu. Ces coordonnées sont spécifiées par rapport aux coordonnées clientes du contrôle spécifié dans le paramètre control.

alignment

LeftRightAlignment

LeftRightAlignment qui spécifie l'alignement du contrôle par rapport au paramètre pos.