NotifyIcon.ShowBalloonTip 方法

定义

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

在任务栏中显示气球提示。

重载

名称 说明
ShowBalloonTip(Int32)

在指定时间段的任务栏中显示气球提示。
ShowBalloonTip(Int32, String, String, ToolTipIcon)

显示具有指定时间段的任务栏中指定标题、文本和图标的气球提示。

ShowBalloonTip(Int32)

Source:
NotifyIcon.cs
Source:
NotifyIcon.cs
Source:
NotifyIcon.cs
Source:
NotifyIcon.cs
Source:
NotifyIcon.cs

在指定时间段的任务栏中显示气球提示。

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 窗体中。 从窗体的构造函数或SetBalloonTip事件处理方法调用Load。

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)

Source:
NotifyIcon.cs
Source:
NotifyIcon.cs
Source:
NotifyIcon.cs
Source:
NotifyIcon.cs
Source:
NotifyIcon.cs

显示具有指定时间段的任务栏中指定标题、文本和图标的气球提示。

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 窗体中。 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 时，第一个气球提示会立即关闭。 在某些情况下，第二个气球将在第一个气球顶部打开。

标题文本将显示在气球顶部附近的粗体字体中。

适用于