ToolStripDropDown.Show Method

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Positions the ToolStripDropDown relative to the specified coordinates.

Overloads

Show()	Displays the ToolStripDropDown control in its default position.
Show(Point)	Positions the ToolStripDropDown relative to the specified screen location.
Show(Point, ToolStripDropDownDirection)	Positions the ToolStripDropDown relative to the specified control location and with the specified direction relative to the parent control.
Show(Int32, Int32)	Positions the ToolStripDropDown relative to the specified screen coordinates.
Show(Control, Point)	Positions the ToolStripDropDown relative to the specified control location.
Show(Control, Point, ToolStripDropDownDirection)	Positions the ToolStripDropDown relative to the specified control at the specified location and with the specified direction relative to the parent control.
Show(Control, Int32, Int32)	Positions the ToolStripDropDown relative to the specified control's horizontal and vertical screen coordinates.

Show()

Displays the ToolStripDropDown control in its default position.

public:
 void Show();

[System.ComponentModel.Browsable(false)]
public void Show ();

[<System.ComponentModel.Browsable(false)>]
override this.Show : unit -> unit

Public Sub Show ()

Attributes

BrowsableAttribute

Examples

The following code example demonstrates how to display the ToolStripDropDown control at its default position.

// This method calls the ToolStripDropDown control's Show 
// method to display the ContextMenuStrip in its 
// default location.
private void showButton_Click(object sender, EventArgs e)
{
    this.contextMenuStrip1.Show();
}

' This method calls the ToolStripDropDown control's Show 
' method to display the ContextMenuStrip in its 
' default location.
Private Sub showButton_Click(sender As Object, e As EventArgs) Handles showButton.Click
   Me.contextMenuStrip1.Show()
 End Sub

Show(Point)

Positions the ToolStripDropDown relative to the specified screen location.

public:
 void Show(System::Drawing::Point screenLocation);

public void Show (System.Drawing.Point screenLocation);

override this.Show : System.Drawing.Point -> unit

Public Sub Show (screenLocation As Point)

Parameters

screenLocation

Point

The horizontal and vertical location of the screen's upper-left corner, in pixels.

Examples

The following code example demonstrates how to display the ToolStripDropDown control at a fixed point.

// This method calls the ToolStripDropDown control's Show 
// method to display the ContextMenuStrip at a fixed point.
private void showAtPointButton_Click(object sender, EventArgs e)
{
    this.contextMenuStrip1.Show(23, 55);
}

' This method calls the ToolStripDropDown control's Show 
' method to display the ContextMenuStrip at a fixed point.
Private Sub showAtPointButton_Click(sender As Object, e As EventArgs) Handles showAtPointButton.Click, button2.Click
   Me.contextMenuStrip1.Show(23, 55)
 End Sub

Show(Point, ToolStripDropDownDirection)

Positions the ToolStripDropDown relative to the specified control location and with the specified direction relative to the parent control.

public:
 void Show(System::Drawing::Point position, System::Windows::Forms::ToolStripDropDownDirection direction);

public void Show (System.Drawing.Point position, System.Windows.Forms.ToolStripDropDownDirection direction);

override this.Show : System.Drawing.Point * System.Windows.Forms.ToolStripDropDownDirection -> unit

Public Sub Show (position As Point, direction As ToolStripDropDownDirection)

Parameters

position

Point

The horizontal and vertical location of the reference control's upper-left corner, in pixels.

direction

ToolStripDropDownDirection

One of the ToolStripDropDownDirection values.

Examples

The following code example demonstrates how to display the ToolStripDropDown control at a fixed point in the specified direction.

// This method calls the ToolStripDropDown control's Show 
// method to display the ContextMenuStrip relative to the
// origin of the form. 
private void showRelativeButton_Click(object sender, EventArgs e)
{
    this.contextMenuStrip1.Show(this.Location, this.dropDownDirection);
}

' This method calls the ToolStripDropDown control's Show 
' method to display the ContextMenuStrip relative to the
' origin of the form. 
Private Sub showRelativeButton_Click(sender As Object, e As EventArgs)
   Me.contextMenuStrip1.Show(Me.Location, Me.dropDownDirection)
 End Sub

Show(Int32, Int32)

Positions the ToolStripDropDown relative to the specified screen coordinates.

public:
 void Show(int x, int y);

public void Show (int x, int y);

override this.Show : int * int -> unit

Public Sub Show (x As Integer, y As Integer)

Parameters

x

Int32

The horizontal screen coordinate, in pixels.

y

Int32

The vertical screen coordinate, in pixels.

Show(Control, Point)

Positions the ToolStripDropDown relative to the specified control location.

public:
 void Show(System::Windows::Forms::Control ^ control, System::Drawing::Point position);

public void Show (System.Windows.Forms.Control control, System.Drawing.Point position);

override this.Show : System.Windows.Forms.Control * System.Drawing.Point -> unit

Public Sub Show (control As Control, position As Point)

Parameters

control

Control

The control (typically, a ToolStripDropDownButton) that is the reference point for the ToolStripDropDown position.

position

Point

The horizontal and vertical location of the reference control's upper-left corner, in pixels.

Exceptions

ArgumentNullException

The control specified by the control parameter is null.

Show(Control, Point, ToolStripDropDownDirection)

Positions the ToolStripDropDown relative to the specified control at the specified location and with the specified direction relative to the parent control.

public:
 void Show(System::Windows::Forms::Control ^ control, System::Drawing::Point position, System::Windows::Forms::ToolStripDropDownDirection direction);

public void Show (System.Windows.Forms.Control control, System.Drawing.Point position, System.Windows.Forms.ToolStripDropDownDirection direction);

override this.Show : System.Windows.Forms.Control * System.Drawing.Point * System.Windows.Forms.ToolStripDropDownDirection -> unit

Public Sub Show (control As Control, position As Point, direction As ToolStripDropDownDirection)

Parameters

control

Control

The control (typically, a ToolStripDropDownButton) that is the reference point for the ToolStripDropDown position.

position

Point

The horizontal and vertical location of the reference control's upper-left corner, in pixels.

direction

ToolStripDropDownDirection

One of the ToolStripDropDownDirection values.

Exceptions

ArgumentNullException

The control specified by the control parameter is null.

Examples

The following code example demonstrates how to display the ToolStripDropDown control relative to the parent control.

// This method calls the ToolStripDropDown control's Show 
// method to display the ContextMenuStrip relative to the
// owning control.
private void button1_MouseUp(object sender, MouseEventArgs e)
{
    Control c = sender as Control;
    if (e.Button == MouseButtons.Right)
    {
        this.contextMenuStrip1.Show(c, e.Location, this.dropDownDirection);
    }
}

' This method calls the ToolStripDropDown control's Show 
' method to display the ContextMenuStrip relative to the
' owning control.
Private Sub button1_MouseUp(sender As Object, e As MouseEventArgs) Handles button1.MouseUp
     Dim c As Control = CType(sender, Control)
   
     If e.Button = Windows.Forms.MouseButtons.Right Then
         Me.contextMenuStrip1.Show(c, e.Location, Me.dropDownDirection)
     End If
 End Sub

Show(Control, Int32, Int32)

Positions the ToolStripDropDown relative to the specified control's horizontal and vertical screen coordinates.

public:
 void Show(System::Windows::Forms::Control ^ control, int x, int y);

public void Show (System.Windows.Forms.Control control, int x, int y);

override this.Show : System.Windows.Forms.Control * int * int -> unit

Public Sub Show (control As Control, x As Integer, y As Integer)

Parameters

control

Control

The control (typically, a ToolStripDropDownButton) that is the reference point for the ToolStripDropDown position.

x

Int32

The horizontal screen coordinate of the control, in pixels.

y

Int32

The vertical screen coordinate of the control, in pixels.

Exceptions

ArgumentNullException

The control specified by the control parameter is null.