This documentation is archived and is not being maintained.

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

Note: This method is new in the .NET Framework version 2.0.

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

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



A String containing the new ToolTip text.


The Control to display the ToolTip for.


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


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

Exception typeCondition


The window parameter is a null reference (Nothing in Visual Basic).


duration is less than 0.

The pt parameter can specify a position outside the bounds of the associated control, its parent form, or even the desktop. Setting the duration parameter to 0 displays the ToolTip modally; that is, the ToolTip will be displayed until the Hide method is called, or until the parent form is minimized, hidden, or closed. The ToolTip is positioned in the center of the associated control.

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.

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see System Requirements.

.NET Framework

Supported in: 2.0