ToolTip Osztály

Definíció

Névtér:

System.Windows.Forms

Szerelvény:

System.Windows.Forms.dll

Egy kis téglalap alakú előugró ablak, amely egy vezérlő céljának rövid leírását jeleníti meg, amikor a felhasználó az egérmutatót a vezérlőn helyezi el.

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

Öröklődés

Object

MarshalByRefObject

Component

ToolTip

Megvalósítás

IExtenderProvider

Példák

Az alábbi példakód létrehozza az ToolTip osztály egy példányát, és társítja a példányt azzal, Form amelyikben a példány létrejön. A kód ezután inicializálja a késleltetési tulajdonságokat AutoPopDelay, InitialDelayés ReshowDelay. Emellett az osztály példánya úgy állítja be a ToolTipShowAlways tulajdonságot, hogy true az elemleírás szövege mindig megjelenjen, függetlenül attól, hogy az űrlap aktív-e. Végül a példa az Elemleírás szöveget két vezérlőelemmel társítja egy űrlapon, az a Button és a CheckBox. A példakód megköveteli, hogy a példában definiált metódus egy Form elnevezett és egy ButtonCheckBox elnevezett button1checkBox1vezérlőelemet tartalmaz, és hogy a metódus a konstruktortól Formlegyen meghívva.

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

Megjegyzések

ToolTip Az osztály segítségével tippeket adhat egy felhasználónak, amikor a felhasználó egy vezérlőre helyezi az egérmutatót. Az ToolTip osztály általában arra szolgál, hogy figyelmeztetse a felhasználókat egy vezérlő rendeltetésszerű használatára. Megadhat például elemleírás-szöveget egy TextBox olyan vezérlőhöz, amely elfogadja a nevet, megadva a vezérlőelembe beírandó név formátumát. A tippek mellett az ToolTip osztály használatával is megadhat futási idő állapotinformációkat. Az osztály használatával például megjelenítheti a ToolTip kapcsolat sebességét és a vonalminőségi adatokat, amikor a felhasználó az internetkapcsolat állapotát megjelenítő vezérlőre PictureBox helyezi az egérmutatót.

Az ToolTip osztály bármely tárolóban használható. Tároló explicit megadásához használja a konstruktort ToolTip(IContainer) . Általában egyetlen ToolTip összetevővel hozhatók létre elemleírások egyetlen űrlapon több vezérlőhöz. Miután létrehozott egy ToolTipeszközt, használjon egy külön hívást a metódushoz, SetToolTip hogy az Elemleírás megjelenítendő szöveget társítsa egy egyéni vezérlőhöz. Ezután, amikor a felhasználó egy vezérlőre helyezi az egérmutatót, megjelenik az elemleírás a szöveggel együtt. A vezérlőelemhez társított szöveg módosításához többször is meghívhatja SetToolTip ugyanazt a vezérlőt. A vezérlőelemhez társított szöveg lekéréséhez használja a metódust GetToolTip . Ha el szeretné távolítani az összes elemleírás-szövegtársítást az ToolTip osztály egy példányával, használja a metódust RemoveAll .

Note

Az elemleírás szövege nem jelenik meg a letiltott vezérlők esetében. Ha a ShowAlways tulajdonság nincs beállítva true, az elemleírások nem jelennek meg, ha a tároló inaktív.

Az ToolTip osztály az alábbi tulajdonságokat és metódusokat biztosítja az elemleírások alapértelmezett viselkedésének és megjelenésének módosításához.

Kategória	Társított tagok
Manuális megjelenítés	Active, Show, Hide, ShowAlwaysPopupStopTimer
Elemleírás időzítése	AutoPopDelay, InitialDelay, ReshowDelay, AutomaticDelayStopTimer
Tartalom	SetToolTip, GetToolTip, StripAmpersands, ToolTipIconToolTipTitleRemoveAll
Megjelenés	BackColor, ForeColor, IsBalloon, OwnerDrawUseAnimationUseFading

Ha le szeretné tiltani az összes elemleírás szövegét, hogy az ne jelenjen meg az alkalmazásban, használhatja a tulajdonságot Active . Az elemleírást általában az operációs rendszer rajzolja meg, de a ToolTipmegjelenés testreszabásához beállíthatja a OwnerDraw tulajdonságot true , és kezelheti az eseményt Draw .

Az ToolTipTitle osztály implementálja az System.ComponentModel.IExtenderProvider interfészt, amely egyetlen metódussal rendelkezik. CanExtend Az elemleírások kiterjesztik a vezérlőket ugyanazon az űrlapon a tervezéskor, és hozzáadnak egy tulajdonságot ToolTip . További információ az extender-szolgáltatókról: Extender Providers.

Konstruktorok

Name	Description
ToolTip()	Inicializálja a ToolTip megadott tároló nélküli új példányt.
ToolTip(IContainer)	Inicializálja az ToolTip osztály új példányát egy megadott tárolóval.

Tulajdonságok

Name	Description
Active	Lekéri vagy beállít egy értéket, amely jelzi, hogy az elemleírás jelenleg aktív-e.
AutomaticDelay	Lekéri vagy beállítja az elemleírás automatikus késleltetését.
AutoPopDelay	Lekéri vagy beállítja azt az időtartamot, amíg az elemleírás látható marad, ha a mutató egy adott elemleírás-szöveggel rendelkező vezérlőelemen áll.
BackColor	Lekéri vagy beállítja az elemleírás háttérszínét.
CanRaiseEvents	Beolvas egy értéket, amely jelzi, hogy az összetevő képes-e eseményt létrehozni. (Öröklődés forrása Component)
Container	Lekéri a IContainer .Component (Öröklődés forrása Component)
CreateParams	Lekéri az Elemleírás ablak létrehozási paramétereit.
DesignMode	Olyan értéket kap, amely jelzi, hogy az Component aktuálisan tervezési módban van-e. (Öröklődés forrása Component)
Events	Lekéri az ehhez Componentcsatolt eseménykezelők listáját. (Öröklődés forrása Component)
ForeColor	Lekéri vagy beállítja az elemleírás előtérszínét.
InitialDelay	Lekéri vagy beállítja az elemleírás megjelenése előtt eltelt időt.
IsBalloon	Lekéri vagy beállít egy értéket, amely jelzi, hogy az elemleírásnak buborékablakot kell-e használnia.
OwnerDraw	Lekéri vagy beállít egy értéket, amely jelzi, hogy az elemleírást az operációs rendszer vagy az Ön által megadott kód rajzolja-e meg.
ReshowDelay	Lekéri vagy beállítja azt az időtartamot, amelyet az elemleírások későbbi ablakainak megjelenése előtt meg kell jelenítenie, miközben a mutató egyik vezérlőről a másikra lép.
ShowAlways	Lekéri vagy beállít egy értéket, amely jelzi, hogy megjelenik-e egy Elemleírás ablak, még akkor is, ha a szülő vezérlőelem nem aktív.
Site	Lekéri vagy megadja a ISite értékét a Component-hez. (Öröklődés forrása Component)
StripAmpersands	Lekéri vagy beállít egy értéket, amely meghatározza az ampers és (&) karakterek kezelését.
Tag	Lekéri vagy beállítja a programozó által megadott adatokat tartalmazó objektumot a ToolTip.
ToolTipIcon	Lekéri vagy beállít egy értéket, amely meghatározza az elemleírás szövegével együtt megjelenítendő ikon típusát.
ToolTipTitle	Lekéri vagy beállítja az Elemleírás ablak címét.
UseAnimation	Beolvas vagy beállít egy értéket, amely meghatározza, hogy az elemleírás megjelenítésekor animációs effektust kell-e használni.
UseFading	Lekérdez vagy beállít egy értéket, amely meghatározza, hogy az elemleírás megjelenítésekor használjon-e elhalványulási effektust.

Metódusok

Name	Description
CanExtend(Object)	Visszaadja true , ha az elemleírás bővítő tulajdonságot tud nyújtani a megadott célösszetevőnek.
CreateObjRef(Type)	Létrehoz egy objektumot, amely tartalmazza a távoli objektumokkal való kommunikációhoz használt proxy létrehozásához szükséges összes releváns információt. (Öröklődés forrása MarshalByRefObject)
Dispose()	Felszabadítja a .-hez használt összes erőforrást Component. (Öröklődés forrása Component)
Dispose(Boolean)	Felszabadítja a felügyelt erőforrások által Component használt nem felügyelt erőforrásokat, és opcionálisan felszabadítja a felügyelt erőforrásokat.
Equals(Object)	Meghatározza, hogy a megadott objektum egyenlő-e az aktuális objektummal. (Öröklődés forrása Object)
Finalize()	Felszabadítja a nem felügyelt erőforrásokat, és egyéb tisztítási műveleteket hajt végre, mielőtt a Cursor szemétgyűjtő visszavenné.
GetHashCode()	Ez az alapértelmezett kivonatoló függvény. (Öröklődés forrása Object)
GetLifetimeService()	Lekéri a példány élettartamszabályzatát vezérlő aktuális élettartam-szolgáltatásobjektumot. (Öröklődés forrása MarshalByRefObject)
GetService(Type)	Olyan objektumot ad vissza, amely az általa vagy annak által ComponentContainernyújtott szolgáltatást jelöli. (Öröklődés forrása Component)
GetToolTip(Control)	Lekéri a megadott vezérlőelemhez társított elemleírás-szöveget.
GetType()	Lekéri az Type aktuális példányt. (Öröklődés forrása Object)
Hide(IWin32Window)	Elrejti a megadott Elemleírás ablakot.
InitializeLifetimeService()	Beolvas egy élettartam-szolgáltatásobjektumot a példány élettartam-szabályzatának szabályozásához. (Öröklődés forrása MarshalByRefObject)
MemberwiseClone()	Az aktuális Objectpéldány sekély másolatát hozza létre. (Öröklődés forrása Object)
MemberwiseClone(Boolean)	Az aktuális MarshalByRefObject objektum sekély másolatát hozza létre. (Öröklődés forrása MarshalByRefObject)
RemoveAll()	Eltávolítja az elemleírás összetevőhöz jelenleg társított összes elemleírás-szöveget.
SetToolTip(Control, String)	Elemleírás szövegének társítása a megadott vezérlővel.
Show(String, IWin32Window, Int32, Int32, Int32)	Beállítja a megadott vezérlőelemhez társított elemleírás-szöveget, majd megjeleníti a megadott időtartam elemleírását a megadott relatív pozícióban.
Show(String, IWin32Window, Int32, Int32)	Beállítja a megadott vezérlőelemhez társított elemleírás-szöveget, majd modálisan jeleníti meg az elemleírást a megadott relatív pozícióban.
Show(String, IWin32Window, Int32)	Beállítja a megadott vezérlőelemhez társított elemleírás-szöveget, majd megjeleníti a megadott időtartam elemleírását.
Show(String, IWin32Window, Point, Int32)	Beállítja a megadott vezérlőelemhez társított elemleírás-szöveget, majd megjeleníti a megadott időtartam elemleírását a megadott relatív pozícióban.
Show(String, IWin32Window, Point)	Beállítja a megadott vezérlőelemhez társított elemleírás-szöveget, majd modálisan jeleníti meg az elemleírást a megadott relatív pozícióban.
Show(String, IWin32Window)	Beállítja a megadott vezérlőelemhez társított elemleírás-szöveget, és modálisan jeleníti meg az elemleírást.
StopTimer()	Leállítja a megjelenített elemleírásokat elrejtő időzítőt.
ToString()	A vezérlőelem sztringreprezentációt ad vissza.

esemény

Name	Description
Disposed	Akkor fordul elő, ha az összetevőt a metódus hívása megsemmisíti Dispose() . (Öröklődés forrása Component)
Draw	Akkor fordul elő, ha az elemleírás meg van rajzolva, és a OwnerDraw tulajdonság be van állítvatrue, és a IsBalloon tulajdonság .false
Popup	Az elemleírások kezdeti megjelenítése előtt következik be. Ez az osztály alapértelmezett eseménye ToolTip .

Lásd még

• ToolTipIcon
• HelpProvider
• Extender-szolgáltatók
• Összetevő (Windows Forms)