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)
Parameters
- text
- Type: System.String
A String containing the new ToolTip text.
- window
- Type: System.Windows.Forms.IWin32Window
The Control to display the ToolTip for.
- x
- Type: System.Int32
The horizontal offset, in pixels, relative to the upper-left corner of the associated control window, to display the ToolTip.
- y
- Type: System.Int32
The vertical offset, in pixels, relative to the upper-left corner of the associated control window, to display the ToolTip.
- duration
- Type: System.Int32
An Int32 containing the duration, in milliseconds, to display the ToolTip.
| Exception | Condition |
|---|---|
| ArgumentNullException | The window parameter is null. |
| 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.
- UIPermission
Requires AllWindows permission.
Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)
The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.