ToolTip Sınıf

Tanım

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

Ö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.

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.

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

Şunlara uygulanır

Ayrıca bkz.