ToolTip Sınıf

Tanım

Ad Alanı:: System.Windows.Forms

Bütünleştirilmiş Kod:: System.Windows.Forms.dll

Kaynak:: ToolTip.cs

Kaynak:: ToolTip.cs

Kaynak:: ToolTip.cs

Kaynak:: ToolTip.cs

Kaynak:: ToolTip.cs

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

Kullanıcı işaretçiyi denetimin üzerinde beklettiğ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 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

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 örneği, formun ToolTip etkin olup olmaması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 bir 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 ToolTip , kullanıcı işaretçiyi 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 bir denetim için TextBox Araç İpucu metni belirtebilirsiniz. İpuçları sağlamanın yanı sıra, ç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ı 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 bir bileşen genellikle tek ToolTip bir formda birden çok denetim için Araç İpuçları oluşturmak için kullanılır. oluşturduktan ToolTipsonra, Araç İpucu görüntüleme metnini tek bir denetimle ilişkilendirmek için yöntemine ayrı bir çağrı SetToolTip kullanın. Daha sonra kullanıcı işaretçiyi bir denetim üzerinde hareket ettiğinde, metin içeren Araç İpucu görüntülenir. Denetimle ilişkili metni değiştirmek için aynı denetim için birden çok kez çağırabilirsiniz SetToolTip . Bir denetimle ilişkili metni almak için yöntemini kullanın GetToolTip . Sınıfın ToolTip bir örneğiyle tüm ToolTip metin ilişkilendirmelerini kaldırmak için yöntemini kullanın RemoveAll .

Uyarı

Devre dışı bırakılan denetimler için Araç İpucu metni görüntülenmez. ShowAlways Özelliği olarak ayarlanmadığı truesü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üş	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 . Araç İpucu 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 System.ComponentModel.IExtenderProvider uygular. Araç İpuçları, tasarım zamanında aynı formdaki denetimleri genişleterek özellik ToolTip ekler. Genişletici sağlayıcıları hakkında daha fazla bilgi için bkz . Genişletici Sağlayıcıları.

Oluşturucular

Name	Description
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

Name	Description
Active	Araç İpucu'nu şu anda etkin olup olmadığını belirten bir değer alır veya ayarlar.
AutomaticDelay	Araç İpucu 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 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	Araç İpucu 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	Araç İpucu 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ç İpucu'na balon penceresi kullanılıp kullanılmayacağını belirten bir değer alır veya ayarlar.
OwnerDraw	Araç İpucu'nun işletim sistemi tarafından mı yoksa sizin sağladığınız kodla mı çizildiğini gösteren bir değer alır veya ayarlar.
ReshowDelay	İşaretçi bir denetimden diğerine taşınırken sonraki Araç İpucu pencereleri görünmeden önce geçmesi gereken süreyi alır veya ayarlar.
ShowAlways	Üst denetimi etkin olmasa bile 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 ISite Component. (Devralındığı yer: Component)
StripAmpersands	Ve (&) karakterlerin nasıl işleneceğini belirleyen bir değer alır veya ayarlar.
Tag	ile ToolTipilişkilendirilmiş 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

Name	Description
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()	tarafından Componentkullanılan tüm kaynakları serbest bırakır. (Devralındığı yer: Component)
Dispose(Boolean)	tarafından Component kullanılan yönetilmeyen kaynakları serbest bırakır ve isteğe bağlı olarak yönetilen kaynakları serbest bırakır.
Dispose(Boolean)	tarafından Component kullanılan yönetilmeyen kaynakları serbest bırakır ve isteğe bağlı olarak yönetilen kaynakları serbest bırakır. (Devralındığı yer: Component)
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()	Geçersiz. 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 Componenttarafından Container sağlanan bir hizmeti temsil eden bir nesnesi döndürür. (Devralındığı yer: Component)
GetToolTip(Control)	Belirtilen denetimle ilişkili Araç İpucu metnini alır.
GetType()	Geçerli örneğin Type alır. (Devralındığı yer: Object)
Hide(IWin32Window)	Belirtilen Araç İpucu penceresini gizler.
InitializeLifetimeService()	Geçersiz. 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 Objectbasit 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, Int32, Int32, Int32)	Belirtilen denetimle ilişkili Araç İpucu metnini ayarlar ve belirtilen süre için Belirtilen göreli konumda Araç İpucu'nu görüntüler.
Show(String, IWin32Window, Int32, Int32)	Belirtilen denetimle ilişkili Araç İpucu metnini ayarlar ve ardından ToolTip'i belirtilen göreli konumda modlu olarak görüntüler.
Show(String, IWin32Window, Int32)	Belirtilen denetimle ilişkili Araç İpucu metnini ayarlar ve ardından belirtilen süre için Araç İpucu'nu görüntüler.
Show(String, IWin32Window, Point, Int32)	Belirtilen denetimle ilişkili 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şkili Araç İpucu metnini ayarlar ve ardından ToolTip'i belirtilen göreli konumda modlu olarak görüntüler.
Show(String, IWin32Window)	Belirtilen denetimle ilişkili ToolTip metnini ayarlar ve ToolTip'i modlu olarak 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

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

Şunlara uygulanır

Ayrıca bkz.

Geri Bildirim

Bu sayfayı yararlı buldunuz mu?