ToolTip.Show Method (String, IWin32Window, Point, Int32)


The .NET API Reference documentation has a new home. Visit the .NET API Browser on to see the new experience.

Sets the ToolTip text associated with the specified control, and then displays the ToolTip for the specified duration at the specified relative position.

Namespace:   System.Windows.Forms
Assembly:  System.Windows.Forms (in System.Windows.Forms.dll)

public void Show(
	string text,
	IWin32Window window,
	Point point,
	int duration


Type: System.String

A String containing the new ToolTip text.

Type: System.Windows.Forms.IWin32Window

The Control to display the ToolTip for.

Type: System.Drawing.Point

A Point containing the offset, in pixels, relative to the upper-left corner of the associated control window, to display the ToolTip.

Type: System.Int32

An Int32 containing the duration, in milliseconds, to display the ToolTip.

Exception Condition

The window parameter is null.


duration is less than or equal to 0.

The pt parameter can specify a position outside the bounds of the associated control, its parent form, or even the desktop. The ToolTip is positioned in the center of the associated control. To display the ToolTip modally, call the Show(String, IWin32Window, Point) overloaded version of this method instead.

Applications running in partial trust must assert the AllWindows permission to use this method, as Show can control the display and location of a ToolTip independent of user action.


Requires AllWindows permission.

.NET Framework
Available since 2.0
Return to top