NotifyIcon.ShowBalloonTip Método

  • Referência

Definição

Namespace:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

Exibe a dica de balão na barra de tarefas.

Sobrecargas

ShowBalloonTip(Int32)

Exibe uma dica de balão na barra de tarefas durante o tempo especificado.
ShowBalloonTip(Int32, String, String, ToolTipIcon)

Exibe uma dica de balão com o título, texto e ícone especificados na barra de tarefas durante o período especificado.

ShowBalloonTip(Int32)

Exibe uma dica de balão na barra de tarefas durante o tempo especificado.

public:
 void ShowBalloonTip(int timeout);
public void ShowBalloonTip (int timeout);
member this.ShowBalloonTip : int -> unit
Public Sub ShowBalloonTip (timeout As Integer)

Parâmetros

timeout
Int32

O tempo, em milissegundos, que a dica de balão deve ser exibida. "Este parâmetro foi preterido. Os tempos de exibição de notificação agora são baseados nas configurações de acessibilidade do sistema.

Exceções

ArgumentOutOfRangeException

timeout é menor que 0.

Exemplos

O exemplo de código a seguir demonstra como usar o ShowBalloonTip método . Para executar este exemplo, cole o código de exemplo em um Formulário do Windows que contém um NotifyIcon chamado notifyIcon1. Chame SetBalloonTip do construtor do formulário ou Load do método de manipulação de eventos.

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

Comentários

Os valores de tempo limite mínimo e máximo são impostos pelo sistema operacional e normalmente são de 10 e 30 segundos, respectivamente, mas isso pode variar dependendo do sistema operacional. Os valores de tempo limite muito grandes ou muito pequenos são ajustados para o valor mínimo ou máximo apropriado. Além disso, se o usuário não parece estar usando o computador (nenhum evento de teclado ou mouse está ocorrendo), o sistema não conta esse tempo para o tempo limite.

Somente uma dica de balão pode ser exibida na barra de tarefas por vez. Tentar exibir uma dica de balão quando uma é exibida atualmente na barra de tarefas faz com que o timeout valor seja ignorado. O comportamento é um pouco diferente dependendo do sistema operacional e se a dica de balão é de outro aplicativo ou o mesmo. Quando a segunda dica de balão for de outro aplicativo, a primeira dica de balão será exibida para o valor mínimo de tempo limite antes que o segundo seja exibido, independentemente do valor de timeout. Na maioria dos casos, se as dicas de balão forem do mesmo aplicativo, a primeira dica de balão será fechada imediatamente quando outra chamada para o ShowBalloonTip método for feita. Em alguns casos, o segundo balão será aberto sobre o primeiro balão.

O texto do título será exibido em uma fonte em negrito perto da parte superior do balão.

Aplica-se a

ShowBalloonTip(Int32, String, String, ToolTipIcon)

Exibe uma dica de balão com o título, texto e ícone especificados na barra de tarefas durante o período especificado.

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)

Parâmetros

timeout
Int32

O tempo, em milissegundos, que a dica de balão deve ser exibida. "Este parâmetro foi preterido. Os tempos de exibição de notificação agora são baseados nas configurações de acessibilidade do sistema.

tipTitle
String

O título a ser exibido na dica de balão.

tipText
String

O texto a ser exibido na dica de balão.

tipIcon
ToolTipIcon

Um dos valores de ToolTipIcon.

Exceções

ArgumentOutOfRangeException

timeout é menor que 0.

ArgumentException

tipText é null ou é uma cadeia de caracteres vazia.

InvalidEnumArgumentException

tipIcon não é membro de ToolTipIcon.

Exemplos

O exemplo de código a seguir demonstra como usar o ShowBalloonTip método . Para executar este exemplo, cole o código de exemplo em um Formulário do Windows que contém um NotifyIcon chamado notifyIcon1. Associe o Form1_DoubleClick método neste exemplo ao evento do DoubleClick formulário.

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

Comentários

Os valores de tempo limite mínimo e máximo são impostos pelo sistema operacional e normalmente são de 10 e 30 segundos, respectivamente, mas isso pode variar dependendo do sistema operacional. Os valores de tempo limite muito grandes ou muito pequenos são ajustados para o valor mínimo ou máximo apropriado. Além disso, se o usuário não parece estar usando o computador (nenhum evento de teclado ou mouse está ocorrendo), o sistema não conta esse tempo para o tempo limite.

Somente uma dica de balão pode ser exibida na barra de tarefas por vez. Tentar exibir uma dica de balão quando uma é exibida atualmente na barra de tarefas faz com que o timeout valor seja ignorado. O comportamento é um pouco diferente dependendo do sistema operacional e se a dica de balão é de outro aplicativo ou o mesmo. Quando a segunda dica de balão for de outro aplicativo, a primeira dica de balão será exibida para o valor mínimo de tempo limite antes que o segundo seja exibido, independentemente do valor de timeout. Na maioria dos casos, se as dicas de balão forem do mesmo aplicativo, a primeira dica de balão será fechada imediatamente quando outra chamada para o ShowBalloonTip método for feita. Em alguns casos, o segundo balão será aberto sobre o primeiro balão.

O texto do título será exibido em uma fonte em negrito perto da parte superior do balão.

Aplica-se a