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

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,
	int x,
	int y,
	int duration
)
public void Show (
	String text, 
	IWin32Window window, 
	int x, 
	int y, 
	int duration
)
public function Show (
	text : String, 
	window : IWin32Window, 
	x : int, 
	y : int, 
	duration : int
)
Not applicable.

Parameters

text

A String containing the new ToolTip text.

window

The Control to display the ToolTip for.

x

The horizontal offset, in pixels, relative to the upper-left corner of the associated control window, to display the ToolTip.

y

The vertical offset, in pixels, relative to the upper-left corner of the associated control window, to display the ToolTip.

duration

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

Exception typeCondition

ArgumentNullException

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

ArgumentOutOfRangeException

duration is less than or equal to 0.

This version of the overloaded Show method operates identically to the Show(String,IWin32Window,Point,Int32) version, except that the offset is specified as separate x and y coordinates instead of a Point. To display the ToolTip modally, call the Show(String,IWin32Window,Int32,Int32) 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.

Windows 98, Windows Server 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 Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0, 2.0

Community Additions

ADD
Show: