Bagikan melalui


ToolTip Kelas

Definisi

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

public ref class ToolTip sealed : System::ComponentModel::Component, System::ComponentModel::IExtenderProvider
public ref class ToolTip : System::ComponentModel::Component, System::ComponentModel::IExtenderProvider
public sealed 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 NotInheritable Class ToolTip
Inherits Component
Implements IExtenderProvider
Public Class ToolTip
Inherits Component
Implements IExtenderProvider
Warisan
Penerapan

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.

Dispose(Boolean)

Merilis sumber daya tidak terkelola yang digunakan oleh Component dan secara opsional merilis sumber daya terkelola.

(Diperoleh dari Component)
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()
Kedaluwarsa.

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()
Kedaluwarsa.

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 .

Berlaku untuk

Lihat juga