ContextMenu.Show Methode

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Zeigt das Kontextmenü an der angegebenen Position an.

Überlädt

Show(Control, Point)	Zeigt das Kontextmenü an der angegebenen Position an.
Show(Control, Point, LeftRightAlignment)	Zeigt das Kontextmenü an der angegebenen Position und mit der angegebenen Ausrichtung an.

Show(Control, Point)

Zeigt das Kontextmenü an der angegebenen Position an.

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)

Parameter

control

Control

Ein Control-Objekt, das das Steuerelement angibt, dem dieses Kontextmenü zugeordnet ist.

pos

Point

Ein Point-Objekt, das die Koordinaten angibt, an denen das Menü angezeigt werden soll. Diese Koordinaten werden relativ zu den im control-Parameter festgelegten Clientkoordinaten des Steuerelements angegeben.

Ausnahmen

ArgumentNullException

Der control-Parameter ist null.

ArgumentException

Das Handle des Steuerelements ist nicht vorhanden, oder das Steuerelement ist nicht sichtbar.

Beispiele

Im folgenden Codebeispiel wird das Erstellen eines Kontextmenüs und die Verwendung der Show -Methode veranschaulicht. Fügen Sie zum Ausführen des Beispiels den folgenden Code in ein Formular ein, das eine Schaltfläche mit dem Namen Button1 enthält. Stellen Sie sicher, dass alle Ereignisse ihren Ereignisbehandlungsmethoden zugeordnet sind.

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

Hinweise

In der Regel wird ein ContextMenu angezeigt, wenn der Benutzer auf ein Steuerelement oder einen Bereich des Formulars mit der rechten Maustaste klickt, an das das ContextMenu gebunden ist. Sie können diese Methode verwenden, um das Kontextmenü manuell an einer bestimmten Stelle anzuzeigen und an ein bestimmtes Steuerelement zu binden. Diese Methode wird erst zurückgegeben, wenn das Menü geschlossen wird.

Show(Control, Point, LeftRightAlignment)

Zeigt das Kontextmenü an der angegebenen Position und mit der angegebenen Ausrichtung an.

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)

Parameter

control

Control

Ein Control-Objekt, das das Steuerelement angibt, dem dieses Kontextmenü zugeordnet ist.

pos

Point

Ein Point-Objekt, das die Koordinaten angibt, an denen das Menü angezeigt werden soll. Diese Koordinaten werden relativ zu den im control-Parameter festgelegten Clientkoordinaten des Steuerelements angegeben.

alignment

LeftRightAlignment

Eine LeftRightAlignment, die die Ausrichtung des Steuerelements relativ zum pos-Parameter angibt.