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. Чтобы выполнить этот пример, вставьте пример кода в форму 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.

Исключения

ArgumentOutOfRangeException

Значение параметраtimeout меньше 0.

ArgumentException

Параметр tipText имеет значение null или является пустой строкой.

InvalidEnumArgumentException

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

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

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

NotifyIcon.ShowBalloonTip Метод

Определение

Перегрузки

ShowBalloonTip(Int32)

Параметры

Исключения

Примеры

Комментарии

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

ShowBalloonTip(Int32, String, String, ToolTipIcon)

Параметры

Исключения

Примеры

Комментарии

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

Дополнительные ресурсы