- Home
- General Usage
- DCX Controls
- DCX Features
- About DCX
|
| XMenuBar |
XMenuBar is a command implemented to replace the mIRC menubar using XPopup menus.
|
| XMenuBar Marking and Callback |
Just like with XDialog, you must "mark" the mIRC menubar prior to using XMenuBar.
To mark the mIRC menubar, use /xmenubar -M and specify a callback function of your choice.
The callback function will only be passed 1 parameter, and that is the MENU_ID. The menu ID is sent to the callback function to allow customisation of event flow. To stop mIRC from processing the menu command, return $true from the callback alias.
An example of a simple callback function would be:
alias xmenubar_cb {
;// Prevent user from accessing Help -> Contents
if ($1 == 190) return $true
}
|
| Special Menus and Menu IDs |
The callback parses menu clicks before mIRC gets a chance to process them. If the custom XPopupMenu has an ID which matches the ID of an existing mIRC menu item, it can be used to call the mIRC functionality.
For example, the menu ID for the mIRC Options dialog is 159. If you used /xpop -a and specified the ID 159 and added the XPopup menu to the XMenuBar, the item will open up the mIRC Options dialog when clicked.
Additionally, there is a special menu called the scriptpopup menu. This allows you to add the original mIRC scriptable popup menu on your XMenuBar. The usage of the other special menus (mirc and mircbar) has been disabled for the XMenuBar.
Note: For custom menu commands which are specific to only your script, it is advised you use an ID starting from 15000. This is to prevent any clashes in existing IDs and XPopup menu items.
Please do not create confusing or misleading menus!
Below is a list of special menu IDs for those wishing to redesign mIRC's menubar.
Note: The list was compiled from mIRC v6.31.
|
| /xmenubar Commands |
| The /xmenubar command is used to replace the mIRC menubar. |
| $xmenubar Properties |
| The $xmenubar identifier is used to retrieve information about the DCX XMenuBar implementation. |
|
