ToolTip Sınıf

Tanım

Ad Alanı:

System.Windows.Forms

Bütünleştirilmiş Kod:

System.Windows.Forms.dll

Kullanıcı işaretçiyi denetimin üzerine getirdiğinde denetimin amacının kısa bir açıklamasını görüntüleyen küçük dikdörtgen bir açılır pencereyi temsil eder.

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

Devralma

Object

MarshalByRefObject

Component

ToolTip

Uygulamalar

IExtenderProvider

Örnekler

Aşağıdaki kod örneği sınıfının bir örneğini ToolTip oluşturur ve örneği, örneğin içinde oluşturulduğu örnekle Form ilişkilendirir. Kod daha sonra , InitialDelayve ReshowDelaygecikme özelliklerini AutoPopDelaybaşlatır. Ayrıca sınıfının örneği, formun ToolTip etkin olup olmadığına bakılmaksızın ToolTip metninin her zaman görüntülenmesini sağlamak için özelliğini true olarak ayarlarShowAlways. Son olarak, örnek ToolTip metnini formdaki iki denetimle ilişkilendirir: a Button ve CheckBox. Kod örneği, örnekte tanımlanan yöntemin adlı bir denetimi ve adlı button1checkBox1bir Button denetimi içeren bir CheckBox içinde Form yer aldığını ve yönteminin Formoluşturucusundan çağrıldığını gerektirir.

// 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

Açıklamalar

sınıfıyla, kullanıcı işaretçiyi ToolTip bir denetime yerleştirdiğinde kullanıcıya ipuçları sağlayabilirsiniz. ToolTip sınıfı genellikle kullanıcıları bir denetimin hedeflenen kullanımı konusunda uyarmak için kullanılır. Örneğin, denetime yazılacak adın biçimini belirterek, bir adı kabul eden denetim için TextBox Araç İpucu metni belirtebilirsiniz. İpuçları sağlamaya ek olarak, çalışma zamanı durum bilgilerini sağlamak için sınıfını ToolTip da kullanabilirsiniz. Örneğin, kullanıcı işaretçiyi ToolTip İnternet bağlantı durumunu görüntüleyen bir PictureBox denetime taşırken bağlantı hızını ve çizgi kalitesi verilerini görüntülemek için sınıfını kullanabilirsiniz.

ToolTip sınıfı herhangi bir kapsayıcıda kullanılabilir. Kapsayıcıyı açıkça belirtmek için oluşturucuyu ToolTip(IContainer) kullanın. Tek ToolTip bir bileşen genellikle tek bir formda birden çok denetim için Araç İpuçları oluşturmak için kullanılır. oluşturduktan ToolTipsonra, ToolTip görüntüleme metnini tek bir denetimle SetToolTip ilişkilendirmek için yöntemine ayrı bir çağrı kullanın. Ardından kullanıcı işaretçiyi bir denetimin üzerine taşırken, metinle birlikte Araç İpucu görüntülenir. Denetimle ilişkili metni değiştirmek için aynı denetim için birden çok kez çağrı SetToolTip yapabilirsiniz. Bir denetimle ilişkili metni almak için yöntemini kullanın GetToolTip . Sınıfın bir örneğiyle ToolTip tüm ToolTip metin ilişkilendirmelerini kaldırmak için yöntemini kullanın RemoveAll .

Not

Devre dışı bırakılan denetimler için Araç İpucu metni görüntülenmez. Özelliği olarak trueayarlanmadığı ShowAlways sürece, kapsayıcıları etkin olmadığında Araç İpuçları görüntülenmez.

sınıfı, ToolTip bir ToolTip'in varsayılan davranışını ve görünümünü değiştirmek için aşağıdaki özellikleri ve yöntemleri sağlar.

Kategori	İlişkili üyeler
El ile görüntüleme	Active, Show, Hide, ShowAlways, Popup, StopTimer
Araç İpucu zamanlaması	AutoPopDelay, InitialDelay, ReshowDelay, AutomaticDelay, StopTimer
Content	SetToolTip, GetToolTip, StripAmpersands, ToolTipIcon, ToolTipTitle, RemoveAll
Görünüm	BackColor, ForeColor, IsBalloon, OwnerDraw, UseAnimation, UseFading

Uygulamanızda görüntülenememesi için tüm ToolTip metnini devre dışı bırakmak istiyorsanız özelliğini kullanabilirsiniz Active . ToolTip genellikle işletim sistemi tarafından çizilir, ancak görünümünü ToolTipözelleştirmek için özelliğini true olarak ayarlayabilir OwnerDraw ve olayı işleyebilirsinizDraw.

ToolTipTitle sınıfı, tek bir yöntemi CanExtendolan arabirimini uygularSystem.ComponentModel.IExtenderProvider. ToolTips, tasarım zamanında aynı formdaki denetimleri genişleterek bir ToolTip özellik ekler. Genişletici sağlayıcıları hakkında daha fazla bilgi için bkz . Extender Sağlayıcıları.

Oluşturucular

ToolTip()	Belirtilen kapsayıcı olmadan öğesinin ToolTip yeni bir örneğini başlatır.
ToolTip(IContainer)	Belirtilen kapsayıcı ile sınıfının yeni bir örneğini ToolTip başlatır.

Özellikler

Active	Araç İpucu'nu şu anda etkin olup olmadığını belirten bir değer alır veya ayarlar.
AutomaticDelay	ToolTip için otomatik gecikmeyi alır veya ayarlar.
AutoPopDelay	İşaretçi, belirtilen Araç İpucu metnine sahip bir denetimde sabitse ToolTip'in görünür kalacağı süreyi alır veya ayarlar.
BackColor	Araç İpucu için arka plan rengini alır veya ayarlar.
CanRaiseEvents	Bileşenin bir olay oluşturup oluşturamayacağını belirten bir değer alır. (Devralındığı yer: Component)
Container	öğesini IContainer içeren öğesini Componentalır. (Devralındığı yer: Component)
CreateParams	ToolTip penceresi için oluşturma parametrelerini alır.
DesignMode	öğesinin şu anda tasarım modunda olup olmadığını Component gösteren bir değer alır. (Devralındığı yer: Component)
Events	Bu Componentöğesine eklenen olay işleyicilerinin listesini alır. (Devralındığı yer: Component)
ForeColor	ToolTip için ön plan rengini alır veya ayarlar.
InitialDelay	Araç İpucu görüntülenmeden önce geçen süreyi alır veya ayarlar.
IsBalloon	Araç İpucunun balon penceresi kullanıp kullanmayacağını belirten bir değer alır veya ayarlar.
OwnerDraw	ToolTip'in işletim sistemi tarafından mı yoksa sizin sağladığınız kodla mı çizildiğini belirten bir değer alır veya ayarlar.
ReshowDelay	İşaretçi bir denetimden diğerine geçtiğinde sonraki Araç İpucu pencereleri görünmeden önce geçmesi gereken süreyi alır veya ayarlar.
ShowAlways	Üst denetimi etkin olmasa bile Bir Araç İpucu penceresinin görüntülenip görüntülenmeyeceğini belirten bir değer alır veya ayarlar.
Site	öğesini alır veya ayarlar ISiteComponent. (Devralındığı yer: Component)
StripAmpersands	Ve (&) karakterlerin nasıl ele alındığını belirleyen bir değer alır veya ayarlar.
Tag	ile ToolTipilişkili programcı tarafından sağlanan verileri içeren nesneyi alır veya ayarlar.
ToolTipIcon	Araç İpucu metniyle birlikte görüntülenecek simge türünü tanımlayan bir değer alır veya ayarlar.
ToolTipTitle	Araç İpucu penceresi için bir başlık alır veya ayarlar.
UseAnimation	Araç İpucu görüntülenirken animasyon efektinin kullanılıp kullanılmayacağını belirleyen bir değer alır veya ayarlar.
UseFading	Araç İpucu görüntülenirken bir belirme efektinin kullanılıp kullanılmayacağını belirleyen bir değer alır veya ayarlar.

Yöntemler

CanExtend(Object)	ToolTip belirtilen hedef bileşene bir genişletici özelliği sunabiliyorsa döndürür true .
CreateObjRef(Type)	Uzak bir nesneyle iletişim kurmak için kullanılan bir ara sunucu oluşturmak için gereken tüm ilgili bilgileri içeren bir nesne oluşturur. (Devralındığı yer: MarshalByRefObject)
Dispose()	Component tarafından kullanılan tüm kaynakları serbest bırakır. (Devralındığı yer: Component)
Dispose(Boolean)	Component tarafından kullanılan yönetilmeyen kaynakları serbest bırakır ve yönetilen kaynakları isteğe bağlı olarak serbest bırakır.
Equals(Object)	Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler. (Devralındığı yer: Object)
Finalize()	Yönetilmeyen kaynakları serbest bırakır ve çöp toplayıcı tarafından geri kazanılmadan önce Cursor diğer temizleme işlemlerini gerçekleştirir.
GetHashCode()	Varsayılan karma işlevi işlevi görür. (Devralındığı yer: Object)
GetLifetimeService()	Bu örnek için yaşam süresi ilkesini denetleen geçerli yaşam süresi hizmet nesnesini alır. (Devralındığı yer: MarshalByRefObject)
GetService(Type)	veya tarafından ComponentContainersağlanan bir hizmeti temsil eden bir nesnesi döndürür. (Devralındığı yer: Component)
GetToolTip(Control)	Belirtilen denetimle ilişkili ToolTip metnini alır.
GetType()	Type Geçerli örneğini alır. (Devralındığı yer: Object)
Hide(IWin32Window)	Belirtilen Araç İpucu penceresini gizler.
InitializeLifetimeService()	Bu örneğin yaşam süresi ilkesini denetlemek için bir yaşam süresi hizmet nesnesi alır. (Devralındığı yer: MarshalByRefObject)
MemberwiseClone()	Geçerli Objectöğesinin sığ bir kopyasını oluşturur. (Devralındığı yer: Object)
MemberwiseClone(Boolean)	Geçerli MarshalByRefObject nesnenin sığ bir kopyasını oluşturur. (Devralındığı yer: MarshalByRefObject)
RemoveAll()	Şu anda ToolTip bileşeniyle ilişkili olan tüm ToolTip metnini kaldırır.
SetToolTip(Control, String)	Araç İpucu metnini belirtilen denetimle ilişkilendirir.
Show(String, IWin32Window)	Belirtilen denetimle ilişkili ToolTip metnini ayarlar ve ToolTip'i modlu olarak görüntüler.
Show(String, IWin32Window, Int32)	Belirtilen denetimle ilişkili ToolTip metnini ayarlar ve ardından belirtilen süre için Araç İpucu'nu görüntüler.
Show(String, IWin32Window, Int32, Int32)	Belirtilen denetimle ilişkilendirilmiş ToolTip metnini ayarlar ve ardından ToolTip'i belirtilen göreli konumda modlu olarak görüntüler.
Show(String, IWin32Window, Int32, Int32, Int32)	Belirtilen denetimle ilişkilendirilmiş Araç İpucu metnini ayarlar ve belirtilen süre için belirtilen göreli konumda Araç İpucu'nu görüntüler.
Show(String, IWin32Window, Point)	Belirtilen denetimle ilişkilendirilmiş ToolTip metnini ayarlar ve ardından ToolTip'i belirtilen göreli konumda modlu olarak görüntüler.
Show(String, IWin32Window, Point, Int32)	Belirtilen denetimle ilişkilendirilmiş Araç İpucu metnini ayarlar ve belirtilen süre için belirtilen göreli konumda Araç İpucu'nu görüntüler.
StopTimer()	Görüntülenen Araç İpuçlarını gizleyen zamanlayıcıyı durdurur.
ToString()	Bu denetim için bir dize gösterimi döndürür.

Ekinlikler

Disposed	Bileşen yöntemine Dispose() yapılan bir çağrı tarafından atıldığında gerçekleşir. (Devralındığı yer: Component)
Draw	ToolTip çizildiğinde ve OwnerDraw özelliği olarak ayarlandığında true ve IsBalloon özelliği olduğunda falsegerçekleşir.
Popup	Bir ToolTip başlangıçta görüntülenmeden önce gerçekleşir. Bu, sınıfı için varsayılan olaydır ToolTip .

Ayrıca bkz.

• ToolTipIcon
• HelpProvider
• Genişletici Sağlayıcıları
• ToolTip Bileşeni (Windows Forms)