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

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

适用于