NotifyIcon.ShowBalloonTip Metode

Definisi

Ruang nama:

System.Windows.Forms

Rakitan:

System.Windows.Forms.dll

Menampilkan tip balon di bilah tugas.

Overload

ShowBalloonTip(Int32)	Menampilkan tip balon di bilah tugas untuk periode waktu yang ditentukan.
ShowBalloonTip(Int32, String, String, ToolTipIcon)	Menampilkan tip balon dengan judul, teks, dan ikon yang ditentukan di taskbar untuk periode waktu yang ditentukan.

ShowBalloonTip(Int32)

Menampilkan tip balon di bilah tugas untuk periode waktu yang ditentukan.

public:
 void ShowBalloonTip(int timeout);

public void ShowBalloonTip (int timeout);

member this.ShowBalloonTip : int -> unit

Public Sub ShowBalloonTip (timeout As Integer)

Parameter

timeout

Int32

Periode waktu, dalam milidetik, ujung balon harus ditampilkan. Parameter ini tidak digunakan lagi. Waktu tampilan pemberitahuan sekarang didasarkan pada pengaturan aksesibilitas sistem.

Pengecualian

ArgumentOutOfRangeException

timeout kurang dari 0.

Contoh

Contoh kode berikut menunjukkan cara menggunakan ShowBalloonTip metode . Untuk menjalankan contoh ini, tempelkan kode contoh ke dalam Formulir Windows yang berisi bernama NotifyIconnotifyIcon1. Panggil SetBalloonTip dari konstruktor formulir atau Load metode penanganan peristiwa.

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

Keterangan

Nilai batas waktu minimum dan maksimum diberlakukan oleh sistem operasi dan biasanya masing-masing 10 dan 30 detik, namun ini dapat bervariasi tergantung pada sistem operasi. Nilai batas waktu yang terlalu besar atau terlalu kecil disesuaikan dengan nilai minimum atau maksimum yang sesuai. Selain itu, jika pengguna tampaknya tidak menggunakan komputer (tidak ada peristiwa keyboard atau mouse yang terjadi) maka sistem tidak menghitung waktu ini terhadap waktu habis.

Hanya satu ujung balon yang dapat ditampilkan pada taskbar pada satu waktu. Mencoba menampilkan tip balon ketika saat ini ditampilkan pada taskbar menyebabkan timeout nilai diabaikan. Perilakunya sedikit berbeda tergantung pada sistem operasi dan apakah ujung balon berasal dari yang lain, atau aplikasi yang sama. Ketika ujung balon kedua berasal dari aplikasi lain, ujung balon pertama akan ditampilkan untuk nilai batas waktu minimum sebelum yang kedua muncul, terlepas dari timeoutnilai . Dalam kebanyakan kasus, jika tips balon berasal dari aplikasi yang sama, ujung balon pertama segera ditutup ketika panggilan lain ke ShowBalloonTip metode dibuat. Dalam beberapa kasus balon kedua akan terbuka di atas balon pertama.

Teks judul akan ditampilkan dalam font tebal di dekat bagian atas balon.

ShowBalloonTip(Int32, String, String, ToolTipIcon)

Menampilkan tip balon dengan judul, teks, dan ikon yang ditentukan di taskbar untuk periode waktu yang ditentukan.

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)

Parameter

timeout

Int32

Periode waktu, dalam milidetik, ujung balon harus ditampilkan. Parameter ini tidak digunakan lagi. Waktu tampilan pemberitahuan sekarang didasarkan pada pengaturan aksesibilitas sistem.

tipTitle

String

Judul untuk ditampilkan pada ujung balon.

tipText

String

Teks yang akan ditampilkan pada ujung balon.

tipIcon

ToolTipIcon

Salah ToolTipIcon satu nilai.

Pengecualian

ArgumentOutOfRangeException

timeout kurang dari 0.

ArgumentException

tipText adalah null atau string kosong.

InvalidEnumArgumentException

tipIcon bukan anggota dari ToolTipIcon.

Contoh

Contoh kode berikut menunjukkan cara menggunakan ShowBalloonTip metode . Untuk menjalankan contoh ini, tempelkan kode contoh ke dalam Formulir Windows yang berisi bernama NotifyIconnotifyIcon1. Kaitkan Form1_DoubleClick metode dalam contoh ini dengan peristiwa formulir 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

Keterangan

Nilai batas waktu minimum dan maksimum diberlakukan oleh sistem operasi dan biasanya masing-masing 10 dan 30 detik, namun ini dapat bervariasi tergantung pada sistem operasi. Nilai batas waktu yang terlalu besar atau terlalu kecil disesuaikan dengan nilai minimum atau maksimum yang sesuai. Selain itu, jika pengguna tampaknya tidak menggunakan komputer (tidak ada peristiwa keyboard atau mouse yang terjadi) maka sistem tidak menghitung waktu ini terhadap waktu habis.

Hanya satu ujung balon yang dapat ditampilkan pada taskbar pada satu waktu. Mencoba menampilkan tip balon ketika saat ini ditampilkan pada taskbar menyebabkan timeout nilai diabaikan. Perilakunya sedikit berbeda tergantung pada sistem operasi dan apakah ujung balon berasal dari yang lain, atau aplikasi yang sama. Ketika ujung balon kedua berasal dari aplikasi lain, ujung balon pertama akan ditampilkan untuk nilai batas waktu minimum sebelum yang kedua muncul, terlepas dari timeoutnilai . Dalam kebanyakan kasus, jika tips balon berasal dari aplikasi yang sama, ujung balon pertama segera ditutup ketika panggilan lain ke ShowBalloonTip metode dibuat. Dalam beberapa kasus balon kedua akan terbuka di atas balon pertama.

Teks judul akan ditampilkan dalam font tebal di dekat bagian atas balon.