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 座標，而不是 Point 。

在部分信任中執行的應用程式必須判斷 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 座標，而不是 Point 。 若要以模式顯示工具提示，請改為呼叫 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 顯示 ToolTip，或直到父表單最小化、隱藏或關閉為止。

在部分信任中執行的應用程式必須判斷 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 顯示 ToolTip，或直到父表單最小化、隱藏或關閉為止。 工具提示位於相關聯控制項的中心。

在部分信任中執行的應用程式必須判斷 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。

備註

ToolTip 位於 參數所代表 win 之相關聯控制項的中心。 若要以模式顯示工具提示，請改為呼叫 Show(String, IWin32Window) 這個方法的多載版本。

在部分信任中執行的應用程式必須判斷 AllWindows 提示使用此方法的許可權，因為 Show 可以控制與使用者動作無關的工具提示顯示和位置。

另請參閱

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