NotifyIcon.ShowBalloonTip Método

Definição

Espaço de Nomes:: System.Windows.Forms

Assemblagem:: System.Windows.Forms.dll

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

Mostra a dica do balão na barra de tarefas.

Sobrecargas

Name	Description
ShowBalloonTip(Int32)	Mostra uma dica de balão na barra de tarefas para o período de tempo especificado.
ShowBalloonTip(Int32, String, String, ToolTipIcon)	Apresenta uma dica de balão com o título, texto e ícone especificados na barra de tarefas para o período de tempo especificado.

ShowBalloonTip(Int32)

Mostra uma dica de balão na barra de tarefas para o período de 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 período de tempo, em milissegundos, a ponta do balão deve ser exibido. Este parâmetro foi preterido. Os tempos de visualização das notificações são agora baseados nas definições de acessibilidade do sistema.

Exceções

ArgumentOutOfRangeException

timeout é inferior a 0.

Exemplos

O exemplo de código seguinte demonstra como usar o ShowBalloonTip método. Para executar este exemplo, cole o código de exemplo num formulário Windows que contenha um NotifyIcon chamado notifyIcon1. Chamada SetBalloonTip a partir do construtor do formulário ou Load do método de gestã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

Observações

Os valores mínimos e máximos de timeout são aplicados pelo sistema operativo e são tipicamente de 10 e 30 segundos, respetivamente, embora isto possa variar consoante o sistema operativo. Valores de timeout demasiado grandes ou demasiado pequenos são ajustados para o valor mínimo ou máximo apropriado. Além disso, se o utilizador não parecer estar a usar o computador (não ocorrerem eventos de teclado ou rato), o sistema não conta este tempo para o timeout.

Só uma ponta de balão pode aparecer na barra de tarefas de cada vez. Tentar mostrar uma dica de balão quando uma está atualmente na barra de tarefas faz com que o timeout valor seja ignorado. O comportamento é ligeiramente diferente dependendo do sistema operativo e se a ponta do balão é de outra aplicação, ou da mesma. Quando a segunda ponta do balão é de outra aplicação, a primeira ponta do balão será exibida para o valor mínimo de timeout antes da segunda aparecer, independentemente do valor de timeout. Na maioria dos casos, se as pontas do balão forem da mesma aplicação, a primeira ponta do balão fecha imediatamente quando é feita outra chamada ao ShowBalloonTip método. Em alguns casos, o segundo balão abre-se em cima do primeiro.

O texto do título será exibido em letra a negrito perto do topo do balão.

Aplica-se a

ShowBalloonTip(Int32, String, String, ToolTipIcon)

Apresenta uma dica de balão com o título, texto e ícone especificados na barra de tarefas para o período de tempo 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

tipTitle: String

O título para exibir na ponta do balão.

tipText: String

O texto para mostrar na ponta do balão.

tipIcon: ToolTipIcon

Um dos ToolTipIcon valores.

Exceções

ArgumentOutOfRangeException

timeout é inferior a 0.

ArgumentException

tipText é null ou uma corda vazia.

InvalidEnumArgumentException

tipIcon não é membro de ToolTipIcon.

Exemplos

O exemplo de código seguinte demonstra como usar o ShowBalloonTip método. Para executar este exemplo, cole o código de exemplo num formulário Windows que contenha 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

Observações

O texto do título será exibido em letra a negrito perto do topo do balão.

Aplica-se a

Comentários

Esta página foi útil?