ToolTip Kelas

Definisi

Ruang nama:

System.Windows.Forms

Rakitan:

System.Windows.Forms.dll

Mewakili jendela pop-up persegi kecil yang menampilkan deskripsi singkat tentang tujuan kontrol saat pengguna mengarahkan penunjuk pada kontrol.

public ref class ToolTip : System::ComponentModel::Component, System::ComponentModel::IExtenderProvider

public class ToolTip : System.ComponentModel.Component, System.ComponentModel.IExtenderProvider

type ToolTip = class
    inherit Component
    interface IExtenderProvider

Public Class ToolTip
Inherits Component
Implements IExtenderProvider

Warisan

Object

MarshalByRefObject

Component

ToolTip

Penerapan

IExtenderProvider

Contoh

Contoh kode berikut membuat instans ToolTip kelas dan mengaitkan instans dengan Form instans yang dibuat di dalamnya. Kode kemudian menginisialisasi properti AutoPopDelaypenundaan , , InitialDelaydan ReshowDelay. Selain itu, instans ToolTipShowAlways kelas mengatur properti ke untuk true mengaktifkan teks TipsAlat untuk selalu ditampilkan terlepas dari apakah formulir aktif. Terakhir, contoh mengaitkan teks TipsAlat dengan dua kontrol pada formulir, Button dan CheckBox. Contoh kode mengharuskan metode yang ditentukan dalam contoh terletak di dalam Form yang berisi Button kontrol bernama button1 dan CheckBox kontrol bernama checkBox1, dan bahwa metode dipanggil dari konstruktor Form.

// This example assumes that the Form_Load event handling method
// is connected to the Load event of the form.
void Form1_Load( Object^ sender, System::EventArgs^ e )
{
   // Create the ToolTip and associate with the Form container.
   ToolTip^ toolTip1 = gcnew ToolTip;
   
   // Set up the delays for the ToolTip.
   toolTip1->AutoPopDelay = 5000;
   toolTip1->InitialDelay = 1000;
   toolTip1->ReshowDelay = 500;
   // Force the ToolTip text to be displayed whether or not the form is active.
   toolTip1->ShowAlways = true;
   
   // Set up the ToolTip text for the Button and Checkbox.
   toolTip1->SetToolTip( this->button1, "My button1" );
   toolTip1->SetToolTip( this->checkBox1, "My checkBox1" );
}

// This example assumes that the Form_Load event handling method
// is connected to the Load event of the form.
private void Form1_Load(object sender, System.EventArgs e)
{
   // Create the ToolTip and associate with the Form container.
   ToolTip toolTip1 = new ToolTip();

   // Set up the delays for the ToolTip.
   toolTip1.AutoPopDelay = 5000;
   toolTip1.InitialDelay = 1000;
   toolTip1.ReshowDelay = 500;
   // Force the ToolTip text to be displayed whether or not the form is active.
   toolTip1.ShowAlways = true;
      
   // Set up the ToolTip text for the Button and Checkbox.
   toolTip1.SetToolTip(this.button1, "My button1");
   toolTip1.SetToolTip(this.checkBox1, "My checkBox1");
}

' This example assumes that the Form_Load event handling method
' is connected to the Load event of the form.
Private Sub Form1_Load(sender As Object, e As System.EventArgs) Handles MyBase.Load
   ' Create the ToolTip and associate with the Form container.
   Dim toolTip1 As New ToolTip()
   
   ' Set up the delays for the ToolTip.
   toolTip1.AutoPopDelay = 5000
   toolTip1.InitialDelay = 1000
   toolTip1.ReshowDelay = 500
   ' Force the ToolTip text to be displayed whether or not the form is active.
   toolTip1.ShowAlways = True
   
   ' Set up the ToolTip text for the Button and Checkbox.
   toolTip1.SetToolTip(Me.button1, "My button1")
   toolTip1.SetToolTip(Me.checkBox1, "My checkBox1")
End Sub

Keterangan

ToolTip Dengan kelas , Anda dapat memberikan petunjuk kepada pengguna saat pengguna menempatkan pointer pada kontrol. Kelas ToolTip biasanya digunakan untuk memperingatkan pengguna tentang penggunaan kontrol yang dimaksudkan. Misalnya, Anda dapat menentukan teks TipsAlat untuk TextBox kontrol yang menerima nama, menentukan format nama yang akan diketik ke dalam kontrol. Selain memberikan petunjuk, Anda juga dapat menggunakan ToolTip kelas untuk memberikan informasi status run time. Misalnya, Anda dapat menggunakan ToolTip kelas untuk menampilkan kecepatan koneksi dan data kualitas garis saat pengguna memindahkan penunjuk ke PictureBox kontrol yang menampilkan status koneksi Internet.

Kelas ToolTip dapat digunakan dalam kontainer apa pun. Untuk menentukan kontainer secara eksplisit, gunakan ToolTip(IContainer) konstruktor . Satu ToolTip komponen biasanya digunakan untuk membuat TipsAlat untuk beberapa kontrol pada satu bentuk. Setelah Anda membuat ToolTip, gunakan panggilan terpisah ke SetToolTip metode untuk mengaitkan teks tampilan TipsAlat ke kontrol individual. Kemudian ketika pengguna memindahkan penunjuk pada kontrol, TipsAlat dengan teksnya ditampilkan. Anda dapat memanggil SetToolTip lebih dari sekali untuk kontrol yang sama guna mengubah teks yang terkait dengan kontrol. Untuk mendapatkan teks yang terkait dengan kontrol, gunakan GetToolTip metode . Untuk menghapus semua asosiasi teks TipsAlat dengan instans ToolTip kelas , gunakan RemoveAll metode .

Catatan

Teks TipsAlat tidak ditampilkan untuk kontrol yang dinonaktifkan. ShowAlways Kecuali properti diatur ke true, TipsAlat tidak ditampilkan saat kontainernya tidak aktif.

Kelas ini ToolTip menyediakan properti dan metode berikut untuk memodifikasi perilaku dan tampilan default TipsAlat.

Kategori	Anggota terkait
Tampilan manual	Active, Show, Hide, ShowAlways, Popup, StopTimer
Pengaturan waktu TipsAlat	AutoPopDelay, InitialDelay, ReshowDelay, AutomaticDelay, StopTimer
Konten	SetToolTip, GetToolTip, StripAmpersands, ToolTipIcon, ToolTipTitle, RemoveAll
Penampilan	BackColor, ForeColor, IsBalloon, OwnerDraw, UseAnimation, UseFading

Jika Anda ingin menonaktifkan semua teks TipsAlat sehingga tidak dapat ditampilkan di aplikasi Anda, Anda dapat menggunakan Active properti . Biasanya TipsAlat digambar oleh sistem operasi, tetapi untuk menyesuaikan tampilan ToolTip, Anda dapat mengatur OwnerDraw properti ke true dan menangani Draw peristiwa.

Kelas ToolTipTitle mengimplementasikan System.ComponentModel.IExtenderProvider antarmuka , yang memiliki satu metode, CanExtend. TipsAlat memperluas kontrol pada formulir yang sama pada waktu desain, menambahkan ToolTip properti. Untuk informasi selengkapnya tentang penyedia extender, lihat Penyedia Extender.

Konstruktor

ToolTip()	Menginisialisasi instans ToolTip baru tanpa kontainer tertentu.
ToolTip(IContainer)	Menginisialisasi instans ToolTip baru kelas dengan kontainer tertentu.

Properti

Active	Mendapatkan atau menetapkan nilai yang menunjukkan apakah TipsAlat saat ini aktif.
AutomaticDelay	Mendapatkan atau mengatur penundaan otomatis untuk TipsAlat.
AutoPopDelay	Mendapatkan atau mengatur periode waktu TipsAlat tetap terlihat jika penunjuk diam pada kontrol dengan teks TipsAlat yang ditentukan.
BackColor	Mendapatkan atau mengatur warna latar belakang untuk TipsAlat.
CanRaiseEvents	Mendapatkan nilai yang menunjukkan apakah komponen dapat menaikkan peristiwa. (Diperoleh dari Component)
Container	IContainer Mendapatkan yang berisi Component. (Diperoleh dari Component)
CreateParams	Mendapatkan parameter pembuatan untuk jendela TipsAlat.
DesignMode	Mendapatkan nilai yang menunjukkan apakah Component saat ini dalam mode desain. (Diperoleh dari Component)
Events	Mendapatkan daftar penanganan aktivitas yang dilampirkan ke ini Component. (Diperoleh dari Component)
ForeColor	Mendapatkan atau mengatur warna latar depan untuk TipsAlat.
InitialDelay	Mendapatkan atau mengatur waktu yang berlalu sebelum TipsAlat muncul.
IsBalloon	Mendapatkan atau menetapkan nilai yang menunjukkan apakah TipsAlat harus menggunakan jendela balon.
OwnerDraw	Mendapatkan atau menetapkan nilai yang menunjukkan apakah TipsAlat digambar oleh sistem operasi atau dengan kode yang Anda berikan.
ReshowDelay	Mendapatkan atau mengatur durasi waktu yang harus ditranspirasi sebelum jendela TipsAlat berikutnya muncul saat penunjuk berpindah dari satu kontrol ke kontrol lainnya.
ShowAlways	Mendapatkan atau mengatur nilai yang menunjukkan apakah jendela TipsAlat ditampilkan, bahkan ketika kontrol induknya tidak aktif.
Site	Mendapatkan atau mengatur ISite dari Component. (Diperoleh dari Component)
StripAmpersands	Mendapatkan atau menetapkan nilai yang menentukan bagaimana karakter ampersand (&) diperlakukan.
Tag	Mendapatkan atau mengatur objek yang berisi data yang disediakan programmer yang terkait dengan ToolTip.
ToolTipIcon	Mendapatkan atau mengatur nilai yang menentukan jenis ikon yang akan ditampilkan bersama teks TipsAlat.
ToolTipTitle	Mendapatkan atau mengatur judul untuk jendela TipsAlat.
UseAnimation	Mendapatkan atau mengatur nilai yang menentukan apakah efek animasi harus digunakan saat menampilkan TipsAlat.
UseFading	Mendapatkan atau mengatur nilai yang menentukan apakah efek pudar harus digunakan saat menampilkan TipsAlat.

Metode

CanExtend(Object)	Mengembalikan true jika TipsAlat dapat menawarkan properti extender ke komponen target yang ditentukan.
CreateObjRef(Type)	Membuat objek yang berisi semua informasi relevan yang diperlukan untuk menghasilkan proksi yang digunakan untuk berkomunikasi dengan objek jarak jauh. (Diperoleh dari MarshalByRefObject)
Dispose()	Merilis semua sumber daya yang Componentdigunakan oleh . (Diperoleh dari Component)
Dispose(Boolean)	Merilis sumber daya tidak terkelola yang digunakan oleh Component dan secara opsional merilis sumber daya terkelola.
Equals(Object)	Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object)
Finalize()	Melepaskan sumber daya yang tidak dikelola dan melakukan operasi pembersihan lainnya sebelum Cursor direklamasi kembali oleh pengumpul sampah.
GetHashCode()	Berfungsi sebagai fungsi hash default. (Diperoleh dari Object)
GetLifetimeService()	Mengambil objek layanan seumur hidup saat ini yang mengontrol kebijakan seumur hidup untuk instans ini. (Diperoleh dari MarshalByRefObject)
GetService(Type)	Mengembalikan objek yang mewakili layanan yang disediakan oleh Component atau oleh Container. (Diperoleh dari Component)
GetToolTip(Control)	Mengambil teks TipsAlat yang terkait dengan kontrol yang ditentukan.
GetType()	Mendapatkan dari instans Type saat ini. (Diperoleh dari Object)
Hide(IWin32Window)	Menyembunyikan jendela TipsAlat yang ditentukan.
InitializeLifetimeService()	Mendapatkan objek layanan seumur hidup untuk mengontrol kebijakan seumur hidup untuk instans ini. (Diperoleh dari MarshalByRefObject)
MemberwiseClone()	Membuat salinan dangkal dari saat ini Object. (Diperoleh dari Object)
MemberwiseClone(Boolean)	Membuat salinan dangkal objek saat ini MarshalByRefObject . (Diperoleh dari MarshalByRefObject)
RemoveAll()	Menghapus semua teks TipsAlat yang saat ini terkait dengan komponen TipsAlat.
SetToolTip(Control, String)	Mengaitkan teks TipsAlat dengan kontrol yang ditentukan.
Show(String, IWin32Window)	Mengatur teks TipsAlat yang terkait dengan kontrol yang ditentukan, dan menampilkan TipsAlat secara modal.
Show(String, IWin32Window, Int32)	Mengatur teks TipsAlat yang terkait dengan kontrol yang ditentukan, lalu menampilkan TipsAlat selama durasi yang ditentukan.
Show(String, IWin32Window, Int32, Int32)	Mengatur teks TipsAlat yang terkait dengan kontrol yang ditentukan, lalu menampilkan TipsAlat secara modal pada posisi relatif yang ditentukan.
Show(String, IWin32Window, Int32, Int32, Int32)	Mengatur teks TipsAlat yang terkait dengan kontrol yang ditentukan, lalu menampilkan TipsAlat selama durasi yang ditentukan pada posisi relatif yang ditentukan.
Show(String, IWin32Window, Point)	Mengatur teks TipsAlat yang terkait dengan kontrol yang ditentukan, lalu menampilkan TipsAlat secara modal pada posisi relatif yang ditentukan.
Show(String, IWin32Window, Point, Int32)	Mengatur teks TipsAlat yang terkait dengan kontrol yang ditentukan, lalu menampilkan TipsAlat selama durasi yang ditentukan pada posisi relatif yang ditentukan.
StopTimer()	Menghentikan timer yang menyembunyikan TipsAlat yang ditampilkan.
ToString()	Mengembalikan representasi string untuk kontrol ini.

Acara

Disposed	Terjadi ketika komponen dibuang oleh panggilan ke Dispose() metode . (Diperoleh dari Component)
Draw	Terjadi ketika TipsAlat digambar dan OwnerDraw properti diatur ke true dan IsBalloon properti adalah false.
Popup	Terjadi sebelum TipsAlat awalnya ditampilkan. Ini adalah peristiwa default untuk ToolTip kelas .

Lihat juga

• ToolTipIcon
• HelpProvider
• Penyedia Extender
• Komponen TipsAlat (Formulir Windows)