NotifyIcon.ShowBalloonTip Methode

Referenz

Definition

Namespace:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

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 ein Windows-Formular ein, das einen NotifyIcon benannten Namen notifyIcon1enthält. Rufen Sie SetBalloonTip vom Konstruktor oder Load der 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 sind in der Regel 10 und 30 Sekunden, dies kann jedoch je nach Betriebssystem variieren. Timeoutwerte, die zu groß oder zu klein sind, werden auf den entsprechenden Mindest- oder Maximalwert angepasst. Wenn der Benutzer nicht den Computer verwendet (keine Tastatur- oder Mausereignisse auftreten), zählt das System diese Zeit nicht in Richtung des Timeouts.

Nur eine Sprechblasenspitze kann jeweils auf der Taskleiste angezeigt werden. Beim Versuch, eine Sprechblasenspitze anzuzeigen, wenn eine aktuell auf der Taskleiste angezeigt wird, führt dazu, dass der timeout Wert ignoriert wird. Das Verhalten unterscheidet sich geringfügig je nach Betriebssystem und ob die Sprechblasenspitze von einer anderen oder derselben Anwendung stammt. Wenn sich die zweite Sprechblasenspitze aus einer anderen Anwendung befindet, wird die erste Sprechblasenspitze für den mindesten Timeoutwert angezeigt, bevor der zweite angezeigt wird, unabhängig vom Wert .timeout In den meisten Fällen wird die erste Sprechblasenspitze sofort geschlossen, wenn ein weiterer Aufruf der ShowBalloonTip Methode vorgenommen wird. In einigen Fällen wird der zweite Sprechblasen oben auf dem ersten Sprechblasen geöffnet.

Der Titeltext wird in einer fetten Schriftart am oberen Rand des Sprechblasens 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

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 ein Windows-Formular ein, das einen NotifyIcon benannten Namen 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

Der Titeltext wird in einer fetten Schriftart am oberen Rand des Sprechblasens angezeigt.

Gilt für: