NotifyIcon.ShowBalloonTip Método

  • Referencia

Definición

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

Muestra el globo de sugerencias en la barra de tareas.

Sobrecargas

ShowBalloonTip(Int32)

Muestra un globo de sugerencias en la barra de tareas para el período de tiempo especificado.
ShowBalloonTip(Int32, String, String, ToolTipIcon)

Muestra un globo de sugerencias con el título, el texto y el icono especificado en la barra de tareas para el período de tiempo especificado.

ShowBalloonTip(Int32)

Muestra un globo de sugerencias en la barra de tareas para 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

Período de tiempo en milisegundos durante el que debe mostrarse el globo de sugerencias. Este parámetro está en desuso. Las horas de presentación de notificaciones se basan ahora 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 utilizar el método ShowBalloonTip. Para ejecutar este ejemplo, pegue el código de ejemplo en un formulario Windows Forms que contenga un NotifyIcon elemento denominado notifyIcon1. Llame SetBalloonTip desde el constructor del formulario o Load el método de control 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

Comentarios

El sistema operativo aplica los valores de tiempo de espera mínimo y máximo y normalmente son de 10 y 30 segundos, respectivamente, pero esto 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 producen eventos de teclado o mouse), el sistema no cuenta este tiempo para 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 sugerencia de globo cuando se muestra una en la barra de tareas, el timeout valor se omite. 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. Cuando la segunda punta de globo es de otra aplicación, la primera punta de globo se mostrará para el valor de tiempo de espera mínimo 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)

Muestra un globo de sugerencias con el título, el texto y el icono especificado en la barra de tareas para 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

Período de tiempo en milisegundos durante el que debe mostrarse el globo de sugerencias. Este parámetro está en desuso. Las horas de presentación de notificaciones se basan ahora en la configuración de accesibilidad del sistema.

tipTitle
String

Título que se mostrará en el globo de sugerencias.

tipText
String

Texto que se mostrará en el globo de sugerencias.

tipIcon
ToolTipIcon

Uno de los valores de ToolTipIcon.

Excepciones

ArgumentOutOfRangeException

timeout es menor que 0.

ArgumentException

tipText es null o una cadena vacía.

InvalidEnumArgumentException

tipIcon no es un miembro de ToolTipIcon.

Ejemplos

En el ejemplo de código siguiente se muestra cómo utilizar el método ShowBalloonTip. Para ejecutar este ejemplo, pegue el código de ejemplo en un formulario Windows Forms que contenga un NotifyIcon elemento 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 normalmente son de 10 y 30 segundos, respectivamente, pero esto 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 producen eventos de teclado o mouse), el sistema no cuenta este tiempo para 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 sugerencia de globo cuando se muestra una en la barra de tareas, el timeout valor se omite. 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. Cuando la segunda punta de globo es de otra aplicación, la primera punta de globo se mostrará para el valor de tiempo de espera mínimo 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