ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

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
  • Limitations
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadIOS WidgetApple WatchMac CatalystUniversal Windows 10 App
Others
Stored procedures
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
WEBDEV - Server codeWEBDEV - Browser code
// 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
WEBDEV - Server codeWEBDEV - Browser code

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:
    curArrowForbiddenArrow and sign not allowed
    Associated CSS value: no-drop
    curArrowWaitArrow and hourglass
    Associated CSS value: progress
    curAutomaticAutomatic cursor: the cursor is inherited if a parent element is associated with a specific cursor, otherwise the control's default cursor is used.
    Associated CSS value: auto
    curCrossStandard cross
    Associated CSS value: crosshair
    curDefaultDefault cursor associated with the control
    Associated CSS value: default
    curForbiddenSign not allowed
    Associated CSS value: not-allowed
    curHandHand
    Associated CSS value: pointer
    curHelpHelp on an object
    Associated CSS value: help
    curIbeamInput cursor
    Associated CSS value: text
    curSizeCross arrow cursor
    Associated CSS value: move
    curSizeColumnCursor for resizing columns
    Associated CSS value: col-resize
    curSizeNESWNorth East/South West arrow
    Associated CSS values: NE-resize Arrows, SW-resize Arrows
    curSizeNSNorth/South arrow
    Associated CSS values: S-resize Arrows, N-resize Arrows
    curSizeNWSENorth West/South East arrow
    Associated CSS values: SE-resize Arrows, NW-resize Arrows
    curSizeRowCursor for resizing rows
    Associated CSS value: row-resize
    curSizeWEEast/West arrow
    Associated CSS values: E-resize Arrows, W-resize Arrows
    curSystemHandSystem hand
    This cursor is the same as the one displayed by the curHand constant.
    curWaitHourglass
    Associated CSS value: wait
Remark: The CSS all-scroll and vertical-text values have no associated WLanguage constants.
WEBDEV - Browser code 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.
Windows

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.

  • A preset cursor identified by one of the following constants:
    curArrowStandard arrow
    curCrossStandard cross
    curForbiddenSign not allowed
    curHandHand
    curHelpHelp on an object
    curIbeamInput cursor
    curSizeCross arrow cursor
    curSizeNESWNorth East/South West arrow
    curSizeNSNorth/South arrow
    curSizeNWSENorth West/South East arrow
    curSizeWEEast/West arrow
    curSystemHandSystem hand
    curUpArrowUp arrow
    curWaitHourglass
WEBDEV - Server codeWEBDEV - Browser code

Changing the hover cursor defined for 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.
    WEBDEV - Browser code 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:
    curArrowForbiddenArrow and sign not allowed
    Associated CSS value: no-drop
    curArrowWaitArrow and hourglass
    Associated CSS value: progress
    curAutomaticAutomatic cursor: the cursor is inherited if a parent element is associated with a specific cursor, otherwise the control's default cursor is used.
    Associated CSS value: auto
    curCrossStandard cross
    Associated CSS value: crosshair
    curDefaultDefault cursor associated with the control
    Associated CSS value: default
    curForbiddenSign not allowed
    Associated CSS value: not-allowed
    curHandHand
    Associated CSS value: pointer
    curHelpHelp on an object
    Associated CSS value: help
    curIbeamInput cursor
    Associated CSS value: text
    curSizeCross arrow cursor
    Associated CSS value: move
    curSizeColumnCursor for resizing columns
    Associated CSS value: col-resize
    curSizeNESWNorth East/South West arrow
    Associated CSS values: NE-resize Arrows, SW-resize Arrows
    curSizeNSNorth/South arrow
    Associated CSS values: S-resize Arrows, N-resize Arrows
    curSizeNWSENorth West/South East arrow
    Associated CSS values: SE-resize Arrows, NW-resize Arrows
    curSizeRowCursor for resizing rows
    Associated CSS value: row-resize
    curSizeWEEast/West arrow
    Associated CSS values: E-resize Arrows, W-resize Arrows
    curSystemHandSystem hand
    This cursor is the same as the one displayed by the curHand constant.
    curWaitHourglass
    Associated CSS value: wait

Remark: The CSS all-scroll and vertical-text values have no associated WLanguage constants.
WEBDEV - Browser code 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
Windows

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.
WEBDEV - Server codeWEBDEV - Browser code

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".
WEBDEV - Server codeWEBDEV - Browser code

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)
WEBDEV - Server codeWEBDEV - Browser code

Limitations

WEBDEV - Server codeWEBDEV - Browser code The MouseCursor property applies only to:
  • Page controls,
  • Pages.
Minimum version required
  • Version 9
This page is also available for…
Comments
Click [Add] to post a comment

Last update: 02/29/2024

Send a report | Local help