Поделиться через


NotifyIcon.ShowBalloonTip Метод

Определение

Отображает всплывающую подсказку на панели задач.

Перегрузки

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. Чтобы выполнить этот пример, вставьте пример кода в форму Windows Forms, содержащую NotifyIcon объект с именем notifyIcon1. Вызов 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)

Отображает всплывающую подсказку с указанным заголовком, текстом и значком в панели задач в течение указанного времени.

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. Чтобы выполнить этот пример, вставьте пример кода в форму Windows Forms, содержащую NotifyIcon объект с именем notifyIcon1. Свяжите 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 вызова метода. В некоторых случаях второй воздушный шар открывается поверх первого шара.

Текст заголовка будет выделен полужирным шрифтом в верхней части выноски.

Применяется к