NotifyIcon.ShowBalloonTip Metodo

  • Riferimento

Definizione

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

Visualizza un fumetto suggerimento nella barra delle applicazioni.

Overload

ShowBalloonTip(Int32)

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

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

ShowBalloonTip(Int32)

Visualizza un fumetto suggerimento 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

Periodo di tempo, in millisecondi, in cui deve essere visualizzato il fumetto suggerimento. Questo parametro è deprecato. Gli orari di visualizzazione delle notifiche si basano ora sulle impostazioni di accessibilità del sistema.

Eccezioni

ArgumentOutOfRangeException

timeout è minore di 0.

Esempio

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

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 sono in genere 10 e 30 secondi, ma ciò può variare a seconda del sistema operativo. I valori di timeout troppo grandi o troppo piccoli vengono modificati al valore minimo o massimo appropriato. Inoltre, se l'utente non sembra usare il computer (non si verificano eventi della tastiera o del mouse) il sistema non conteggia questa volta verso il timeout.

Una sola punta a palloncini può essere visualizzata sulla barra delle applicazioni alla volta. Il tentativo di visualizzare una punta a palloncini quando è attualmente visualizzato sulla barra delle applicazioni causa l'ignorare del timeout valore. Il comportamento è leggermente diverso a seconda del sistema operativo e se la punta del palloncino è da un'altra o dalla stessa applicazione. Quando il secondo suggerimento del palloncino proviene da un'altra applicazione, il primo suggerimento di palloncini verrà visualizzato per il valore minimo di timeout prima che venga visualizzato il secondo, indipendentemente dal valore di timeout. Nella maggior parte dei casi, se i suggerimenti del palloncino provengono dalla stessa applicazione, la prima punta a palloncini chiude immediatamente quando viene eseguita 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 un carattere grassetto nella parte superiore del palloncino.

Si applica a

ShowBalloonTip(Int32, String, String, ToolTipIcon)

Visualizza un fumetto suggerimento 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

Periodo di tempo, in millisecondi, in cui deve essere visualizzato il fumetto suggerimento. Questo parametro è deprecato. Gli orari di visualizzazione delle notifiche si basano ora sulle impostazioni di accessibilità del sistema.

tipTitle
String

Titolo da visualizzare nel fumetto suggerimento.

tipText
String

Testo da visualizzare nel fumetto suggerimento.

tipIcon
ToolTipIcon

Uno dei valori di ToolTipIcon.

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 riportato di seguito viene illustrato come utilizzare il metodo ShowBalloonTip. Per eseguire questo esempio, incollare il codice di esempio in un Windows Form contenente un NotifyIcon oggetto denominato notifyIcon1. Associare il Form1_DoubleClick metodo in questo esempio all'evento del DoubleClick modulo.

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 sono in genere 10 e 30 secondi, ma ciò può variare a seconda del sistema operativo. I valori di timeout troppo grandi o troppo piccoli vengono modificati al valore minimo o massimo appropriato. Inoltre, se l'utente non sembra usare il computer (non si verificano eventi della tastiera o del mouse) il sistema non conteggia questa volta verso il timeout.

Una sola punta a palloncini può essere visualizzata sulla barra delle applicazioni alla volta. Il tentativo di visualizzare una punta a palloncini quando è attualmente visualizzato sulla barra delle applicazioni causa l'ignorare del timeout valore. Il comportamento è leggermente diverso a seconda del sistema operativo e se la punta del palloncino è da un'altra o dalla stessa applicazione. Quando il secondo suggerimento del palloncino proviene da un'altra applicazione, il primo suggerimento di palloncini verrà visualizzato per il valore minimo di timeout prima che venga visualizzato il secondo, indipendentemente dal valore di timeout. Nella maggior parte dei casi, se i suggerimenti del palloncino provengono dalla stessa applicazione, la prima punta a palloncini chiude immediatamente quando viene eseguita 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 un carattere grassetto nella parte superiore del palloncino.

Si applica a