通过

ToolTip.Show 方法

  • 参考

定义

命名空间:
System.Windows.Forms
程序集:
System.Windows.Forms.dll

设置与工具提示关联的文本，然后显示它。

重载

Show(String, IWin32Window, Int32, Int32)

设置与指定控件关联的工具提示文本，然后在指定相对位置以模式显示工具提示。
Show(String, IWin32Window, Point, Int32)

设置与指定控件关联的工具提示文本，然后在指定相对位置显示指定持续时间的工具提示。
Show(String, IWin32Window, Int32, Int32, Int32)

设置与指定控件关联的工具提示文本，然后在指定相对位置显示指定持续时间的工具提示。
Show(String, IWin32Window, Point)

设置与指定控件关联的工具提示文本，然后在指定相对位置以模式显示工具提示。
Show(String, IWin32Window)

设置与指定控件关联的工具提示文本，并按模式显示工具提示。
Show(String, IWin32Window, Int32)

设置与指定控件关联的工具提示文本，然后显示指定持续时间的工具提示。

Show(String, IWin32Window, Int32, Int32)

设置与指定控件关联的工具提示文本，然后在指定相对位置以模式显示工具提示。

public:
 void Show(System::String ^ text, System::Windows::Forms::IWin32Window ^ window, int x, int y);
public void Show (string text, System.Windows.Forms.IWin32Window window, int x, int y);
public void Show (string? text, System.Windows.Forms.IWin32Window window, int x, int y);
member this.Show : string * System.Windows.Forms.IWin32Window * int * int -> unit
Public Sub Show (text As String, window As IWin32Window, x As Integer, y As Integer)

参数

text
String

包含新工具提示文本的 String。

window
IWin32Window

要为其显示工具提示的 Control。

x
Int32

相对于关联控件窗口左上角的水平偏移量（以像素为单位），以显示工具提示。

y
Int32

相对于关联控件窗口左上角的垂直偏移量（以像素为单位），以显示工具提示。

注解

此版本的重载 Show 方法与 Show(String, IWin32Window, Point) 版本相同，只是偏移量指定为单独的 x 坐标和 y 坐标，而不是 Point。

在部分信任中运行的应用程序必须断言使用此方法 AllWindows 权限，因为 Show 可以控制独立于用户操作的工具提示的显示和位置。

另请参阅

适用于

Show(String, IWin32Window, Point, Int32)

设置与指定控件关联的工具提示文本，然后在指定相对位置显示指定持续时间的工具提示。

public:
 void Show(System::String ^ text, System::Windows::Forms::IWin32Window ^ window, System::Drawing::Point point, int duration);
public void Show (string text, System.Windows.Forms.IWin32Window window, System.Drawing.Point point, int duration);
public void Show (string? text, System.Windows.Forms.IWin32Window window, System.Drawing.Point point, int duration);
member this.Show : string * System.Windows.Forms.IWin32Window * System.Drawing.Point * int -> unit
Public Sub Show (text As String, window As IWin32Window, point As Point, duration As Integer)

参数

text
String

包含新工具提示文本的 String。

window
IWin32Window

要为其显示工具提示的 Control。

point
Point

一个 Point，包含相对于关联控件窗口左上角的偏移量（以像素为单位），以显示工具提示。

duration
Int32

包含显示工具提示的持续时间（以毫秒为单位）的 Int32。

例外

ArgumentNullException

window 参数 null。

ArgumentOutOfRangeException

duration 小于或等于 0。

注解

pt 参数可以指定关联控件边界之外的位置、其父窗体甚至桌面。 工具提示位于关联控件的中心。 若要以模式方式显示工具提示，请改为调用 Show(String, IWin32Window, Point) 重载版本的此方法。

在部分信任中运行的应用程序必须断言使用此方法 AllWindows 权限，因为 Show 可以控制独立于用户操作的工具提示的显示和位置。

另请参阅

适用于

Show(String, IWin32Window, Int32, Int32, Int32)

设置与指定控件关联的工具提示文本，然后在指定相对位置显示指定持续时间的工具提示。

public:
 void Show(System::String ^ text, System::Windows::Forms::IWin32Window ^ window, int x, int y, int duration);
public void Show (string text, System.Windows.Forms.IWin32Window window, int x, int y, int duration);
public void Show (string? text, System.Windows.Forms.IWin32Window window, int x, int y, int duration);
member this.Show : string * System.Windows.Forms.IWin32Window * int * int * int -> unit
Public Sub Show (text As String, window As IWin32Window, x As Integer, y As Integer, duration As Integer)

参数

text
String

包含新工具提示文本的 String。

window
IWin32Window

要为其显示工具提示的 Control。

x
Int32

相对于关联控件窗口左上角的水平偏移量（以像素为单位），以显示工具提示。

y
Int32

相对于关联控件窗口左上角的垂直偏移量（以像素为单位），以显示工具提示。

duration
Int32

包含显示工具提示的持续时间（以毫秒为单位）的 Int32。

例外

ArgumentNullException

window 参数 null。

ArgumentOutOfRangeException

duration 小于或等于 0。

注解

此版本的重载 Show 方法与 Show(String, IWin32Window, Point, Int32) 版本相同，但偏移量指定为单独的 x 和 y 坐标，而不是 Point。 若要以模式方式显示工具提示，请改为调用 Show(String, IWin32Window, Int32, Int32) 重载版本的此方法。

在部分信任中运行的应用程序必须断言使用此方法 AllWindows 权限，因为 Show 可以控制独立于用户操作的工具提示的显示和位置。

另请参阅

适用于

Show(String, IWin32Window, Point)

设置与指定控件关联的工具提示文本，然后在指定相对位置以模式显示工具提示。

public:
 void Show(System::String ^ text, System::Windows::Forms::IWin32Window ^ window, System::Drawing::Point point);
public void Show (string text, System.Windows.Forms.IWin32Window window, System.Drawing.Point point);
public void Show (string? text, System.Windows.Forms.IWin32Window window, System.Drawing.Point point);
member this.Show : string * System.Windows.Forms.IWin32Window * System.Drawing.Point -> unit
Public Sub Show (text As String, window As IWin32Window, point As Point)

参数

text
String

包含新工具提示文本的 String。

window
IWin32Window

要为其显示工具提示的 Control。

point
Point

一个 Point，包含相对于关联控件窗口左上角的偏移量（以像素为单位），以显示工具提示。

例外

ArgumentNullException

window 参数 null。

注解

pt 参数可以指定关联控件边界之外的位置、其父窗体甚至桌面。 Show 方法的版本以模式方式显示指定控件的工具提示;也就是说，将显示工具提示，直到调用 Hide 方法，或直到父窗体最小化、隐藏或消除为止。

在部分信任中运行的应用程序必须断言使用此方法 AllWindows 权限，因为 Show 可以控制独立于用户操作的工具提示的显示和位置。

另请参阅

适用于

Show(String, IWin32Window)

设置与指定控件关联的工具提示文本，并按模式显示工具提示。

public:
 void Show(System::String ^ text, System::Windows::Forms::IWin32Window ^ window);
public void Show (string text, System.Windows.Forms.IWin32Window window);
public void Show (string? text, System.Windows.Forms.IWin32Window window);
member this.Show : string * System.Windows.Forms.IWin32Window -> unit
Public Sub Show (text As String, window As IWin32Window)

参数

text
String

包含新工具提示文本的 String。

window
IWin32Window

要为其显示工具提示的 Control。

例外

ArgumentNullException

window 参数 null。

注解

Show 方法的版本以模式方式显示指定控件的工具提示;也就是说，将显示工具提示，直到调用 Hide 方法，或直到父窗体最小化、隐藏或关闭为止。 工具提示位于关联控件的中心。

在部分信任中运行的应用程序必须断言使用此方法 AllWindows 权限，因为 Show 可以控制独立于用户操作的工具提示的显示和位置。

另请参阅

适用于

Show(String, IWin32Window, Int32)

设置与指定控件关联的工具提示文本，然后显示指定持续时间的工具提示。

public:
 void Show(System::String ^ text, System::Windows::Forms::IWin32Window ^ window, int duration);
public void Show (string text, System.Windows.Forms.IWin32Window window, int duration);
public void Show (string? text, System.Windows.Forms.IWin32Window window, int duration);
member this.Show : string * System.Windows.Forms.IWin32Window * int -> unit
Public Sub Show (text As String, window As IWin32Window, duration As Integer)

参数

text
String

包含新工具提示文本的 String。

window
IWin32Window

要为其显示工具提示的 Control。

duration
Int32

包含显示工具提示的持续时间（以毫秒为单位）的 Int32。

例外

ArgumentNullException

window 参数 null。

ArgumentOutOfRangeException

duration 小于或等于 0。

注解

工具提示位于由 win 参数表示的关联控件的中心。 若要以模式方式显示工具提示，请改为调用 Show(String, IWin32Window) 重载版本的此方法。

在部分信任中运行的应用程序必须断言使用此方法 AllWindows 权限，因为 Show 可以控制独立于用户操作的工具提示的显示和位置。

另请参阅

适用于