NotifyIcon.ShowBalloonTip Metoda

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

Nazwa	Opis
ShowBalloonTip(Int32)	Wyświetla poradę balonu na pasku zadań dla określonego okresu.
ShowBalloonTip(Int32, String, String, ToolTipIcon)	Wyświetla poradę balonu z określonym tytułem, tekstem i ikoną na pasku zadań dla określonego okresu.

ShowBalloonTip(Int32)

Źródło:: NotifyIcon.cs

Źródło:: NotifyIcon.cs

Źródło:: NotifyIcon.cs

Źródło:: NotifyIcon.cs

Źródło:: NotifyIcon.cs

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

W milisekundach powinna być wyświetlana kropka czasu. 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 do formularza Windows zawierającego NotifyIcon o nazwie notifyIcon1. Wywołaj metodę SetBalloonTip 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 liczy tego czasu w kierunku przekroczenia limitu czasu.

Tylko jedna porada balonu może być wyświetlana na pasku zadań jednocześnie. Próba wyświetlenia wskazówka dymka, gdy na pasku zadań jest obecnie wyświetlana wartość, 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 balonu 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 wskazówki balonu pochodzą z tej samej aplikacji, pierwsza porada balonu 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 czcionki pogrubionej w górnej części balonu.

Dotyczy

ShowBalloonTip(Int32, String, String, ToolTipIcon)

Źródło:: NotifyIcon.cs

Źródło:: NotifyIcon.cs

Źródło:: NotifyIcon.cs

Źródło:: NotifyIcon.cs

Źródło:: NotifyIcon.cs

Wyświetla poradę balonu 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

W milisekundach powinna być wyświetlana kropka czasu. 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 lub pusty ciąg.

InvalidEnumArgumentException

tipIconnie jest członkiem .ToolTipIcon

Przykłady

W poniższym przykładzie kodu pokazano, jak używać ShowBalloonTip metody . Aby uruchomić ten przykład, wklej przykładowy kod do formularza Windows zawierającego NotifyIcon o nazwie 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 czcionki pogrubionej w górnej części balonu.

Dotyczy

Opinia

Czy ta strona była pomocna?