NotifyIcon.ShowBalloonTip Metoda

Odwołanie

Definicja

Przestrzeń nazw:: System.Windows.Forms

Zestaw:: System.Windows.Forms.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

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

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

Dotyczy

Udostępnij za pośrednictwem

NotifyIcon.ShowBalloonTip Metoda

Definicja

Przeciążenia

ShowBalloonTip(Int32)

Parametry

Wyjątki

Przykłady

Uwagi

Dotyczy

ShowBalloonTip(Int32, String, String, ToolTipIcon)

Parametry

Wyjątki

Przykłady

Uwagi

Dotyczy

Dodatkowe zasoby