NotifyIcon.ShowBalloonTip Método

Definición

Espacio de nombres:
System.Windows.Forms
Ensamblado:
System.Windows.Forms.dll

Muestra la punta del globo en la barra de tareas.

Sobrecargas

Nombre Description
ShowBalloonTip(Int32)

Muestra una punta de globo en la barra de tareas durante el período de tiempo especificado.
ShowBalloonTip(Int32, String, String, ToolTipIcon)

Muestra una sugerencia de globo con el título, el texto y el icono especificados en la barra de tareas durante el período de tiempo especificado.

ShowBalloonTip(Int32)

Source:
NotifyIcon.cs
Source:
NotifyIcon.cs
Source:
NotifyIcon.cs
Source:
NotifyIcon.cs
Source:
NotifyIcon.cs

Muestra una punta de globo en la barra de tareas durante el período de tiempo 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

El período de tiempo, en milisegundos, debe mostrarse la punta del globo. Este parámetro está en desuso. Los tiempos de presentación de notificaciones ahora se basan en la configuración de accesibilidad del sistema.

Excepciones

ArgumentOutOfRangeException

timeout es menor que 0.

Ejemplos

En el ejemplo de código siguiente se muestra cómo usar el ShowBalloonTip método . Para ejecutar este ejemplo, pegue el código de ejemplo en un formulario de Windows que contenga un NotifyIcon denominado notifyIcon1. Llame desde SetBalloonTip el constructor o Load el método de control de eventos del formulario.

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

Comentarios

El sistema operativo aplica los valores de tiempo de espera mínimo y máximo y suele ser de 10 y 30 segundos, respectivamente, lo que puede variar en función del sistema operativo. Los valores de tiempo de espera demasiado grandes o demasiado pequeños se ajustan al valor mínimo o máximo adecuado. Además, si el usuario no parece estar usando el equipo (no se están produciendo eventos de teclado o mouse), el sistema no cuenta este tiempo hacia el tiempo de espera.

Solo se puede mostrar una punta de globo en la barra de tareas a la vez. Si se intenta mostrar una punta de globo cuando se muestra una actualmente en la barra de tareas, se omite el timeout valor. El comportamiento es ligeramente diferente en función del sistema operativo y de si la punta del globo es de otra aplicación o la misma aplicación. Cuando la segunda punta de globo es de otra aplicación, la primera punta del globo se mostrará para el valor mínimo de tiempo de espera antes de que aparezca el segundo, independientemente del valor de timeout. En la mayoría de los casos, si las puntas de globo proceden de la misma aplicación, la primera punta de globo se cierra inmediatamente cuando se realiza otra llamada al ShowBalloonTip método. En algunos casos, el segundo globo se abrirá en la parte superior del primer globo.

El texto del título se mostrará en una fuente en negrita cerca de la parte superior del globo.

Se aplica a

ShowBalloonTip(Int32, String, String, ToolTipIcon)

Source:
NotifyIcon.cs
Source:
NotifyIcon.cs
Source:
NotifyIcon.cs
Source:
NotifyIcon.cs
Source:
NotifyIcon.cs

Muestra una sugerencia de globo con el título, el texto y el icono especificados en la barra de tareas durante el período de tiempo 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

El período de tiempo, en milisegundos, debe mostrarse la punta del globo. Este parámetro está en desuso. Los tiempos de presentación de notificaciones ahora se basan en la configuración de accesibilidad del sistema.

tipTitle
String

Título que se va a mostrar en la punta del globo.

tipText
String

Texto que se va a mostrar en la punta del globo.

tipIcon
ToolTipIcon

Uno de los ToolTipIcon valores.

Excepciones

ArgumentOutOfRangeException

timeout es menor que 0.

ArgumentException

tipText es null o una cadena vacía.

InvalidEnumArgumentException

tipIcon no es miembro de ToolTipIcon.

Ejemplos

En el ejemplo de código siguiente se muestra cómo usar el ShowBalloonTip método . Para ejecutar este ejemplo, pegue el código de ejemplo en un formulario de Windows que contenga un NotifyIcon denominado notifyIcon1. Asocie el Form1_DoubleClick método de este ejemplo con el evento del DoubleClick formulario.

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

Comentarios

El sistema operativo aplica los valores de tiempo de espera mínimo y máximo y suele ser de 10 y 30 segundos, respectivamente, lo que puede variar en función del sistema operativo. Los valores de tiempo de espera demasiado grandes o demasiado pequeños se ajustan al valor mínimo o máximo adecuado. Además, si el usuario no parece estar usando el equipo (no se están produciendo eventos de teclado o mouse), el sistema no cuenta este tiempo hacia el tiempo de espera.

Solo se puede mostrar una punta de globo en la barra de tareas a la vez. Si se intenta mostrar una punta de globo cuando se muestra una actualmente en la barra de tareas, se omite el timeout valor. El comportamiento es ligeramente diferente en función del sistema operativo y de si la punta del globo es de otra aplicación o la misma aplicación. Cuando la segunda punta de globo es de otra aplicación, la primera punta del globo se mostrará para el valor mínimo de tiempo de espera antes de que aparezca el segundo, independientemente del valor de timeout. En la mayoría de los casos, si las puntas de globo proceden de la misma aplicación, la primera punta de globo se cierra inmediatamente cuando se realiza otra llamada al ShowBalloonTip método. En algunos casos, el segundo globo se abrirá en la parte superior del primer globo.

El texto del título se mostrará en una fuente en negrita cerca de la parte superior del globo.

Se aplica a