1. Introduzione
Questa DLL permette di inserire dei riquadri di aiuto sui controlli dei Dialog mIRC. Può servire ad esempio per visualizzare delle informazioni relative alla funzionalità di certi controlli del dialog.

Il principio della DLL è semplice: innanzitutto bisogna indicare il dialog con il comando Mark al fine di renderlo riconoscibile dalla DLL. In seguito si crea un Tooltip vuoto (normale o a fumetto) e finalmente si possono configurare gli aspetti del tooltip.

Qui sotto si trova una lista dei comandi disponibili nella DLL. é anche possibile curiosare all'interno della piccola demo - inclusa nel pacchetto - del codice della DLL per vedere come sono utilizzati i comandi nel dialog.

Ognuno dei comandi della DLL ritorna un messaggio indicante il successo ( OK ) o l'insuccesso ( ERROR ) dell'operazione, accompagnato da informazioni aggiuntive.

N.B. Si possono "marcare" contemporaneamente 255 dialog e avere simultaneamente, in uno solo di essi, 128 Tooltip.
N.B. Per i tooltip a fumetto, è necessario che sull'Hard disk sia presente una versione di Internet Explorer della serie 5.x o successiva oppure una versione di comctl32.dll maggiore o uguale alla 5.80. 

2. Mark
La prima cosa da fare è utilizzare il comando Mark per registrare il dialog. Questo comando accetta solamente l'handle del dialog (HWND) che si può ottenere facilmente con l'identificatore $dialog(NAME).hwnd

echo -s $dll(tooltip.dll,Mark,$dialog(NAME).hwnd)

dove NAME rappresenta il nome del dialog 

3. TollTip
La prossima tappa è creare un Tooltip vuoto su un ID del dialog.

echo -s $dll(tooltip.dll,ToolTip,$dialog(NAME).hwnd > ID) 

4. SetText
Questo comando permette di configurare il testo del Tooltip. Se il testo è più largo della larghezza della finestra, viene interrotto e ripreso nella linea successiva, al fine di non modificare la larghezza impostata. Si può forzare il testo a capo con $crlf o " \r\n " .

echo -s $dll(tooltip.dll,SetText,$dialog(NAME).hwnd > ID TEXT)

N.B. Il testo è limitato a 1000 caratteri, che è sufficiente in quanto il limite di mIRC è 955.

5. SetTitle
Questo comando consente di aggiungere un titolo in grassetto al Tooltip, che, normalmente, non ne ha. Qualora venisse messo il testo "$null" come titolo, diverrebbe inattivo e l'icona non apparirebbe più.

echo -s $dll(tooltip.dll,SetTitle,$dialog(NAME).hwnd > ID ICON TEXT)

ICON può assumere 4 valori:

¥         0 Ð senza icona 

¥         1 Ð icona "!" 

¥         2 Ð icona di attenzione

¥         3 Ð icona di errore

N.B. Il testo è limitato a 1000 caratteri, che è sufficiente in quanto il limite di mIRC è 955.

6. SetTxtColor
Questo comando permette di cambiare il colore del testo del Tooltip

echo -s $dll(tooltip.dll,SetTxtColor,$dialog(NAME).hwnd > ID $rgb(R,G,B))

7. SetBgkColor
Questo comando permette di cambiare il colore di sfondo del Tooltip

echo -s $dll(tooltip.dll,SetBkgColor,$dialog(NAME).hwnd > ID $rgb(R,G,B))

8. SetWidth
Questo comando consente di configurare la larghezza del Tooltip, che di default equivale a 250 pixel. Se il testo è più largo della larghezza della finestra, viene mandato a capo, al fine di non modificare la larghezza impostata.

echo -s $dll(tooltip.dll,SetWidth,$dialog(NOME).hwnd > ID Width)

N.B. WIDTH dev'essere indicato in pixel

9. Version
Ritorna informazioni relative alla DLL

echo -s $dll(tooltip.dll,Version,.)

10 . Espasioni future
¥         Comandi con ID multipli

¥         Configurazione dellÕintervallo di tempo dopo il quale il Tooltip viene visualizzato

¥         Configurazione del carattere

¥         Riparazione dei bug

Esempio

Autore: ClickHere
- Testing-> NightMaRe
- #scriptsdb.org @ Undernet @ Webnet
- http://scriptsdb.org

- Versione tradotta in italiano da SkY ( e-m@il )

    | Torna all'indice della Guida |