Subjects Tooltip DLL Version 0.1

Introduction

Mark
Tooltip
SetText
SetTitle
SetTxtColor
SetBkgColor
SetWidth
Version
Futur Expansions
 

>> Introduction



This DLL is intended to provide tooltips on dialog controls in mIRC so people can add info on certains aspects of their dialog items instead of writing everything in a help file.

The principle of the DLL is quite simple, you first have to Mark the dialog so it is recognized by the DLL. Afterwards, you create an empty Tooltip (normal or balloon) and finally you configure the aspects of this tooltip.

Below are a list of the DLL Commands available. You can also look in the tooltip.mrc demo included with the package to visualize how it is used in a dialog example.

Every DLL command returns a message indicating succes (OK) or failure (ERROR) of the command with some info on the succes or error.

N.B. Currently you can Mark 255 dialogs simultaneously and have 128 simultaneous Tooltips per Marked dialog.
N.B. For the balloon tooltips, you need IE 5.0+ or the comctl32.dll version 5.80+.

>> Mark



First thing you need to do is mark the dialog with the Mark command. It accepts only a dialog Handle (HWND) that you can retreive easily with $dialog(name).hwnd.

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

>> Tooltip



Next step is to enable an empty Tooltip on a control ID in you're dialog.

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

>> SetText



This command lets you set the Tooltip Text. If the Tooltip text exceeds the tooltip width of window, it will be space wrapped to fit the window width. You can also force line returns with $crlf or "\r\n" in you're text.

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

N.B. Text is limited to 1000 caracters total which is enough since mIRC's limit is 955 chars.

>> SetTitle



This command lets you insert a bold title to you're infotip. Empty Tooltip has no icon set and no title set. If you put an empty text field for the title, it becomes disabled and you do not see the icon either.

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. Text is limited to 1000 caracters total which is enough since mIRC's limit is 955 chars.

>> SetTxtColor



This command lets you change the default windows setting color for the infotip text.

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

>> SetBkgColor



This command lets you change the default windows background color for the info tip window.

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

>> SetWidth



This lets you configure the infotip window width. Default Empty infotip width is 250 pix wide. If the text is wider than infotip window width, it is space wrapped to fit width.

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

>> Version



Returns information on DLL version.

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

>> Future Expansions



  • Multiple ID commands
  • Conguration of Tooltip Timeout Times
  • Font Configuration
  • Bug Repairing...

Tooltip DLL



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


Tha... Help SDB mIRC Group Contact