NotifyIcon.ShowBalloonTip Methode

Definition

Zeigt die SprechblasenInfo auf der Taskleiste an.Displays the balloon tip in the taskbar.

Überlädt

ShowBalloonTip(Int32)

Zeigt für den angegebene Zeitraum eine SprechblasenInfo in der Taskleiste an.Displays a balloon tip in the taskbar for the specified time period.

ShowBalloonTip(Int32, String, String, ToolTipIcon)

Zeigt eine SprechblasenInfo mit dem angegebenen Titel, Text und Symbol für den angegebenen Zeitraum in der Taskleiste an.Displays a balloon tip with the specified title, text, and icon in the taskbar for the specified time period.

ShowBalloonTip(Int32)

Zeigt für den angegebene Zeitraum eine SprechblasenInfo in der Taskleiste an.Displays a balloon tip in the taskbar for the specified time period.

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.The time period, in milliseconds, the balloon tip should display.


Dieser Parameter gilt ab Windows Vista als veraltet.This parameter is deprecated as of Windows Vista. Die Anzeigezeiten von Benachrichtigungen basieren nun auf den Einstellungen für Barrierefreiheit des Systems.Notification display times are now based on system accessibility settings.

Ausnahmen

timeout ist kleiner als 0.timeout is less than 0.

Beispiele

Das folgende Codebeispiel zeigt, wie Sie die ShowBalloonTip-Methode verwenden.The following code example demonstrates how to use the ShowBalloonTip method. Fügen Sie zum Ausführen dieses Beispiels den Beispielcode in ein Windows Form ein, das einen mit dem NotifyIcon Namen enthält notifyIcon1 .To run this example, paste the example code into a Windows Form that contains a NotifyIcon named notifyIcon1. Ruft SetBalloonTip aus dem Konstruktor des Formulars oder der Load Ereignis Behandlungsmethode auf.Call SetBalloonTip from the form's constructor or Load event-handling method.

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

Die minimalen und maximalen Timeout Werte werden vom Betriebssystem erzwungen und sind in der Regel 10 bzw. 30 Sekunden. Dies kann jedoch je nach Betriebssystem variieren.Minimum and maximum timeout values are enforced by the operating system and are typically 10 and 30 seconds, respectively, however this can vary depending on the operating system. Timeout Werte, die zu groß oder zu klein sind, werden an den entsprechenden minimalen oder maximalen Wert angepasst.Timeout values that are too large or too small are adjusted to the appropriate minimum or maximum value. Wenn der Benutzer den Computer nicht verwendet (es werden keine Tastatur-oder Mausereignisse angezeigt), zählt das System diesen Zeitpunkt nicht zum Timeout.In addition, if the user does not appear to be using the computer (no keyboard or mouse events are occurring) then the system does not count this time towards the timeout.

In der Taskleiste kann jeweils nur eine Sprechblase angezeigt werden.Only one balloon tip can display on the taskbar at a time. Wenn Sie versuchen, eine Sprechblasen Info anzuzeigen, wenn Sie zurzeit auf der Taskleiste angezeigt wird timeout , wird der Wert ignoriert.Attempting to display a balloon tip when one is currently displayed on the taskbar causes the timeout value to be ignored. Das Verhalten unterscheidet sich geringfügig vom Betriebssystem abhängig davon, ob die Sprechblasen Info von einer anderen oder der gleichen Anwendung abweicht.The behavior is slightly different depending on the operating system and whether the balloon tip is from another, or the same, application. Wenn die zweite Sprechblase aus einer anderen Anwendung besteht, wird die erste Sprechblasen Info für den minimalen Timeout Wert angezeigt, bevor der zweite angezeigt wird, unabhängig vom Wert von timeout .When the second balloon tip is from another application, the first balloon tip will display for the minimum timeout value before the second appears, regardless of the value of timeout. In den meisten Fällen, wenn sich die Sprechblasen Tipps aus derselben Anwendung befinden, wird die erste Sprechblasen Info sofort geschlossen, wenn ein anderer ShowBalloonTip Methodenaufrufe erfolgt.In most cases, if the balloon tips are from the same application, the first balloon tip immediately closes when another call to the ShowBalloonTip method is made. In einigen Fällen wird die zweite Sprechblase oberhalb der ersten Sprechblase geöffnet.In some cases the second balloon will open on top of the first balloon.

Der Titeltext wird im oberen Bereich der Sprechblase in Fett Schrift angezeigt.The title text will display in a bold font near the top of the balloon.

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.Displays a balloon tip with the specified title, text, and icon in the taskbar for the specified time period.

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.The time period, in milliseconds, the balloon tip should display.


Dieser Parameter gilt ab Windows Vista als veraltet.This parameter is deprecated as of Windows Vista. Die Anzeigezeiten von Benachrichtigungen basieren nun auf den Einstellungen für Barrierefreiheit des Systems.Notification display times are now based on system accessibility settings.

tipTitle
String

Der Titel, der in der SprechblasenInfo angezeigt werden soll.The title to display on the balloon tip.

tipText
String

Der Text, der in der SprechblasenInfo angezeigt werden soll.The text to display on the balloon tip.

tipIcon
ToolTipIcon

Einer der ToolTipIcon-Werte.One of the ToolTipIcon values.

Ausnahmen

timeout ist kleiner als 0.timeout is less than 0.

Der tipText ist null oder eine leere Zeichenfolge.tipText is null or an empty string.

tipIcon ist kein Member von ToolTipIcon.tipIcon is not a member of ToolTipIcon.

Beispiele

Das folgende Codebeispiel zeigt, wie Sie die ShowBalloonTip-Methode verwenden.The following code example demonstrates how to use the ShowBalloonTip method. Fügen Sie zum Ausführen dieses Beispiels den Beispielcode in ein Windows Form ein, das einen mit dem NotifyIcon Namen enthält notifyIcon1 .To run this example, paste the example code into a Windows Form that contains a NotifyIcon named notifyIcon1. Ordnen Sie die Form1_DoubleClick Methode in diesem Beispiel dem-Ereignis des Formulars zu DoubleClick .Associate the Form1_DoubleClick method in this example with the form's DoubleClick event.

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

Die minimalen und maximalen Timeout Werte werden vom Betriebssystem erzwungen und sind in der Regel 10 bzw. 30 Sekunden. Dies kann jedoch je nach Betriebssystem variieren.Minimum and maximum timeout values are enforced by the operating system and are typically 10 and 30 seconds, respectively, however this can vary depending on the operating system. Timeout Werte, die zu groß oder zu klein sind, werden an den entsprechenden minimalen oder maximalen Wert angepasst.Timeout values that are too large or too small are adjusted to the appropriate minimum or maximum value. Wenn der Benutzer den Computer nicht verwendet (es werden keine Tastatur-oder Mausereignisse angezeigt), zählt das System diesen Zeitpunkt nicht zum Timeout.In addition, if the user does not appear to be using the computer (no keyboard or mouse events are occurring) then the system does not count this time towards the timeout.

In der Taskleiste kann jeweils nur eine Sprechblase angezeigt werden.Only one balloon tip can display on the taskbar at a time. Wenn Sie versuchen, eine Sprechblasen Info anzuzeigen, wenn Sie zurzeit auf der Taskleiste angezeigt wird timeout , wird der Wert ignoriert.Attempting to display a balloon tip when one is currently displayed on the taskbar causes the timeout value to be ignored. Das Verhalten unterscheidet sich geringfügig vom Betriebssystem abhängig davon, ob die Sprechblasen Info von einer anderen oder der gleichen Anwendung abweicht.The behavior is slightly different depending on the operating system and whether the balloon tip is from another, or the same, application. Wenn die zweite Sprechblase aus einer anderen Anwendung besteht, wird die erste Sprechblasen Info für den minimalen Timeout Wert angezeigt, bevor der zweite angezeigt wird, unabhängig vom Wert von timeout .When the second balloon tip is from another application, the first balloon tip will display for the minimum timeout value before the second appears, regardless of the value of timeout. In den meisten Fällen, wenn sich die Sprechblasen Tipps aus derselben Anwendung befinden, wird die erste Sprechblasen Info sofort geschlossen, wenn ein anderer ShowBalloonTip Methodenaufrufe erfolgt.In most cases, if the balloon tips are from the same application, the first balloon tip immediately closes when another call to the ShowBalloonTip method is made. In einigen Fällen wird die zweite Sprechblase oberhalb der ersten Sprechblase geöffnet.In some cases the second balloon will open on top of the first balloon.

Der Titeltext wird im oberen Bereich der Sprechblase in Fett Schrift angezeigt.The title text will display in a bold font near the top of the balloon.

Gilt für: