NotifyIcon.ShowBalloonTip Yöntem

Tanım

Ad Alanı:

System.Windows.Forms

Bütünleştirilmiş Kod:

System.Windows.Forms.dll

Görev çubuğunda balon ucunu görüntüler.

Aşırı Yüklemeler

Name	Description
ShowBalloonTip(Int32)	Belirtilen süre boyunca görev çubuğunda bir balon ipucu görüntüler.
ShowBalloonTip(Int32, String, String, ToolTipIcon)	Belirtilen süre boyunca görev çubuğunda belirtilen başlık, metin ve simgeyi içeren bir balon ipucu görüntüler.

ShowBalloonTip(Int32)

Kaynak:

NotifyIcon.cs

Belirtilen süre boyunca görev çubuğunda bir balon ipucu görüntüler.

public:
 void ShowBalloonTip(int timeout);

public void ShowBalloonTip(int timeout);

member this.ShowBalloonTip : int -> unit

Public Sub ShowBalloonTip (timeout As Integer)

Parametreler

timeout

Int32

Zaman aralığı milisaniye cinsinden balon ucunun görüntülenmesi gerekir. Bu parametre kullanım dışı bırakıldı. Bildirim görüntüleme süreleri artık sistem erişilebilirlik ayarlarını temel alır.

Özel durumlar

ArgumentOutOfRangeException

timeout 0'dan küçüktür.

Örnekler

Aşağıdaki kod örneği, yönteminin ShowBalloonTip nasıl kullanılacağını gösterir. Bu örneği çalıştırmak için, örnek kodu NotifyIcon adlı notifyIcon1 içeren bir Windows Formuna yapıştırın. Formun oluşturucusundan veya SetBalloonTip olay işleme yönteminden çağrısıLoad.

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

Açıklamalar

En düşük ve en yüksek zaman aşımı değerleri işletim sistemi tarafından zorlanır ve genellikle sırasıyla 10 ve 30 saniyedir, ancak bu durum işletim sistemine bağlı olarak değişebilir. Çok büyük veya çok küçük zaman aşımı değerleri uygun minimum veya en yüksek değere ayarlanır. Buna ek olarak, kullanıcı bilgisayarı kullanıyor gibi görünmüyorsa (klavye veya fare olayları oluşmuyor) sistem bu süreyi zaman aşımına doğru saymıyor demektir.

Görev çubuğunda aynı anda yalnızca bir balon ipucu görüntülenebilir. Görev çubuğunda bir balon ipucu görüntülenmeye çalışılması, değerin timeout yoksayılmasıyla sonuçlanır. İşletim sistemine ve balon ucunun başka bir uygulamadan mı yoksa aynı uygulamadan mı olduğuna bağlı olarak davranış biraz farklıdır. İkinci balon ipucu başka bir uygulamadan geldiğinde, değeri ne olursa olsun, ilk balon ipucu ikinci görüntülenmeden önce en düşük zaman aşımı değeri timeoutiçin görüntülenir. Çoğu durumda, balon ipuçları aynı uygulamadan geliyorsa, yönteme ShowBalloonTip başka bir çağrı yapıldığında ilk balon ipucu hemen kapanır. Bazı durumlarda ikinci balon ilk balonun üzerinde açılır.

Başlık metni, balonun üst kısmına yakın bir kalın yazı tipinde görüntülenir.

ShowBalloonTip(Int32, String, String, ToolTipIcon)

Kaynak:

NotifyIcon.cs

Belirtilen süre boyunca görev çubuğunda belirtilen başlık, metin ve simgeyi içeren bir balon ipucu görüntüler.

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)

Parametreler

timeout

Int32

Zaman aralığı milisaniye cinsinden balon ucunun görüntülenmesi gerekir. Bu parametre kullanım dışı bırakıldı. Bildirim görüntüleme süreleri artık sistem erişilebilirlik ayarlarını temel alır.

tipTitle

String

Balon ipucunda görüntülenecek başlık.

tipText

String

Balon ipucunda görüntülenecek metin.

tipIcon

ToolTipIcon

Değerlerden ToolTipIcon biri.

Özel durumlar

ArgumentOutOfRangeException

timeout 0'dan küçüktür.

ArgumentException

tipText veya null boş bir dizedir.

InvalidEnumArgumentException

tipIcon öğesinin ToolTipIconüyesi değildir.

Örnekler

Aşağıdaki kod örneği, yönteminin ShowBalloonTip nasıl kullanılacağını gösterir. Bu örneği çalıştırmak için, örnek kodu NotifyIcon adlı notifyIcon1 içeren bir Windows Formuna yapıştırın. Bu örnekteki Form1_DoubleClick yöntemi formun olayıyla ilişkilendirin 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

Açıklamalar

En düşük ve en yüksek zaman aşımı değerleri işletim sistemi tarafından zorlanır ve genellikle sırasıyla 10 ve 30 saniyedir, ancak bu durum işletim sistemine bağlı olarak değişebilir. Çok büyük veya çok küçük zaman aşımı değerleri uygun minimum veya en yüksek değere ayarlanır. Buna ek olarak, kullanıcı bilgisayarı kullanıyor gibi görünmüyorsa (klavye veya fare olayları oluşmuyor) sistem bu süreyi zaman aşımına doğru saymıyor demektir.

Görev çubuğunda aynı anda yalnızca bir balon ipucu görüntülenebilir. Görev çubuğunda bir balon ipucu görüntülenmeye çalışılması, değerin timeout yoksayılmasıyla sonuçlanır. İşletim sistemine ve balon ucunun başka bir uygulamadan mı yoksa aynı uygulamadan mı olduğuna bağlı olarak davranış biraz farklıdır. İkinci balon ipucu başka bir uygulamadan geldiğinde, değeri ne olursa olsun, ilk balon ipucu ikinci görüntülenmeden önce en düşük zaman aşımı değeri timeoutiçin görüntülenir. Çoğu durumda, balon ipuçları aynı uygulamadan geliyorsa, yönteme ShowBalloonTip başka bir çağrı yapıldığında ilk balon ipucu hemen kapanır. Bazı durumlarda ikinci balon ilk balonun üzerinde açılır.

Başlık metni, balonun üst kısmına yakın bir kalın yazı tipinde görüntülenir.