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 bool Active {get; set;}
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 int AutomaticDelay {get; set;}
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 int AutoPopDelay {get; set;}
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 int InitialDelay {get; set;}
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 int ReshowDelay {get; set;}
Az újra megjelenítés időtartamát a ReshowDelay property-ben adhatjuk meg.
ShowAlways
Osztály: System.Windows.Forms.ToolTip
public bool ShowAlways {get; set;}
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 string GetToolTip(
Control control
);
Egy kontrolhoz rendelt súgó szöveget lekérdezhetjük a GetToolTip függvény segítségével.
Paraméterek
Control 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 void 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 void SetToolTip(
Control control,
string caption
);
Egy kontrolhoz hozzárendelhetünk egy súgó szöveget a SetToolTip függvény segítségével.
Paraméterek
Control control
A felhasználandó kontrol.
string caption
A control-ban megadott kontrolhoz rendelendő súgó szöveg.