NotifyIcon.ShowBalloonTip Metodo

Definizione

Spazio dei nomi:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

Visualizza il suggerimento per il fumetto nella barra delle applicazioni.

Overload

Nome Descrizione
ShowBalloonTip(Int32)

Visualizza un suggerimento fumetto nella barra delle applicazioni per il periodo di tempo specificato.
ShowBalloonTip(Int32, String, String, ToolTipIcon)

Visualizza un suggerimento per il fumetto con il titolo, il testo e l'icona specificati nella barra delle applicazioni per il periodo di tempo specificato.

ShowBalloonTip(Int32)

Origine:
NotifyIcon.cs
Origine:
NotifyIcon.cs
Origine:
NotifyIcon.cs
Origine:
NotifyIcon.cs
Origine:
NotifyIcon.cs

Visualizza un suggerimento fumetto nella barra delle applicazioni per il periodo di tempo specificato.

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

Parametri

timeout
Int32

Il periodo di tempo, espresso in millisecondi, deve essere visualizzato il suggerimento per il fumetto. Questo parametro è deprecato. Gli orari di visualizzazione delle notifiche sono ora basati sulle impostazioni di accessibilità del sistema.

Eccezioni

ArgumentOutOfRangeException

timeout è minore di 0.

Esempio

Nell'esempio di codice seguente viene illustrato come usare il ShowBalloonTip metodo . Per eseguire questo esempio, incollare il codice di esempio in un form Windows contenente un NotifyIcon denominato notifyIcon1. Chiamare SetBalloonTip dal costruttore Load o dal metodo di gestione degli eventi del modulo.

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

Commenti

I valori di timeout minimo e massimo vengono applicati dal sistema operativo e in genere sono rispettivamente 10 e 30 secondi, tuttavia questo può variare a seconda del sistema operativo. I valori di timeout troppo grandi o troppo piccoli vengono modificati in base al valore minimo o massimo appropriato. Inoltre, se l'utente non sembra usare il computer (non si verificano eventi di tastiera o mouse), il sistema non conta questo tempo per il timeout.

Sulla barra delle applicazioni è possibile visualizzare una sola punta a forma di fumetto alla volta. Se si tenta di visualizzare un suggerimento per il fumetto quando ne viene attualmente visualizzato uno sulla barra delle applicazioni, il timeout valore viene ignorato. Il comportamento è leggermente diverso a seconda del sistema operativo e se il suggerimento a palloncino proviene da un'altra o dalla stessa applicazione. Quando il secondo suggerimento fumetto proviene da un'altra applicazione, il primo suggerimento fumetto verrà visualizzato per il valore di timeout minimo prima che venga visualizzato il secondo, indipendentemente dal valore di timeout. Nella maggior parte dei casi, se i suggerimenti per il fumetto provengono dalla stessa applicazione, il primo suggerimento fumetto si chiude immediatamente quando viene effettuata un'altra chiamata al ShowBalloonTip metodo . In alcuni casi il secondo palloncino si aprirà sopra il primo palloncino.

Il testo del titolo verrà visualizzato in grassetto nella parte superiore del fumetto.

Si applica a

ShowBalloonTip(Int32, String, String, ToolTipIcon)

Origine:
NotifyIcon.cs
Origine:
NotifyIcon.cs
Origine:
NotifyIcon.cs
Origine:
NotifyIcon.cs
Origine:
NotifyIcon.cs

Visualizza un suggerimento per il fumetto con il titolo, il testo e l'icona specificati nella barra delle applicazioni per il periodo di tempo specificato.

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)

Parametri

timeout
Int32

Il periodo di tempo, espresso in millisecondi, deve essere visualizzato il suggerimento per il fumetto. Questo parametro è deprecato. Gli orari di visualizzazione delle notifiche sono ora basati sulle impostazioni di accessibilità del sistema.

tipTitle
String

Titolo da visualizzare nella punta del fumetto.

tipText
String

Testo da visualizzare nella punta del fumetto.

tipIcon
ToolTipIcon

Uno dei ToolTipIcon valori.

Eccezioni

ArgumentOutOfRangeException

timeout è minore di 0.

ArgumentException

tipText è null o una stringa vuota.

InvalidEnumArgumentException

tipIcon non è un membro di ToolTipIcon.

Esempio

Nell'esempio di codice seguente viene illustrato come usare il ShowBalloonTip metodo . Per eseguire questo esempio, incollare il codice di esempio in un form Windows contenente un NotifyIcon denominato notifyIcon1. Associare il Form1_DoubleClick metodo in questo esempio all'evento del DoubleClick form.

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

Commenti

I valori di timeout minimo e massimo vengono applicati dal sistema operativo e in genere sono rispettivamente 10 e 30 secondi, tuttavia questo può variare a seconda del sistema operativo. I valori di timeout troppo grandi o troppo piccoli vengono modificati in base al valore minimo o massimo appropriato. Inoltre, se l'utente non sembra usare il computer (non si verificano eventi di tastiera o mouse), il sistema non conta questo tempo per il timeout.

Sulla barra delle applicazioni è possibile visualizzare una sola punta a forma di fumetto alla volta. Se si tenta di visualizzare un suggerimento per il fumetto quando ne viene attualmente visualizzato uno sulla barra delle applicazioni, il timeout valore viene ignorato. Il comportamento è leggermente diverso a seconda del sistema operativo e se il suggerimento a palloncino proviene da un'altra o dalla stessa applicazione. Quando il secondo suggerimento fumetto proviene da un'altra applicazione, il primo suggerimento fumetto verrà visualizzato per il valore di timeout minimo prima che venga visualizzato il secondo, indipendentemente dal valore di timeout. Nella maggior parte dei casi, se i suggerimenti per il fumetto provengono dalla stessa applicazione, il primo suggerimento fumetto si chiude immediatamente quando viene effettuata un'altra chiamata al ShowBalloonTip metodo . In alcuni casi il secondo palloncino si aprirà sopra il primo palloncino.

Il testo del titolo verrà visualizzato in grassetto nella parte superiore del fumetto.

Si applica a