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 ipucunu görüntüler.

Aşırı Yüklemeler

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)

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

Milisaniye cinsinden zaman aralığı balon ucunun görüntülenmesi gerekir. Bu parametre kullanım dışıdır. Bildirim görüntüleme süreleri artık sistem erişilebilirlik ayarlarına bağlıdır.

Özel durumlar

ArgumentOutOfRangeException

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

Örnekler

Aşağıdaki kod örneğinde yönteminin nasıl kullanılacağı gösterilmektedir ShowBalloonTip . Bu örneği çalıştırmak için, örnek kodu adlı notifyIcon1bir windows formuna NotifyIcon yapıştırın. Formun oluşturucusundan veya Load olay işleme yönteminden çağrısıSetBalloonTip.

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 maksimum değere ayarlanır. Ayrıca, kullanıcı bilgisayarı kullanıyor gibi görünmüyorsa (klavye veya fare olayları oluşmuyorsa) 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ına neden olur. Davranış, işletim sistemine ve balon ucunun başka bir uygulamadan mı yoksa aynı uygulamadan mı olduğuna bağlı olarak biraz farklıdır. İkinci balon ipucu başka bir uygulamadan geldiğinde, değeri ne olursa olsun timeout, ikinci görüntülenmeden önce en düşük zaman aşımı değeri için ilk balon ucu görüntülenir. Çoğu durumda, balon ipuçları aynı uygulamadansa, yönteme ShowBalloonTip başka bir çağrı yapıldığında ilk balon ucu hemen kapanır. Bazı durumlarda ikinci balon ilk balonun üzerinde açılır.

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

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.

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

Milisaniye cinsinden zaman aralığı balon ucunun görüntülenmesi gerekir. Bu parametre kullanım dışıdır. Bildirim görüntüleme süreleri artık sistem erişilebilirlik ayarlarına bağlıdır.

tipTitle

String

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

tipText

String

Balon ucunda 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ğil.

Örnekler

Aşağıdaki kod örneğinde yönteminin nasıl kullanılacağı gösterilmektedir ShowBalloonTip . Bu örneği çalıştırmak için, örnek kodu adlı notifyIcon1bir windows formuna NotifyIcon yapıştırın. Bu örnekteki Form1_DoubleClick yöntemini 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 maksimum değere ayarlanır. Ayrıca, kullanıcı bilgisayarı kullanıyor gibi görünmüyorsa (klavye veya fare olayları oluşmuyorsa) 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ına neden olur. Davranış, işletim sistemine ve balon ucunun başka bir uygulamadan mı yoksa aynı uygulamadan mı olduğuna bağlı olarak biraz farklıdır. İkinci balon ipucu başka bir uygulamadan geldiğinde, değeri ne olursa olsun timeout, ikinci görüntülenmeden önce en düşük zaman aşımı değeri için ilk balon ucu görüntülenir. Çoğu durumda, balon ipuçları aynı uygulamadansa, yönteme ShowBalloonTip başka bir çağrı yapıldığında ilk balon ucu hemen kapanır. Bazı durumlarda ikinci balon ilk balonun üzerinde açılır.

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