NotifyIcon.ShowBalloonTip Metoda

Definicja

Wyświetla wskazówkę dymek na pasku zadań.Displays the balloon tip in the taskbar.

Przeciążenia

ShowBalloonTip(Int32)

Wyświetla wskazówkę dymek na pasku zadań w określonym przedziale czasu.Displays a balloon tip in the taskbar for the specified time period.

ShowBalloonTip(Int32, String, String, ToolTipIcon)

Wyświetla poradę dymkową o określonym tytule, tekście i ikonie na pasku zadań w określonym przedziale czasu.Displays a balloon tip with the specified title, text, and icon in the taskbar for the specified time period.

ShowBalloonTip(Int32)

Wyświetla wskazówkę dymek na pasku zadań w określonym przedziale czasu.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)

Parametry

timeout
Int32

Przedział czasu (w milisekundach) powinien zostać wyświetlony etykietka dymka.The time period, in milliseconds, the balloon tip should display.


Ten parametr jest przestarzały w systemie Windows Vista.This parameter is deprecated as of Windows Vista. Czasy wyświetlania powiadomień są teraz zależne od ustawień ułatwień dostępu systemu.Notification display times are now based on system accessibility settings.

Wyjątki

timeout jest mniejsza niż 0.timeout is less than 0.

Przykłady

Poniższy przykład kodu demonstruje sposób używania ShowBalloonTip metody.The following code example demonstrates how to use the ShowBalloonTip method. Aby uruchomić ten przykład, wklej przykładowy kod do formularza systemu Windows, który zawiera NotifyIcon nazwę notifyIcon1 .To run this example, paste the example code into a Windows Form that contains a NotifyIcon named notifyIcon1. Wywołanie SetBalloonTip z konstruktora formularza lub Load metody obsługi zdarzeń.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

Uwagi

Minimalne i maksymalne wartości limitu czasu są wymuszane przez system operacyjny i są zwykle odpowiednio 10 i 30 sekund, ale mogą się one różnić w zależności od systemu operacyjnego.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. Wartości limitu czasu, które są zbyt duże lub zbyt małe, są dostosowywane do odpowiedniej wartości minimalnej lub maksymalnej.Timeout values that are too large or too small are adjusted to the appropriate minimum or maximum value. Ponadto, jeśli użytkownik nie wydaje się korzystać z komputera (nie są wykonywane żadne zdarzenia klawiatury ani myszy), system nie liczy tego czasu w celu przekroczenia limitu czasu.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.

Tylko jedna etykietka dymka może być wyświetlana na pasku zadań jednocześnie.Only one balloon tip can display on the taskbar at a time. Próba wyświetlenia wskazówki dymek, gdy jest ona aktualnie wyświetlana na pasku zadań, powoduje timeout ignorowanie wartości.Attempting to display a balloon tip when one is currently displayed on the taskbar causes the timeout value to be ignored. Zachowanie jest nieco inne w zależności od systemu operacyjnego i od tego, czy etykietka dymka pochodzi z innego, czy też do tej samej aplikacji.The behavior is slightly different depending on the operating system and whether the balloon tip is from another, or the same, application. Gdy druga etykietka dymku pochodzi z innej aplikacji, pierwsza etykietka dymka będzie wyświetlana dla minimalnej wartości limitu czasu przed wyświetleniem sekundy, niezależnie od wartości 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. W większości przypadków, jeśli porady dymkowe pochodzą z tej samej aplikacji, pierwsza końcówka dymka natychmiast zamknie, gdy ShowBalloonTip zostanie wykonane inne wywołanie metody.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. W niektórych przypadkach drugi dymek zostanie otwarty u góry pierwszego dymka.In some cases the second balloon will open on top of the first balloon.

Tekst tytułu zostanie wyświetlony w postaci pogrubionej czcionki w górnej części dymka.The title text will display in a bold font near the top of the balloon.

Dotyczy

ShowBalloonTip(Int32, String, String, ToolTipIcon)

Wyświetla poradę dymkową o określonym tytule, tekście i ikonie na pasku zadań w określonym przedziale czasu.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)

Parametry

timeout
Int32

Przedział czasu (w milisekundach) powinien zostać wyświetlony etykietka dymka.The time period, in milliseconds, the balloon tip should display.


Ten parametr jest przestarzały w systemie Windows Vista.This parameter is deprecated as of Windows Vista. Czasy wyświetlania powiadomień są teraz zależne od ustawień ułatwień dostępu systemu.Notification display times are now based on system accessibility settings.

tipTitle
String

Tytuł, który ma być wyświetlany na etykietce dymka.The title to display on the balloon tip.

tipText
String

Tekst, który ma być wyświetlany na etykietce dymka.The text to display on the balloon tip.

tipIcon
ToolTipIcon

Jedna z ToolTipIcon wartości.One of the ToolTipIcon values.

Wyjątki

timeout jest mniejsza niż 0.timeout is less than 0.

tipText jest null lub ciągiem pustym.tipText is null or an empty string.

tipIcon nie jest członkiem ToolTipIcon .tipIcon is not a member of ToolTipIcon.

Przykłady

Poniższy przykład kodu demonstruje sposób używania ShowBalloonTip metody.The following code example demonstrates how to use the ShowBalloonTip method. Aby uruchomić ten przykład, wklej przykładowy kod do formularza systemu Windows, który zawiera NotifyIcon nazwę notifyIcon1 .To run this example, paste the example code into a Windows Form that contains a NotifyIcon named notifyIcon1. Skojarz Form1_DoubleClick metodę w tym przykładzie z DoubleClick zdarzeniem formularza.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

Uwagi

Minimalne i maksymalne wartości limitu czasu są wymuszane przez system operacyjny i są zwykle odpowiednio 10 i 30 sekund, ale mogą się one różnić w zależności od systemu operacyjnego.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. Wartości limitu czasu, które są zbyt duże lub zbyt małe, są dostosowywane do odpowiedniej wartości minimalnej lub maksymalnej.Timeout values that are too large or too small are adjusted to the appropriate minimum or maximum value. Ponadto, jeśli użytkownik nie wydaje się korzystać z komputera (nie są wykonywane żadne zdarzenia klawiatury ani myszy), system nie liczy tego czasu w celu przekroczenia limitu czasu.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.

Tylko jedna etykietka dymka może być wyświetlana na pasku zadań jednocześnie.Only one balloon tip can display on the taskbar at a time. Próba wyświetlenia wskazówki dymek, gdy jest ona aktualnie wyświetlana na pasku zadań, powoduje timeout ignorowanie wartości.Attempting to display a balloon tip when one is currently displayed on the taskbar causes the timeout value to be ignored. Zachowanie jest nieco inne w zależności od systemu operacyjnego i od tego, czy etykietka dymka pochodzi z innego, czy też do tej samej aplikacji.The behavior is slightly different depending on the operating system and whether the balloon tip is from another, or the same, application. Gdy druga etykietka dymku pochodzi z innej aplikacji, pierwsza etykietka dymka będzie wyświetlana dla minimalnej wartości limitu czasu przed wyświetleniem sekundy, niezależnie od wartości 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. W większości przypadków, jeśli porady dymkowe pochodzą z tej samej aplikacji, pierwsza końcówka dymka natychmiast zamknie, gdy ShowBalloonTip zostanie wykonane inne wywołanie metody.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. W niektórych przypadkach drugi dymek zostanie otwarty u góry pierwszego dymka.In some cases the second balloon will open on top of the first balloon.

Tekst tytułu zostanie wyświetlony w postaci pogrubionej czcionki w górnej części dymka.The title text will display in a bold font near the top of the balloon.

Dotyczy