NotifyIcon.ShowBalloonTip Metoda

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Windows.Forms
Zestaw:
System.Windows.Forms.dll

Wyświetla poradę balonu na pasku zadań.

Przeciążenia

ShowBalloonTip(Int32)

Wyświetla poradę balonu na pasku zadań dla określonego okresu.
ShowBalloonTip(Int32, String, String, ToolTipIcon)

Wyświetla poradę dymka z określonym tytułem, tekstem i ikoną na pasku zadań dla określonego okresu.

ShowBalloonTip(Int32)

Wyświetla poradę balonu na pasku zadań dla określonego okresu.

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

Parametry

timeout
Int32

Powinien zostać wyświetlony przedział czasu w milisekundach. Ten parametr jest przestarzały. Czas wyświetlania powiadomień jest teraz oparty na ustawieniach ułatwień dostępu systemu.

Wyjątki

ArgumentOutOfRangeException

timeout wartość jest mniejsza niż 0.

Przykłady

W poniższym przykładzie kodu pokazano, jak używać ShowBalloonTip metody . Aby uruchomić ten przykład, wklej przykładowy kod w formularzu systemu Windows zawierającym NotifyIcon nazwę notifyIcon1. Wywołanie SetBalloonTip z konstruktora formularza lub Load metody obsługi zdarzeń.

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 zazwyczaj wynosi 10 i 30 sekund, jednak może się to różnić w zależności od systemu operacyjnego. Wartości limitu czasu, które są zbyt duże lub zbyt małe, są dostosowywane do odpowiedniej wartości minimalnej lub maksymalnej. Ponadto, jeśli użytkownik nie wydaje się używać komputera (nie występują żadne zdarzenia klawiatury lub myszy), system nie zlicza tego czasu do przekroczenia limitu czasu.

Na pasku zadań jednocześnie może być wyświetlana tylko jedna porada balonowa. Próba wyświetlenia wskazówki balonu, gdy jest ona obecnie wyświetlana na pasku zadań, powoduje timeout zignorowanie wartości. Zachowanie jest nieco inne w zależności od systemu operacyjnego i tego, czy porada balonu pochodzi z innej, czy tej samej aplikacji. Gdy druga porada balonu pochodzi z innej aplikacji, pierwsza porada balonowa będzie wyświetlana dla minimalnej wartości limitu czasu przed drugim, niezależnie od wartości timeout. W większości przypadków, jeśli porady balonu pochodzą z tej samej aplikacji, pierwsza porada balonowa natychmiast zamyka się, gdy zostanie wykonane inne wywołanie ShowBalloonTip metody. W niektórych przypadkach drugi balon zostanie otwarty na szczycie pierwszego balonu.

Tekst tytułu będzie wyświetlany w pogrubionej czcionki w górnej części dymka.

Dotyczy

ShowBalloonTip(Int32, String, String, ToolTipIcon)

Wyświetla poradę dymka z określonym tytułem, tekstem i ikoną na pasku zadań dla określonego okresu.

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

Powinien zostać wyświetlony przedział czasu w milisekundach. Ten parametr jest przestarzały. Czas wyświetlania powiadomień jest teraz oparty na ustawieniach ułatwień dostępu systemu.

tipTitle
String

Tytuł do wyświetlenia na wierzchołku balonu.

tipText
String

Tekst do wyświetlenia na wierzchołku balonu.

tipIcon
ToolTipIcon

ToolTipIcon Jedna z wartości.

Wyjątki

ArgumentOutOfRangeException

timeout wartość jest mniejsza niż 0.

ArgumentException

tipText jest null ciągiem lub ciągiem pustym.

InvalidEnumArgumentException

tipIcon nie jest członkiem programu ToolTipIcon.

Przykłady

W poniższym przykładzie kodu pokazano, jak używać ShowBalloonTip metody . Aby uruchomić ten przykład, wklej przykładowy kod w formularzu systemu Windows zawierającym NotifyIcon nazwę notifyIcon1. Skojarz metodę Form1_DoubleClick w tym przykładzie ze zdarzeniem formularza DoubleClick .

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 zazwyczaj wynosi 10 i 30 sekund, jednak może się to różnić w zależności od systemu operacyjnego. Wartości limitu czasu, które są zbyt duże lub zbyt małe, są dostosowywane do odpowiedniej wartości minimalnej lub maksymalnej. Ponadto, jeśli użytkownik nie wydaje się używać komputera (nie występują żadne zdarzenia klawiatury lub myszy), system nie zlicza tego czasu do przekroczenia limitu czasu.

Na pasku zadań jednocześnie może być wyświetlana tylko jedna porada balonowa. Próba wyświetlenia wskazówki balonu, gdy jest ona obecnie wyświetlana na pasku zadań, powoduje timeout zignorowanie wartości. Zachowanie jest nieco inne w zależności od systemu operacyjnego i tego, czy porada balonu pochodzi z innej, czy tej samej aplikacji. Gdy druga porada balonu pochodzi z innej aplikacji, pierwsza porada balonowa będzie wyświetlana dla minimalnej wartości limitu czasu przed drugim, niezależnie od wartości timeout. W większości przypadków, jeśli porady balonu pochodzą z tej samej aplikacji, pierwsza porada balonowa natychmiast zamyka się, gdy zostanie wykonane inne wywołanie ShowBalloonTip metody. W niektórych przypadkach drugi balon zostanie otwarty na szczycie pierwszego balonu.

Tekst tytułu będzie wyświetlany w pogrubionej czcionki w górnej części dymka.

Dotyczy