                      ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
                          SMF Quick Menu v3.16
                        for mIRC 5.61 and higher
                                Help File
                      ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Homepage    : http://dgsoft.cjb.net
Quick Menu  : http://dgsoft.cjb.net/qm/
Skins       : http://dgsoft.cjb.net/qm/skins/


-=<Setup>=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=

After loading the addon using the /load command, Setup will check for
missing parameters and incompatibilities, then create a file to store it's
settings (qmenu.ini) and store all settings inside it. when finished it
will prompt you for the location of the skin directory (included with the
zip file), if you did not select a directory, you will be prompted when
opening the quick menu.

-=<Quick Menu>=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-

When opened, checks for missing parameters, and prompts you accordingly.
then, opens the menu.
Single-clicking one of the buttons will trigger the command associated with
the button.
Single-clicling and then dragging the titlebar will move the window.
Double-clicking the titlebar will (un)wrap the menu.
Right-clicking it will give you these options:

Load Skin    : Self-explanatory :)
Edit Buttons : Opens a dialog which allows you to customize QM's buttons
               and change skins.
Refresh      : Clears mIRC's cache and reloads the menu.
Close        : Self-explanatory :)

-=<Main Editor dialog>=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-

Opens a dialog with one listbox and 7 buttons which are:

Add       : Opens a new dialog to create a new button
Edit      : Opens another dialog with the selected button's specs.
Delete    : Deletes the selected button.
/\        : Moves the selected button one slot up.
\/        : Moves the selected button one slot down.
Close     : Closes the dialog and refreshes the menu if needed
*.qms     : Shows the name of a skin currently used, clicking it will open
            a browser dialog which will allow you to change it.
*         : Shows the name of a directory currently used as the skin
            directory, clicking it will open a browser dialog which will
            allow you to change it.
Alignment : Opens a dialog which will allow to you re-align the window. (use
            when the window moves when single-clicked on the titlebar).

-=<Button Editor dialog>=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-

Command editbox  : Can have a one-liner alias, open a file/directory or
                   execute one of QM's internal aliases (see section). 0
                   means no command is chosen.
"File" and "Dir" : Open browser dialogs to select the file/directory you
                   wish to set for the button.
Icon editbox     : Holds the path for the icon bitmap used for the button.
                   0 means no icon is selected. note: not all Quick Menu
                   skins use icons.
"File"           : Opens a browser dialog to select the icon you wish to set
                   for the button.
Title editbox    : Holds the button's "name" shown in the menu. 0 means no
                   name is chosen. note: not all Quick Menu skins use text
                   names.

-=<Internal Aliases>=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-

The Quick Menu uses several internal aliases to manage itself.
those aliases, that should be used ONLY for the buttons are:

^quit      : Closes the menu.
^load.skin : Opens a browser dialog to load a new skin.
^refresh   : Clears mIRC's cache and reloads the menu.
^reload    : Clears mIRC's cache, close the menu's window and reloads the
             menu.
^edit.menu : Opens the settings dialog.

-=<Skin Structure>=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-

The Quick Menu skins use the *.qms extention and are basically ini files
that use the following structure:

[File]

;specs section, mandatory

;tells the script that this is, in fact a quick menu skin file.
Info=QuickMenuSkin
;internal name.
Name=My_Skin
;window width
W=118
;the height of the button bitmap (for both regular and last)
ButtonH=20
;the height of the titlebar bitmap (for both regular and rolled)
TitleH=22

;bitmaps section, mandatory.

Title=SKIN\title_bitmap.bmp
TitleRolled=SKIN\rolled_title_bitmap.bmp
Button=SKIN\standard_button_bitmap.bmp
Lastbutton=SKIN\last_button_bitmap.bmp

;icons section, optional.

;X and Y locations of the icon on the button.
IconX=5
IconY=2
;the icon's borders
IconW=16
IconH=16

;title section, optional.

;colour
TextC=1
;X and Y locations of the title on the button.
TextX=28
TextY=5
;font name
TextF=Small fonts
;font size
TextFS=11
;text borders
TextW=100
TextH=16

;sound section, optional.

;played when a button is clicked, optional.
SndBtn=SKIN\button.wav
;played when the window is rolled/unrolled, optional.
SndTtl=SKIN\title.wav

note that while some sections are optional, when used all of the mentioned
specs must be used or the script will ignore the section.

new skins are always welcome, if you have made a skin for the quick menu,
please email it to rewt@dgsoft.cjb.net so i could post it on my page. :)

-=<Errors>=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-

In some cases, the window moves a few pixels to the side when single clicked
on the titlebar, i've not yet managed to fix that error as it does not
appear in all cases. if you face the situation of the window "following"
your mouse around, make sure mIRC is the active application, then press
SHIFT+F12 to stop the window. after that, open the settings dialog and open
the alignment dialog which will allow you to fix the moving window syndrome
automatically or manually.
