MouseCursor (Property)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Help / WLanguage / WLanguage properties / Properties associated with windows, pages and controls

Preset cursors
Defining a custom cursor for the browser
Limitation for the List Box control and Combo Box control
Limits

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

MouseCursor (Property)

In french: CurseurSouris

The MouseCursor property is used to identify and change the hover cursor defined for a control, window or page.

Reminder: You can define:

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

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

Identifying the hover cursor used for a window or window control Hide the details

<Cursor name> = <Element used>.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.
".CUR" or ".ANI" custom mouse cursors are not supported in Java.
.ANI custom mouse cursors are not supported in Java.
A preset cursor identified by one of the following constants:
curArrow Standard arrow
curCross Standard cross
curForbidden Sign not allowed
curHand Hand
curHelp Help for an object
curIbeam Input cursor
curSize Cross Arrow cursor
curSizeNESW North East/South West arrow
curSizeNS North South arrow
curSizeNWSE North West/South East arrow
curSizeWE West East arrow
curSystemHand System hand Cursor identical to curHand.
curUpArrow Up arrow
curWait Hourglass

<Element used>: Control name or window name

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

Identifying the hover cursor used for a page or page control Hide the details

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

<Element used>: Name of control or page

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

Changing the hover cursor defined for a window control or window Hide the details

<Element used>.MouseCursor = <Cursor name>

<Element used>: Control name or window name

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.
".CUR" or ".ANI" custom mouse cursors are not supported in Java.
.ANI custom mouse cursors are not supported in Java.
A preset cursor identified by one of the following constants:
curArrow Standard arrow
curCross Standard cross
curForbidden Sign not allowed
curHand Hand
curHelp Help for an object
curIbeam Input cursor
curSize Cross Arrow cursor
curSizeNESW North East/South West arrow
curSizeNWSE North West/South East arrow
curSizeWE West East arrow
curSystemHand System hand
Cursor identical to curHand.
curUpArrow Up arrow
curWait Hourglass

Changing the hover cursor defined for a a page control or page Hide the details

<Element used>.MouseCursor = <Cursor name>

<Element used>: Name of control or page

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

Remark: 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 define a specific cursor in a page or page control, simply specify a string with the MouseCursor property. 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.

Remark: 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

The MouseCursor property has o effect if the following conditions are met:

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

Limits

The MouseCursor property applies only to:

Window controls.
Windows.
Control templates.

This property cannot be used with:

Menus,
Rows in a Table or TreeView Table control,
Columns in a Table or TreeView Table control.
Map controls.

The MouseCursor property applies only to the following elements:

Button control.
Static control.
Edit control.
Image control.
Check Box control.
Radio Button control.
List Box control.
Combo Box control.
TreeView control.
Tab control.
Table control.
Column of Table control.

The MouseCursor property is available from Android 7.

The MouseCursor property applies only to:

Page controls,
Pages.