Sujets Tooltip DLL Version 0.1

Introduction

Mark
Tooltip
SetText
SetTitle
SetTxtColor
SetBkgColor
SetWidth
Version
Futur Expansions
 

>> Introduction



Cette DLL permets d'insérer des bulles d'aide sur des contrôles de Dialog dans mIRC comme par exemple pour apporter de l'aide sur certains fonctionnalités des controls du dialog.

Le principe de la DLL est simple, il faut tout d'abordMark le dialog pour qu'il soit reconnu par la DLL. Ensuite vous créez un Tooltip (normal ou ballon) vide et finalement vous configurez les aspects du tooltip.

Ci-dessous se trouve une liste des commandes disponibles dans le DLL. Vous pouvez aussi regarder dans le petit code de démo inclut dans le package pour voir comment sont utilisées les commandes dans un dialog.

Chacune des commandes du DLL retournes un message indiquant le succès (OK) ou l'échec (ERROR) de la commande avec de l'information sur le succès ou l'échec.

N.B. Vous pouvez marquer 255 dialogs simultanément et avoir 128 Tooltips simultanément par dialog marqué.
N.B. Pour les tooltips balloon, vous devez avoir IE 5.0+ ou une version de comctl32.dll 5.80+.

>> Mark



La première chose que vous devez faire est d'utiliser la commande Mark pour enregistrer le dialog. Elle n'accepte que la handle du dialog (HWND) que vous pouvez obtenir facilement avec $dialog(nom).hwnd.

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

>> Tooltip



Prochaine étape est de créer un Tooltip vide sur un ID de contrôle dans votre dialog.

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

>> SetText



Cette commande vous permets de configurer le texte du Tooltip. Si le texte excède la largeur de la fenêtre Tooltip, elle sera brisé où il y a des espaces pour respecter la largeur de la fenêtre. Vous pouvez forcer des sauts le ligne avec $crlf ou "\r\n" dans votre texte.

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

N.B. Le texte est limité à 1000 caractères au total ce qui est suffisant puisque mIRC est limité à 955 caractères.

>> SetTitle



Cette commande vous permets d'ajouter une titre en gras à votre info bulle. Le Tooltip par défaut vide n'a pas de titre ou icon de configuré. Si vous mettez un texte vide ($null) comme titre, il devient inactif et l'icone n'apparaîtra pas non plus.

echo -s $dll(tooltip.dll,SetTitle,$dialog(tooltip).hwnd > ID Icon Text)

The Icon can have 4 values:
  • 0 - no icon
  • 1 - ! icon
  • 2 - warning icon
  • 3 - error icon
N.B. Le texte est limité à 1000 caractères au total ce qui est suffisant puisque mIRC est limité à 955 caractères.

>> SetTxtColor



Cette commande vous laisse changer la couleur par défaut de windows du texte des infos bulles.

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

>> SetBkgColor



Cette commande vous permets de changer la couleur de fonds par défaut de windows des infos bulles.

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

>> SetWidth



Cette commande vous permets de configurer la largeur de la fenêtre des infos bulles. L'info bulle vide par défaut possède une largeur de 250 pixels. Si le texte est plus large que la largeur de la fenêtre, il sera brisé par les espaces pour forcer la largeur à être comprise dans les limites de la fenêtre.

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

>> Version



Retourne de l'information sur la version de la DLL.

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

>> Future Expansions



  • Commandes avec ID Multiples
  • Conguration des temps d'affichage des Tooltips
  • Configuration de Police
  • Reparation de Bugs

Tooltip DLL



- ClickHeRe
- © 2003
- Testing-> NightMaRe
- #scriptsdb.org @ Undernet @ Webnet
- http://scriptsdb.org


Tha... Help SDB mIRC Group Contact