NotifyIcon.ShowBalloonTip 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
在工作列中顯示氣球提示。
多載
ShowBalloonTip(Int32) |
在指定時段內,於工作列中顯示氣球提示。 |
ShowBalloonTip(Int32, String, String, ToolTipIcon) |
在指定時段內,於工作列中顯示具有指定標題、文字和圖示的氣球提示。 |
ShowBalloonTip(Int32)
在指定時段內,於工作列中顯示氣球提示。
public:
void ShowBalloonTip(int timeout);
public void ShowBalloonTip (int timeout);
member this.ShowBalloonTip : int -> unit
Public Sub ShowBalloonTip (timeout As Integer)
參數
- timeout
- Int32
氣球提示應該顯示的時段 (以毫秒為單位)。 此參數已被取代。 通知顯示時間現在會根據系統協助工具設定。
例外狀況
timeout
小於 0。
範例
下列程式碼範例會示範如何使用 ShowBalloonTip 方法。 若要執行此範例,請將範例程式碼貼到包含 NotifyIcon 具名 notifyIcon1
的 Windows Form 中。 從表單的建構函式或 Load 事件處理方法呼叫 SetBalloonTip
。
private void SetBalloonTip()
{
notifyIcon1.Icon = SystemIcons.Exclamation;
notifyIcon1.BalloonTipTitle = "Balloon Tip Title";
notifyIcon1.BalloonTipText = "Balloon Tip Text.";
notifyIcon1.BalloonTipIcon = ToolTipIcon.Error;
this.Click += new EventHandler(Form1_Click);
}
void Form1_Click(object sender, EventArgs e)
{
notifyIcon1.Visible = true;
notifyIcon1.ShowBalloonTip(30000);
}
Private Sub SetBalloonTip()
notifyIcon1.Icon = SystemIcons.Exclamation
notifyIcon1.BalloonTipTitle = "Balloon Tip Title"
notifyIcon1.BalloonTipText = "Balloon Tip Text."
notifyIcon1.BalloonTipIcon = ToolTipIcon.Error
End Sub
Sub Form1_Click(ByVal sender As Object, ByVal e As EventArgs) _
Handles Me.Click
notifyIcon1.Visible = True
notifyIcon1.ShowBalloonTip(30000)
End Sub
備註
作業系統會強制執行最小和最大逾時值,而且通常分別為 10 和 30 秒,不過這可能會因作業系統而異。 太大或太小的逾時值會調整為適當的最小值或最大值。 此外,如果使用者似乎未使用電腦, (沒有發生鍵盤或滑鼠事件) 則系統不會將此時間計入逾時。
一次只能顯示一個方塊提示在工作列上。 當工作列上目前顯示一個方塊提示時,嘗試顯示方塊提示會導致 timeout
忽略值。 此行為會根據作業系統稍有不同,以及批註提示是來自另一個或相同的應用程式。 當第二個批註提示來自另一個應用程式時,第一個方塊提示會顯示在第二個出現前的最小逾時值,而不論 的值 timeout
為何。 在大部分情況下,如果批註提示來自相同的應用程式,則第一個氣球提示會在進行方法的另一個呼叫 ShowBalloonTip 時立即關閉。 在某些情況下,第二個方塊會在第一個批註方塊頂端開啟。
標題文字會顯示在方塊頂端附近的粗體字型。
適用於
ShowBalloonTip(Int32, String, String, ToolTipIcon)
在指定時段內,於工作列中顯示具有指定標題、文字和圖示的氣球提示。
public:
void ShowBalloonTip(int timeout, System::String ^ tipTitle, System::String ^ tipText, System::Windows::Forms::ToolTipIcon tipIcon);
public void ShowBalloonTip (int timeout, string tipTitle, string tipText, System.Windows.Forms.ToolTipIcon tipIcon);
member this.ShowBalloonTip : int * string * string * System.Windows.Forms.ToolTipIcon -> unit
Public Sub ShowBalloonTip (timeout As Integer, tipTitle As String, tipText As String, tipIcon As ToolTipIcon)
參數
- timeout
- Int32
氣球提示應該顯示的時段 (以毫秒為單位)。 此參數已被取代。 通知顯示時間現在會根據系統協助工具設定。
- tipTitle
- String
要顯示在氣球提示上的標題。
- tipText
- String
要顯示在氣球提示上的文字。
- tipIcon
- ToolTipIcon
其中一個 ToolTipIcon 值。
例外狀況
timeout
小於 0。
tipText
為 null
或空字串。
tipIcon
不是 ToolTipIcon 的成員。
範例
下列程式碼範例會示範如何使用 ShowBalloonTip 方法。 若要執行此範例,請將範例程式碼貼到包含 NotifyIcon 具名 notifyIcon1
的 Windows Form 中。
Form1_DoubleClick
將這個範例中的 方法與表單的 DoubleClick 事件產生關聯。
void Form1_DoubleClick(object sender, EventArgs e)
{
notifyIcon1.Visible = true;
notifyIcon1.ShowBalloonTip(20000, "Information", "This is the text",
ToolTipIcon.Info );
}
Sub Form1_DoubleClick(ByVal sender As Object, ByVal e As EventArgs) _
Handles Me.DoubleClick
notifyIcon1.Visible = True
notifyIcon1.ShowBalloonTip(20000, "Information", "This is the text", _
ToolTipIcon.Info)
End Sub
備註
作業系統會強制執行最小和最大逾時值,而且通常分別為 10 和 30 秒,不過這可能會因作業系統而異。 太大或太小的逾時值會調整為適當的最小值或最大值。 此外,如果使用者似乎未使用電腦, (沒有發生鍵盤或滑鼠事件) 則系統不會將此時間計入逾時。
一次只能顯示一個方塊提示在工作列上。 當工作列上目前顯示一個方塊提示時,嘗試顯示方塊提示會導致 timeout
忽略值。 此行為會根據作業系統稍有不同,以及批註提示是來自另一個或相同的應用程式。 當第二個批註提示來自另一個應用程式時,第一個方塊提示會顯示在第二個出現前的最小逾時值,而不論 的值 timeout
為何。 在大部分情況下,如果批註提示來自相同的應用程式,則第一個氣球提示會在進行方法的另一個呼叫 ShowBalloonTip 時立即關閉。 在某些情況下,第二個方塊會在第一個批註方塊頂端開啟。
標題文字會顯示在方塊頂端附近的粗體字型。
適用於
意見反應
https://aka.ms/ContentUserFeedback。
即將登場:在 2024 年,我們將逐步淘汰 GitHub 問題作為內容的意見反應機制,並將它取代為新的意見反應系統。 如需詳細資訊,請參閱:提交並檢視相關的意見反應