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);

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 坐标，而不是 Pointy 坐标。

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

另请参阅

• Hide(IWin32Window)
• GetToolTip(Control)
• SetToolTip(Control, String)
• IsBalloon
• StripAmpersands
• ToolTipTitle
• ToolTipIcon
• OwnerDraw
• Popup

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);

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 可以控制独立于用户操作的工具提示的显示和位置。

另请参阅

• Hide(IWin32Window)
• GetToolTip(Control)
• SetToolTip(Control, String)
• IsBalloon
• StripAmpersands
• ToolTipTitle
• ToolTipIcon
• OwnerDraw
• Popup

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);

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 坐标，而不是 Pointy 坐标。 若要以模式显示工具提示，请改为调用 Show(String, IWin32Window, Int32, Int32) 此方法的重载版本。

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

另请参阅

• Hide(IWin32Window)
• GetToolTip(Control)
• SetToolTip(Control, String)
• IsBalloon
• StripAmpersands
• ToolTipTitle
• ToolTipIcon
• OwnerDraw
• Popup

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);

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 可以控制独立于用户操作的工具提示的显示和位置。

另请参阅

• Hide(IWin32Window)
• GetToolTip(Control)
• SetToolTip(Control, String)
• IsBalloon
• StripAmpersands
• ToolTipTitle
• ToolTipIcon
• OwnerDraw
• Popup

Show(String, IWin32Window)

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

public:
 void Show(System::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 可以控制独立于用户操作的工具提示的显示和位置。

另请参阅

• Hide(IWin32Window)
• GetToolTip(Control)
• SetToolTip(Control, String)
• IsBalloon
• StripAmpersands
• ToolTipTitle
• ToolTipIcon
• OwnerDraw
• Popup

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);

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 可以控制独立于用户操作的工具提示的显示和位置。

另请参阅

• Hide(IWin32Window)
• GetToolTip(Control)
• SetToolTip(Control, String)
• IsBalloon
• StripAmpersands
• ToolTipTitle
• ToolTipIcon
• OwnerDraw
• Popup