A használathoz tegyünk fel egy ToolTip komponenst a Form-ra a Win Forms ToolBox-ról. Ezután válasszuk ki a Form-on azt a komponenst, melyhez a súgó szöveget rendelnénk. Ekkor a tulajdonság lapon (Properties) megjelenik egy Misc nevű kategória és ezen belül egy ToolTip on ToolTip1 nevű szöveges típusú property. Ide már csak be kell írnunk azt a szöveget, melyet szeretnénk megjelentetni, ha a felhasználó az egérrel rámutat a komponensünkre. A megjelenés tulajdonságait a ToolTip komponensnél állíthatjuk be.
Abban az esetben, ha a Form-unkhoz több ToolTip komponens is tartozik, akkor a tulajdonságlapon is több ehhez tartozó property jelenik meg. Így minden ToolTip komponenshez önálló súgó szöveget rendelhetünk. A mellékelt példában a TextBox2 komponensnél ezt fel is használjuk: az egyik súgó szöveg fél másodpercig látható, majd a másik jelenik meg.
Nézzük most milyen tulajdonságai vannak a ToolTip komponensnek.
Active
Osztály: System.Windows.Forms.ToolTip
Public Property Active As Boolean
Az Active logikai property-vel szabályozhatjuk, hogy az adott ToolTip komponenshez rendelt súgó szövegek megjelenjenek-e vagy sem.
AutomaticDelay
Osztály: System.Windows.Forms.ToolTip
Public Property AutomaticDelay As Integer
Az InitialDelay, AutoPopDelay, ReshowDelay property-k értékét úgy is beállíthatjuk, hogy az AutomaticDelay property-nek adunk csupán értéket. Ennek hatására a másik három értéke az alábbiak szerint módosul:
- AutoPopDelay: az AutomaticDelay-ben megadott érték tízszerese lesz.
- InitialDelay: egyenlő lesz az AutomaticDelay-ben megadott értékkel.
- ReshowDelay: az AutomaticDelay property értékének ötöde lesz.
AutoPopDelay
Osztály: System.Windows.Forms.ToolTip
Public Property AutoPopDelay As Integer
Az AutoPopDelay property tárolja azt az ezredmásodperc értéket, amennyi ideig látható lesz az ablak megjelenés után.
InitialDelay
Osztály: System.Windows.Forms.ToolTip
Public Property InitialDelay As Integer
Az InitialDelay property-ben állítható, hogy mennyi idő múlva jelenjen meg a kis ablak az adott kontrol felett ezredmásodperben. Nulla esetén az alapérték lesz figyelembe véve.
ReshowDelay
Osztály: System.Windows.Forms.ToolTip
Public Property ReshowDelay As Integer
Az újra megjelenítés időtartamát a ReshowDelay property-ben adhatjuk meg.
ShowAlways
Osztály: System.Windows.Forms.ToolTip
Public Property ShowAlways As Boolean
Ha a ShowAlways property igaz, akkor a letiltott komponensek fölött is megjelenik a súgó szöveg.
GetToolTip
Osztály: System.Windows.Forms.ToolTip
Public Function GetToolTip(
ByVal control As Control
) As String
Egy kontrolhoz rendelt súgó szöveget lekérdezhetjük a GetToolTip függvény segítségével.
Paraméterek
ByVal control As Control
A kérdéses kontrolt a control paraméterben kell megadni.
Visszatérési érték
Az a sztring, mely a kontrolhoz lett rendelve.
RemoveAll
Osztály: System.Windows.Forms.ToolTip
Public Sub RemoveAll()
Az összes súgó szöveg eltávolításra kerül a RemoveAll hívásakor, mely ToolTip kontrolhoz lett rendelve.
SetToolTip
Osztály: System.Windows.Forms.ToolTip
Public Sub SetToolTip(
ByVal control As Control,
ByVal caption As String
)
Egy kontrolhoz hozzárendelhetünk egy súgó szöveget a SetToolTip függvény segítségével.
Paraméterek
ByVal control As Control
A felhasználandó kontrol.
ByVal caption As String
A control-ban megadott kontrolhoz rendelendő súgó szöveg.