NotifyIcon.ShowBalloonTip Methode

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 Sprechblasenspitze in der Taskleiste an.

Überlädt

Name	Beschreibung
ShowBalloonTip(Int32)	Zeigt eine Sprechblasenspitze in der Taskleiste für den angegebenen Zeitraum an.
ShowBalloonTip(Int32, String, String, ToolTipIcon)	Zeigt eine Sprechblasenspitze mit dem angegebenen Titel, Text und Symbol in der Taskleiste für den angegebenen Zeitraum an.

ShowBalloonTip(Int32)

Quelle:: NotifyIcon.cs

Quelle:: NotifyIcon.cs

Quelle:: NotifyIcon.cs

Quelle:: NotifyIcon.cs

Quelle:: NotifyIcon.cs

Zeigt eine Sprechblasenspitze in der Taskleiste für den angegebenen Zeitraum 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

Der Zeitraum in Millisekunden sollte die Sprechblasespitze angezeigt werden. Dieser Parameter ist veraltet. Benachrichtigungsanzeigezeiten basieren jetzt auf systembasierten Barrierefreiheitseinstellungen.

Ausnahmen

ArgumentOutOfRangeException

timeout ist kleiner als 0.

Beispiele

Im folgenden Codebeispiel wird die Verwendung der ShowBalloonTip Methode veranschaulicht. Zum Ausführen dieses Beispiels fügen Sie den Beispielcode in ein Windows Formular ein, das einen NotifyIcon mit dem Namen notifyIcon1 enthält. Aufrufen SetBalloonTip aus dem Konstruktor oder Load der Ereignisbehandlungsmethode des Formulars.

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 bzw. 30 Sekunden, dies kann jedoch je nach Betriebssystem variieren. Timeoutwerte, die zu groß oder zu klein sind, werden an den entsprechenden Minimal- oder Höchstwert angepasst. Wenn der Benutzer nicht den Computer verwendet (es treten keine Tastatur- oder Mausereignisse auf), zählt das System diese Zeit nicht in Richtung des Timeouts.

Auf der Taskleiste kann jeweils nur eine Sprechblasespitze angezeigt werden. Beim Versuch, eine Sprechblasespitze anzuzeigen, wenn derzeit auf der Taskleiste ein Sprechblasentipp angezeigt wird, wird der timeout Wert ignoriert. Das Verhalten unterscheidet sich je nach Betriebssystem geringfügig und unabhängig davon, ob die Sprechblasenspitze von einer anderen oder derselben Anwendung stammt. Wenn die zweite Sprechblasespitze von einer anderen Anwendung stammt, wird die erste Sprechblasespitze für den minimalen Timeoutwert angezeigt, bevor die zweite angezeigt wird, unabhängig vom Wert von timeout. Wenn die Sprechblasenspitzen in den meisten Fällen aus derselben Anwendung stammen, wird die erste Sprechblasenspitze sofort geschlossen, wenn ein anderer Aufruf der ShowBalloonTip Methode erfolgt. In einigen Fällen wird die zweite Sprechblase über der ersten Sprechblase geöffnet.

Der Titeltext wird in einer fett formatierten Schriftart am oberen Rand der Sprechblase angezeigt.

Gilt für:

ShowBalloonTip(Int32, String, String, ToolTipIcon)

Quelle:: NotifyIcon.cs

Quelle:: NotifyIcon.cs

Quelle:: NotifyIcon.cs

Quelle:: NotifyIcon.cs

Quelle:: NotifyIcon.cs

Zeigt eine Sprechblasenspitze mit dem angegebenen Titel, Text und Symbol in der Taskleiste für den angegebenen Zeitraum 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 auf der Sprechblasespitze angezeigt werden soll.

tipText: String

Der Text, der auf der Sprechblasespitze angezeigt werden soll.

tipIcon: ToolTipIcon

Einer der ToolTipIcon Werte.

Ausnahmen

ArgumentOutOfRangeException

timeout ist kleiner als 0.

ArgumentException

tipText ist null oder eine leere Zeichenfolge.

InvalidEnumArgumentException

tipIcon ist kein Mitglied von ToolTipIcon.

Beispiele

Im folgenden Codebeispiel wird die Verwendung der ShowBalloonTip Methode veranschaulicht. Zum Ausführen dieses Beispiels fügen Sie den Beispielcode in ein Windows Formular ein, das einen NotifyIcon mit dem Namen notifyIcon1 enthä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 fett formatierten Schriftart am oberen Rand der Sprechblase angezeigt.

Gilt für:

Feedback

War diese Seite hilfreich?