Modifying the Mailbox Tool Bar

This section describes how to modify the Sun Java System Messenger Express mailbox tool bar shown in Modifying the Mailbox Tool Bar.

Figure 3–3 Sun Java System Messenger Express Mailbox Tool Bar

You can modify the following on the Sun Java System Messenger Express mailbox tool bar:

• Change the layout of the mailbox tool bar relative to the rest of the page

• Rearrange the order of tools

• Change the tools text

To Modify the Mailbox Tool Bar

To modify the mailbox tool bar, edit the appropriate files as follows:

• To customize the layout relative to the rest of the page, edit the toolFrame() function in the main.js file.

• To customize the layout within the tool bar and the associated graphics, edit the getToolbar() function in the mbox_fs.html file.

• To customize the text associated with the graphics in the Tool Bar, edit the i18n[] values get mail, compose, search, new search, file selected message, delete, undelete, and expunge in the lang/i18n.js file.

Functionally, toolFrame() in main.js calls getToolbar()in mbox_fs.html to get the HTML code to write out to the page.

The getToolbar() function in mbox_fs.html assembles the code and assigns the functions to the graphics by calling toolbar() in main.js, which takes care of items such as colors and text-only versions.

The getToolbar() function in mbox_fs.html also calls folderSelection() in main.js to generate the drop-down folder list.

The functions assigned by getToolbar() in mbox_fs.html that handle the tool clicks are:

• Get Mail: main.refreshMbox()

• Compose: main.compose(”new”)

• Search: parent.srch()

• Move Messages to Folder: parent.move()

• Delete: parent.delmsg(), parent.undelmsg(), parent.exmsg() (depending on whether the message is in the trash folder or not)

Example—Mailbox Tool Bar Modifications

The example shown in Example—Mailbox Tool Bar Modifications makes “Search” as the first tool and changes the text of the “Get Mail” tool to “Get Messages.”

Figure 3–4 Example Mailbox Tool Bar Modifications

Example—Mailbox Tool Bar Modifications shows the necessary changes to be made in files mbox_fs.html (layout).

Example 3–3 Altering Tool Bar Layout (mbox_fs.html)

function getToolbar() {
....
main.WMtoolbar(
....
(main.srch != ’’ ? i18n[’new search’] : i18n[’search’]),
’parent.srch()’, ’imx/search.gif’, 27, 25, true,
               
i18n[’get mail’], ’main.refreshMbox()’, ’imx/pull.gif’, 27, 25,
true, i18n[’compose’], ’main.compose(”new”)’, ’imx/compose.gif’,
27, 25, true)
....
}


            

Example—Mailbox Tool Bar Modifications

 shows the necessary changes to be made in file en/i18n.js (text)
            

Example 3–4 Altering Tool Bar Text (en/i18n.js)

// Tool Bars
....
i18n[’get mail’] = ’
               Get Messages
               ’