Menu items within EditLive! for Java are specified through the use of a <menuItem> XML element. The name attribute of the <menuItem> element determines which menu item is inserted. EditLive! for Java is provided with a collection of predefined interface items which may be placed on the EditLive! for Java menus, the shortcut menu or the toolbars. Items from the interface command collection will have default menu item text associated with them. They may also have default mnemonics, images and shortcuts. For more information on what interface commands are available for use please see the EditLive! for Java Interface Command Collection section of this document.

The following example would add the New, Open..., Save and Save As... items to a menu with the name File.

<editLive>
  ...
  <menuBar>
    ...
      <menu name="&amp;File">
        <menuItem name="New"/>
        <menuItem name="Open"/>
        <menuItem name="Save"/>
        <menuItem name="SaveAs"/>
      </menu>
    ...
  </menuBar>
  ...
</editLive>

Some menu items are added to the applet's interface in a group. These groups of menu items within EditLive! for Java are specified through the use of a <menuItemGroup> XML element. The name attribute of the <menuItemGroup> element determines which menu item group is inserted. EditLive! for Java is provided with a collection of predefined interface item groups which may be placed on the EditLive! for Java menus and toolbars. Items from the interface command collection will have default menu item text associated with them. They may also have default mnemonics, images and shortcuts. For more information on what interface commands are available for use please see the EditLive! for Java Interface Command Collection section of this document. The activation of menu items in menu item groups is mutually exclusive, for example, the Browser View item cannot be activated at the same time as the Window View item.

The following example would add the Browser View and Window View items to the View menu.

<editLive>
  ...
  <menuBar>
    ...
      <menu name="&amp;View">
        <menuItemGroup name="FrameView"/>
      </menu>
    ...
  </menuBar>
  ...
</editLive>

Menu separators are horizontal lines spanning the width of the menu which can be used to visually break a menu into its constituent parts and areas. These are added through the use of the <menuSeparator> within a <menu> element. They serve no purpose other than that of a visual aid.

The Ephox logo:

For example, the following XML would remove the Ephox branding and associated About dialog from the menu:

<editLive>
  ...
  <menuBar showAboutMenu="false">
    ...
  </menuBar>
  ...
</editLive>      

Menu names in EditLive! for Java (e.g. File, Tools, etc) are specified by developers in the <menu> element. Ephox has provided 8 menu names that will be automatically translated into the end user's current language. These names are listed in the XML Configuration information for the <menu> element.

Toolbar buttons in EditLive! for Java are specified through the use of a <toolbarButton> XML element. The name attribute of the <toolbarButton> element determines which toolbar button is inserted. EditLive! for Java is provided with a collection of predefined interface items which may be placed on the EditLive! for Java toolbars, the menus or shortcut menu. Items from the interface command collection will have default tool tip text associated with them. Most also have default images, however some of the items may not have images associated with them. It is recommended that interface commands without associated images are not placed on the toolbars. For more information on what interface commands are available for use please see the EditLive! for Java Interface Command Collection section of this document.

The following example would add the New, Open..., Save and Save As... items to a toolbar with the name command:

<editLive>
  ...
  <toolbars>
    ...
      <toolbar name="command">
        <toolbarButton name="New"/>
        <toolbarButton name="Open"/>
        <toolbarButton name="Save"/>
        <toolbarButton name="SaveAs"/>
      </toolbar>
    ...
  </toolbars>
  ...
</editLive>

Some toolbar buttons are added to the applet's interface in a group. These groups of toolbar buttons within EditLive! for Java are specified through the use of a <toolbarButtonGroup> XML element. The name attribute of the <toolbarButtonGroup> element determines which toolbar button group is inserted. EditLive! for Java is provided with a collection of predefined interface item groups which may be placed on the EditLive! for Java menus and toolbars. Items from the interface command collection will have default tool tip text associated with them. Most also have default images, however some of the items may not have images associated with them. It is recommended that interface item groups without associated images are not placed on the interface. For more information on what interface commands are available for use please see the EditLive! for Java Interface Command Collection section of this document.

The following example would add the Align Left, Align Center and Align Right buttons from the alignment button group to the toolbar named command.

<editLive>
  ...
  <toolbars>
    ...
      <toolbar name="command">
        <toolbarButtonGroup name="Align"/>
      </toolbar>
    ...
  </toolbars>
  ...
</editLive>

Combo boxes for the style, font typeface and font size text attributes can be added to the EditLive! for Java toolbar through the use of a <toolbarComboBox> element with a specific value for the name attribute. Each toolbar combo box has a specific value for the name attribute associated with it. Furthermore, the items listed in each of these combo boxes can be specified by the developer through the inclusion of <comboBoxItem>child elements in a <toolbarComboBox> element.

For example, the following XML would create the Style drop down combo box in the EditLive! for Java Format Toolbar with the listing of Normal, Heading 1, Heading 2 and Heading 3 items which represent the <P>, <H1>, <H2> and <H3> styles respectively:

<editLive>
  ...
    <toolbars>
    ...
      <toolbar name="format">
        ...
        <toolbarComboBox name="tlbStyle">
          <comboBoxItem name="P" text="Normal" />
          <comboBoxItem name="H1" text="Heading 1" />
          <comboBoxItem name="H2" text="Heading 2" />
          <comboBoxItem name="H3" text="Heading 3" />
        </toolbarComboBox>
        ...
      </toolbar>
    </toolbars>
    ...
</editLive>     

The toolbar combo boxes available for use with EditLive! for Java, their corresponding function and their associated value for the <toolbarComboBox> name are listed below in the Toolbar Combo Box Items section of the EditLive! for Java Interface Command Collection.

Toolbar separators are vertical lines spanning the height of the toolbar which can be used to visually break a toolbar into its constituent parts and areas. These are added through the use of the <toolbarSeparator> within a <toolbar> element. They serve no purpose other than that of a visual aid.

This collection of interface commands can be used within menus, including the shortcut menu, and toolbars in EditLive! for Java. The items, their corresponding function, tool tip and menu text, mnemonic, shortcuts, images and their associated value for the relevant name attribute are listed below:

File Commands

Function	XML Name Attribute	Menu or Tool Tip Text	Shortcut	Image	Mnemonic
Create a new file.	New	New	CTRL+N		N
Open an existing file on the local machine.	Open	Open...	CTRL+O		O
Save a file to the local machine.	Save	Save	CTRL+S		S
Save a file to the local machine with a different name.	SaveAs	Save As...	CTRL+ SHIFT+S	N/A	A

Edit Commands

Function	XML Name Attribute	Menu or Tool Tip Text	Shortcut	Image	Mnemonic
Undo the last editor action.	Undo	Undo	CTRL+Z		U
Redo the last undone editor action.	Redo	Redo	CTRL+Y		R
Cut the selection.	Cut	Cut	CTRL+X		T
Copy the selection.	Copy	Copy	CTRL+C		C
Paste.	Paste	Paste	CTRL+V		P
Paste Special.	PasteSpecial	Paste Special	N/A	N/A	S
Select all editor content.	SelectAll	Select All	CTRL+A	N/A	L
Find text in the editor.	Find	Find...	CTRL+F		F

View Commands

Function	XML Name Attribute	Menu or Tool Tip Text	Shortcut	Image	Mnemonic
Show or hide document navigator.	ShowDocument Navigator	Document Navigator	N/A	N/A	N
Show or hide paragraph markers and editing grid lines.	ParagraphMarker	Show/Hide Paragraph Markers	N/A		P
Display EditLive! for Java in a seperate window	Popout	Window View	N/A		P

Insert Commands

Function	XML Name Attribute	Menu or Tool Tip Text	Shortcut	Image	Mnemonic
Insert a hyperlink.	HLink	Hyperlink...	CTRL+K		H
Insert a horizontal line.	HRule	Horizontal Line	N/A		L
Insert a symbol.	Symbol	Symbol...	N/A		S
Insert a bookmark.	Bookmark	Bookmark...	N/A		K
Insert an image from the local machine.	ImageLocal	Local Image...	N/A	N/A	M
Insert an image from the server image library.	ImageServer	Server Image Library...	N/A		I
Insert an embedded object or multimedia file.	InsertObject	Insert Object...	N/A	N/A	N/A
Insert a HTML comment.	InsertComment	Insert Comment...	N/A		N/A
Insert a Date and Time	DateTime	Insert Date and Time...	N/A		T

Format Commands

Function	XML Name Attribute	Menu or Tool Tip Text	Shortcut	Image	Mnemonic
The text color selector.	Color	Color	N/A		C
The text highlight color selector.	HighlightColor	Highlight Color	N/A		C
Bold text.	Bold	Bold	CTRL+B		B
Italic text.	Italic	Italic	CTRL+I		I
Underline text.	Underline	Underline	CTRL+U		U
Strikethrough text.	Strike	Strikethrough	N/A		S
Format painter.	FormatPainter	Format Painter	CTRL + SHIFT + C		N/A
Remove formatting.	RemoveFormatting	Remove Formatting	CTRL + SPACE		R
Increase the paragraph or list indent.	IncreaseIndent	Increase Indent	N/A		N
Decrease the paragraph or list indent.	DecreaseIndent	Decrease Indent	N/A		D

Tool Commands

Function	XML Name Attribute	Menu or Tool Tip Text	Shortcut	Image	Mnemonic
Run the spell checker.	Spelling	Spelling...	F7		S
Turn the background spell checker on and off.	BackgroundSpell Checking	Enable/ Disable Check Spelling As You Type	N/A		B
Perform a word count on the document.	WordCount	Word Count...	N/A		W
Perform an accessibility compliance check on the document, based on the W3C standards.	Accessibility	Accessibility Report...	F8		A

Table Commands

Function	XML Name Attribute	Menu or Tool Tip Text	Shortcut	Image	Mnemonic
Insert a table wizard. Allows user to click and select number of rows and columns. This item can only be used as a toolbar button.	InsTableWizard	Insert Table	N/A		I
Insert a table.	InsTable	Insert Table...	N/A		I
Insert a row in the current table.	InsRow	Insert Row	N/A		N/A
Insert a column in the current table.	InsCol	Insert Column	N/A		N/A
Insert rows or columns in the table.	InsRowCol	Insert Row or Column...	N/A	N/A	R
Insert a cell in a table.	InsCell	Insert Cell	N/A	N/A	E
Delete a row from a table.	DelRow	Delete Row	N/A		D
Delete a column from a table.	DelCol	Delete Column	N/A		C
Delete a cell from a table.	DelCell	Delete Cell	N/A	N/A	L
Split a cell in a table.	Split	Split Cell...	N/A		S
Merge cells in a table.	Merge	Merge Cells	N/A		M
Toggle table gridlines on and off.	Gridlines	Show/Hide Gridlines	N/A		G

Miscellaneous Commands

Function	XML Name Attribute	Menu or Tool Tip Text	Shortcut	Image	Mnemonic
Edit a HTML comment, scripting tag or unknown custom tag.	EditTag	Edit Tag...	N/A		N/A
Remove a hyperlink.	RemoveHyperlink	Remove Hyperlink	N/A		N/A

The following menu and toolbar items can only be used with the EditLive! Equation Editor Add-On

Function	XML Name Attribute	Menu or Tool Tip Text	Shortcut	Image	Mnemonic
Insert a MathML mathematical equation.	InsertEquation	Insert Equation	N/A		E
Edit a MathML mathematical equation.	EditEquation	Edit Equation...	N/A	N/A	N/A

This collection of interface commands can be used only within menus and toolbars in EditLive! for Java. These interface items are added as a group of buttons or menu items within EditLive! for Java. The activation of buttons and menu items in the groups is mutually exclusive, for example, the left alignment item cannot be activated at the same time as the center or right alignment buttons. The items, their corresponding function, tool tip and menu text, mnemonic, shortcuts, images and their associated value for the relevant name attribute of the group are listed below:

Formatting Commands

Function	XML Name Attribute	Menu or Tool Tip Text	Shortcut	Image	Mnemonic
Insert an ordered list or change an unordered list to an ordered list.	List	Ordered List	N/A		O
Insert an unordered list or change an ordered list to an unordered list.		Unordered List	N/A		T
Set left alignment.	Align	Align Left	CTRL+L		L
Set center alignment.		Align Center	CTRL+E		C
Set right alignment.		Align Right	CTRL+R		R
Superscript text.	Script	Superscript	N/A		S
Subscript text.		Subscript	N/A		S

The following predefined submenus can be used in any menu of the EditLive! for Java interface.

The following predefined combo box items are available for use on the EditLive! for Java toolbars.

Example Image	Function	XML Name Attribute
	List of styles available for use in this document.	Style
	List of fonts available for use in this document.	Face
	List of font sizes available for use in this document.	Size

The color choosers for both the Color and Hightlight Color menu and toolbar items can be customized to include only a specific set of predefined colors. The More Colors... item will also be available in addition to any predefined colors.

In order to customize the Color or Highlight Color menu items the relevant <menuItem> element must be replaced with a <submenu> element with the same name attribute. Each color should then be listed as a separate <menuItem> element. For each color <menuItem> element the name attribute should provide the HTML color value (either as a hexidecimal color value or reserved color key word, e.g. #FF0000 or red). The text attribute for each color <menuItem> element should provide a text description of the color.

<editLive>
  ...
  <menuBar>
    ...
      <menu name="F&amp;ormat">
        ...
        <submenu name="mnuColor">
          <menuItem name="#FF0000" text="Red" />
          <menuItem name="blue" text="Blue" />
          <menuItem name="green" text="Green" />
        </submenu>
        ...
      </menu>
    ...
  </menuBar>
  ...
</editLive>

In order to customize the Color or Highlight Color toolbar items the relevant <toolbarButton> element must be replaced with a <toolbarComboBox> element with the same name attribute. Each color should then be listed as a separate <comboBoxItem> element. For each color <comboBoxItem> element the name attribute should provide the HTML color value (either as a hexidecimal color value or reserved color key word, e.g. #FF0000 or red). The text attribute for each color <comboBoxItem> element should provide a text description of the color.

<editLive>
  ...
  <toolbars>
    ...
      <toolbar name="format">
        ...
        <toolbarComboBox name="tlbHighlightColor">
          <comboBoxItem name="#FF0000" text="Red" />
          <comboBoxItem name="blue" text="Blue" />
          <comboBoxItem name="green" text="Green" />
        </toolbarComboBox>
        ...
      </toolbar>
    ...
  </toolbars>
  ...
</editLive>