MouseCursor (Property)

the rollover cursor used by a window control or by a window in the "GUI" tab of the description window of the control or window.
the rollover cursor used by a page control or by a page in the "Details" tab of the description window of the control or page.

Example

// Modify the cursor of the BTN_Validate button
BTN_Validate..MouseCursor = curHelp

// Modify the cursor of the cell
CELL_Bckgrd..MouseCursor = "./cursor/earth.ani"
// Modify the cursor of the edit control
EDT_Name..MouseCursor = "http://MyServer/MYPROJECT_WEB/pen_r.cur"

Syntax

Finding out the rollover cursor used for a window or for a window control Hide the details

<Cursor Name> = <Control Name>..MouseCursor

<Cursor Name>: Character string or integer constant

Name of the cursor used for the specified control or window. Can correspond to:
A specific cursor name (file with a .CUR or .ANI extension):
name of the cursor if the file is found in the current directory,
name and full path of the cursor if the file is found in a directory other than the current directory.
The custom mouse cursors (".CUR" or ".ANI") are not supported in Java.
A preset cursor identified by one of the following constants:
curHelp Help for an object
curIbeam Input cursor
curCross Standard cross
curArrow Standard arrow
curUpArrow Up arrow
curForbidden Sign not allowed
curHand Hand
curSystemHand System handIn Windows NT4, this cursor is the same as the one displayed by the curHand constant.
Cursor identical to curHand.
curWait Hourglass
curSize Cross Arrow cursor
curSizeNESW North East/South West arrow
curSizeNWSE North West/South East arrow
curSizeWE West East arrow
curSizeNS North South arrow

<Control Name>: Character string (with or without quotes)

Name of the control or window whose associated cursor must be found.

Finding out the rollover cursor used for a page or for a page control Hide the details

<Cursor Name> = <Control Name>..MouseCursor

<Cursor Name>: Character string or integer constant

Name of the cursor used for the specified control or page. The default value is the curAutomatic constant: the cursor is inherited if a parent element is associated with a specific cursor, otherwise the default cursor defined for the control is used.
Can correspond to:
A specific cursor name (cursor file managed by the browser). The associated CSS value corresponds to url(<Cursor URL>).
A preset cursor CSS value (see table below)
A preset cursor identified by one of the following constants:
curHelp Help for an object
Associated CSS value: help
curAutomatic Automatic cursor: the cursor is inherited if a parent element is associated with a specific cursor, otherwise the default cursor defined for the control is used.
Associated CSS value: auto
curIbeam Input cursor
Associated CSS value: text
curCross Standard cross
Associated CSS value: crosshair
curDefault Default cursor associated with the control
Associated CSS value: default
curArrowForbidden Arrow and sign not allowed
Associated CSS value: no-drop
curArrowWait Arrow and hourglass
Associated CSS value: progress
curForbidden Sign not allowed
Associated CSS value: not-allowed
curHand Hand
Associated CSS value: pointer
curSystemHand System hand
This cursor is the same as the one displayed by the curHand constant.
curWait Hourglass
Associated CSS value: wait
curSize Cross Arrow cursor
Associated CSS value: move
curSizeColumn Cursor for resizing columns
Associated CSS value: col-resize
curSizeRow Cursor for resizing rows
Associated CSS value: row-resize
curSizeNESW North East/South West arrow
Associated CSS values: NE-resize Arrows, SW-resize Arrows
curSizeNWSE North West/South East arrow
Associated CSS values: SE-resize Arrows, NW-resize Arrows
curSizeWE West East arrow
Associated CSS values: E-resize Arrows, W-resize Arrows
curSizeNS North South arrow
Associated CSS values: S-resize Arrows, N-resize Arrows
Note: The CSS all-scroll and vertical-text values have no associated WLanguage constants.
CSS value associated with the cursor or URL address to a cursor managed by the browser. In this case, the value has the following format: 'url(<Cursor URL>)'.

<Control Name>: Character string (with or without quotes)

Name of the control or page whose associated cursor must be found.

Modifying the rollover cursor defined for a window control or for a window Hide the details

<Control Name>..MouseCursor = <Cursor Name>

<Control Name>: Character string (with or without quotes)

Name of the control or window whose cursor must be modified

<Cursor Name>: Character string or integer constant

Name of the cursor to use. Can correspond to:
A specific cursor name (file with a .CUR or .ANI extension):
name of the cursor if the file is found in the current directory,
name and full path of the cursor if the file is found in a directory other than the current directory.
The custom mouse cursors (".CUR" or ".ANI") are not supported in Java.
A preset cursor identified by one of the following constants:
curHelp Help for an object
curIbeam Input cursor
curCross Standard cross
curArrow Standard arrow
curUpArrow Up arrow
curForbidden Sign not allowed
curHand Hand
curSystemHand System handIn Windows NT4, this cursor is the same as the one displayed by the curHand constant.
Cursor identical to curHand.
curWait Hourglass
curSize Cross Arrow cursor
curSizeNESW North East/South West arrow
curSizeNWSE North West/South East arrow
curSizeWE West East arrow

Modifying the rollover cursor defined for a a page control or for a page Hide the details

<Control Name>..MouseCursor = <Cursor Name>

<Control Name>: Character string (with or without quotes)

Name of the control or page whose cursor must be modified

<Cursor Name>: Character string or integer constant

Name of the cursor used for the specified control or window. The default value is the curAutomatic constant: the cursor is inherited if a parent element is associated with a specific cursor, otherwise the default cursor defined for the control is used.
Can correspond to:
The full name of a cursor file (file with a .CUR or .ANI extension). This file must be found in the _WEB directory of the site.
Note: the .cur and .ani files are not supported by Firefox.
The custom cursors are not supported.
A specific cursor name (cursor file managed by the browser). The associated CSS value corresponds to url(uri).
A preset cursor CSS value (see table below)
A preset cursor identified by one of the following constants:
curHelp Help for an object
Associated CSS value: help
curAutomatic Automatic cursor: the cursor is inherited if a parent element is associated with a specific cursor, otherwise the default cursor defined for the control is used.

Associated CSS value: auto
curIbeam Input cursor
Associated CSS value: text
curCross Standard cross
Associated CSS value: crosshair
curDefault Default cursor associated with the control
Associated CSS value: default
curArrowForbidden Arrow and sign not allowed
Associated CSS value: no-drop
curArrowWait Arrow and hourglass
Associated CSS value: progress
curForbidden Sign not allowed
Associated CSS value: not-allowed
curHand Hand
Associated CSS value: pointer
curSystemHand System hand
This cursor is the same as the one displayed by the curHand constant.
curWait Hourglass
Associated CSS value: wait
curSize Cross Arrow cursor
Associated CSS value: move
curSizeColumn Cursor for resizing columns
Associated CSS value: col-resize
curSizeRow Cursor for resizing rows
Associated CSS value: row-resize
curSizeNESW North East/South West arrow
Associated CSS values: NE-resize Arrows, SW-resize Arrows
curSizeNWSE North West/South East arrow
Associated CSS values: SE-resize Arrows, NW-resize Arrows
curSizeWE West East arrow
Associated CSS values: E-resize Arrows, W-resize Arrows
curSizeNS North South arrow
Associated CSS values: S-resize Arrows, N-resize Arrows

Note: The CSS all-scroll and vertical-text values have no associated WLanguage constants.
CSS value associated with the cursor or URL address to a cursor managed by the browser. In this case, the value has the following format: 'url(<Cursor URL>)'.

Remarks

Preset cursors

The preset cursors correspond to the Windows cursors and they can be modified via the control panel (or the desktop themes). The illustrations correspond to the default values and they can change according to the user preferences.

Defining a custom cursor for the browser

To specify a specific cursor in a page or in a page control, all you have to do is indicate a character string with ..MouseCursor. The following operations are automatically performed by WEBDEV when the cursor is displayed in the page:

If the string starts with "url(" , the string that follows is considered as being a direct CSS value and the value is directly written into the style.
If the string starts with "http://" , the CSS value 'url()' is automatically added around the address.
If the string contains a dot (.) and starts with '/' : the specified URL is considered as being relative to the site. The '\' characters are changed into '/' and the CSS value 'url()' is added around the address.
If the string contains a dot (.) and does not start with '/' : the specified URL is considered as being relative to the _WEB directory. The '\' characters are changed into '/', fWebDir is added before the URL and the CSS value 'url()' is added around the address.

Note: To display the cursors with a IIS server, the MIME type must be configured for the .cur and .ani files. The MIME type to use is "application/octet-stream".

Limitation for the List Box control and Combo Box control

..MouseCursor has no effect if the following conditions are fulfilled:

List Box or Combo Box control
Browser used: Internet Explorer (test run on Internet Explorer 7 and earlier)

Limits

..MouseCursor only applies to the:

Window controls.
Windows.
Versions 19 and later
Control templates.
New in version 19
Control templates.
Control templates.

This property cannot be used with:

The menus
The table rows
The table columns

..MouseCursor only applies to the following elements:

Button.
Static control.
Edit control.
Image.
Check box.
Radio button.
List box.
Combo box.
TreeView.
Tab.
Table.
Table column.

..MouseCursor only applies to the:

Page controls,
Pages.