ToolStripDropDown.Show Method

Reference

Definition

Namespace:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

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

Applies to

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

Applies to

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

Applies to

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.

Applies to

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.

Applies to

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

Applies to

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.

Applies to

Share via

ToolStripDropDown.Show Method

Definition

Overloads

Show()

Examples

Applies to

Show(Point)

Parameters

Examples

Applies to

Show(Point, ToolStripDropDownDirection)

Parameters

Examples

Applies to

Show(Int32, Int32)

Parameters

Applies to

Show(Control, Point)

Parameters

Exceptions

Applies to

Show(Control, Point, ToolStripDropDownDirection)

Parameters

Exceptions

Examples

Applies to

Show(Control, Int32, Int32)

Parameters

Exceptions

Applies to

Additional resources