mouseover

Specifies whether the mouse pointer is currently over an item or page.

This option is set by an external program such as a parser, and is not saved or transmitted as part of the form. Instead, it is automatically created each time the form is read into memory, and is maintained only during display or processing.

Syntax

   <mouseover>status</mouseover>

Table 1. mouseover parameters
Parameter	Type	Description
status	on	mouse pointer is over item or page
	off	mouse pointer is not over item or page

Available in

button, check, checkgroup, combobox, field, list, popup, radio, radiogroup, richtext, toolbar, page global

Example

The following example shows a button that changes its color to white if it the mouse pointer is over it, and to blue if the pointer is not over it.

   <button sid="saveButton">
      <type>saveas</type>
      <value>Save</value>
      <bgcolor compute="mouseover == 'on' ? 'white' : 
         'blue'"></bgcolor>
   </button>

Usage details

Default: off
An object's mouseover option is set to on when the mouse pointer is over the object, and to off when the mouse pointer is not over the object.
A page global mouseover option is set to on when the mouse pointer is over the page (even if it is also over an item on the page).
A mouseover option in a toolbar is set to on when the mouse pointer is over the toolbar (even if it is also over an item in the toolbar).
The mouseover option is not included in form descriptions that are saved or transmitted.