NotifyIcon.ShowBalloonTip Methode

  • Referenz

Definition

Namespace:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

Zeigt die SprechblasenInfo auf der Taskleiste an.

Überlädt

ShowBalloonTip(Int32)

Zeigt für den angegebene Zeitraum eine SprechblasenInfo in der Taskleiste an.
ShowBalloonTip(Int32, String, String, ToolTipIcon)

Zeigt eine SprechblasenInfo mit dem angegebenen Titel, Text und Symbol für den angegebenen Zeitraum in der Taskleiste an.

ShowBalloonTip(Int32)

Zeigt für den angegebene Zeitraum eine SprechblasenInfo in der Taskleiste an.

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

Parameter

timeout
Int32

Gibt an, wie viele Millisekunden die SprechblasenInfo angezeigt wird. Dieser Parameter ist veraltet. Die Anzeigezeiten von Benachrichtigungen basieren nun auf den Einstellungen für Barrierefreiheit des Systems.

Ausnahmen

ArgumentOutOfRangeException

timeout ist kleiner als 0.

Beispiele

Das folgende Codebeispiel zeigt, wie Sie die ShowBalloonTip-Methode verwenden. Fügen Sie zum Ausführen dieses Beispiels den Beispielcode in eine Windows Form ein, die einen NotifyIcon namens notifyIcon1enthält. Rufen Sie SetBalloonTip den Konstruktor oder Load die Ereignisbehandlungsmethode des Formulars auf.

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

Hinweise

Minimale und maximale Timeoutwerte werden vom Betriebssystem erzwungen und betragen in der Regel 10 bzw. 30 Sekunden, dies kann jedoch je nach Betriebssystem variieren. Zu große oder zu kleine Timeoutwerte werden an den entsprechenden Mindest- oder Höchstwert angepasst. Wenn der Benutzer den Computer anscheinend nicht verwendet (es treten keine Tastatur- oder Mausereignisse auf), zählt das System diese Zeit nicht auf das Timeout.

Auf der Taskleiste kann jeweils nur eine Ballonspitze angezeigt werden. Wenn Sie versuchen, eine Ballonspitze anzuzeigen, wenn sie derzeit auf der Taskleiste angezeigt wird, wird der timeout Wert ignoriert. Das Verhalten unterscheidet sich geringfügig vom Betriebssystem und davon, ob die Ballonspitze von einer anderen oder derselben Anwendung stammt. Wenn die zweite Ballonspitze von einer anderen Anwendung stammt, wird die erste Ballonspitze für den Mindesttimeoutwert angezeigt, bevor der zweite angezeigt wird, unabhängig vom Wert von timeout. Wenn die Ballonspitzen von derselben Anwendung stammen, wird die erste Ballonspitze in den meisten Fällen sofort geschlossen, wenn ein weiterer Aufruf der ShowBalloonTip Methode erfolgt. In einigen Fällen wird der zweite Ballon oben auf dem ersten Ballon geöffnet.

Der Titeltext wird in fetter Schrift am oberen Rand des Ballons angezeigt.

Gilt für:

ShowBalloonTip(Int32, String, String, ToolTipIcon)

Zeigt eine SprechblasenInfo mit dem angegebenen Titel, Text und Symbol für den angegebenen Zeitraum in der Taskleiste an.

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)

Parameter

timeout
Int32

Gibt an, wie viele Millisekunden die SprechblasenInfo angezeigt wird. Dieser Parameter ist veraltet. Die Anzeigezeiten von Benachrichtigungen basieren nun auf den Einstellungen für Barrierefreiheit des Systems.

tipTitle
String

Der Titel, der in der SprechblasenInfo angezeigt werden soll.

tipText
String

Der Text, der in der SprechblasenInfo angezeigt werden soll.

tipIcon
ToolTipIcon

Einer der ToolTipIcon-Werte.

Ausnahmen

ArgumentOutOfRangeException

timeout ist kleiner als 0.

ArgumentException

Der tipText ist null oder eine leere Zeichenfolge.

InvalidEnumArgumentException

tipIcon ist kein Member von ToolTipIcon.

Beispiele

Das folgende Codebeispiel zeigt, wie Sie die ShowBalloonTip-Methode verwenden. Fügen Sie zum Ausführen dieses Beispiels den Beispielcode in eine Windows Form ein, die einen NotifyIcon namens notifyIcon1enthält. Ordnen Sie die Form1_DoubleClick -Methode in diesem Beispiel dem Ereignis des Formulars DoubleClick zu.

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

Hinweise

Minimale und maximale Timeoutwerte werden vom Betriebssystem erzwungen und betragen in der Regel 10 bzw. 30 Sekunden, dies kann jedoch je nach Betriebssystem variieren. Zu große oder zu kleine Timeoutwerte werden an den entsprechenden Mindest- oder Höchstwert angepasst. Wenn der Benutzer den Computer anscheinend nicht verwendet (es treten keine Tastatur- oder Mausereignisse auf), zählt das System diese Zeit nicht auf das Timeout.

Auf der Taskleiste kann jeweils nur eine Ballonspitze angezeigt werden. Wenn Sie versuchen, eine Ballonspitze anzuzeigen, wenn sie derzeit auf der Taskleiste angezeigt wird, wird der timeout Wert ignoriert. Das Verhalten unterscheidet sich geringfügig vom Betriebssystem und davon, ob die Ballonspitze von einer anderen oder derselben Anwendung stammt. Wenn die zweite Ballonspitze von einer anderen Anwendung stammt, wird die erste Ballonspitze für den Mindesttimeoutwert angezeigt, bevor der zweite angezeigt wird, unabhängig vom Wert von timeout. Wenn die Ballonspitzen von derselben Anwendung stammen, wird die erste Ballonspitze in den meisten Fällen sofort geschlossen, wenn ein weiterer Aufruf der ShowBalloonTip Methode erfolgt. In einigen Fällen wird der zweite Ballon oben auf dem ersten Ballon geöffnet.

Der Titeltext wird in fetter Schrift am oberen Rand des Ballons angezeigt.

Gilt für: