NotifyIcon.ShowBalloonTip 方法

  • 參考

定義

命名空間:
System.Windows.Forms
組件:
System.Windows.Forms.dll

在工作列中顯示氣球提示。

多載

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

氣球提示應該顯示的時段 (以毫秒為單位)。 此參數已被取代。 通知顯示時間現在會根據系統協助工具設定。

例外狀況

ArgumentOutOfRangeException

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 值。

例外狀況

ArgumentOutOfRangeException

timeout 小於 0。

ArgumentException

tipText 為 null 或空字串。

InvalidEnumArgumentException

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 時立即關閉。 在某些情況下，第二個方塊會在第一個批註方塊頂端開啟。

標題文字會顯示在方塊頂端附近的粗體字型。

適用於