cursor property

Specifies the type of cursor to display as the mouse pointer moves over the object.

 

Syntax

Integer value = object.put_cursor( v);Integer value = object.get_cursor(* sCursor);

Property values

Type: BSTR

one or more of the values listed in Possible Values, separated by commas.

all-scroll (all-scroll)

Internet Explorer 6 and later. Arrows pointing up, down, left, and right with a dot in the middle, indicating that the page can be scrolled in any direction.

auto (auto)

Initial value. Browser determines which cursor to display based on the current context.

col-resize (col-resize)

Internet Explorer 6 and later. Arrows pointing left and right with a vertical bar separating them, indicating that the item/column can be resized horizontally.

crosshair (crosshair)

Simple cross hair.

default (default)

Platform-dependent default cursor; usually an arrow.

hand (hand)

Hand with the first finger pointing up, as when the user moves the pointer over a link.

help (help)

Arrow with question mark, indicating help is available.

move (move)

Crossed arrows, indicating something is to be moved.

no-drop (no-drop)

Internet Explorer 6 and later. Hand with a small circle with a line through it, indicating that the dragged item cannot be dropped at the current cursor location.

not-allowed (not-allowed)

Internet Explorer 6 and later. Circle with a line through it, indicating that the requested action will not be carried out.

pointer (pointer)

Internet Explorer 6 and later. Hand with the first finger pointing up, as when the user moves the pointer over a link. Identical to hand.

progress (progress)

Internet Explorer 6 and later. Arrow with an hourglass next to it, indicating that a process is running in the background. User interaction with the page is unaffected.

row-resize (row-resize)

Internet Explorer 6 and later. Arrows pointing up and down with a horizontal bar separating them, indicating that the item/row can be resized vertically.

text (text)

Editable text; usually an I-bar.

url(uri) (url(uri))

Internet Explorer 6 and later. Cursor is defined by the author, using a custom URI, such as "url('mycursor.cur')". Cursors of type .CUR and .ANI are the only supported cursor types.

vertical-text (vertical-text)

Internet Explorer 6 and later. Editable vertical text, indicated by a horizontal I-bar.

wait (wait)

Hourglass or watch, indicating that the program is busy and the user should wait.

*-resize (*-resize)

Arrows, indicating an edge is to be moved; the asterisk (*) can be N, NE, NW, S, SE, SW, E, or W—each representing a compass direction.

String format

all-scroll | auto | col-resize | crosshair | default | hand | help | move | no-drop | not-allowed | pointer | progress | row-resize | text | url(uri) | vertical-text | wait | *-resize

CSS information

Applies To All elements
Media visual
Inherited true
Initial Value auto

Standards information

Remarks

Windows Internet Explorer 9 and later: When specifying a custom cursor via url(), you must provide at least one "fallback" cursor in addition to the custom cursor, or the custom cursor will not render correctly. For instance, "cursor: url(cursors/cursor2.ani), pointer". See this topic's samples for examples of fallback cursors.

The property handles a comma-separated list of cursor values. If the first cursor is specified incorrectly or can't be found, the next cursor in the comma-separated list will be used, and so on until a usable cursor is found. If none of the listed cursors is valid, the cursor does not change.

Cursors support many shape, color, and movement combinations. This permits you to substitute the default cursors with your preferred design. For instance, you may want your company logo to display as the "progress" cursor; or your country's flag waving in the wind to display as the "wait" cursor.

Cursors have been the subject of security bulletins and updates. If your custom cursors are not behaving as expected, examine the security settings for your browser along with your cursors. This is a common issue with animated cursors. For an example, refer to TechNet Security Resources and search for "Microsoft Security Bulletin MS05-002".

Below are the different possible values for the IHTMLCSSStyleDeclaration::cursor property:

Requirements

Minimum supported client

Windows XP

Minimum supported server

Windows Server 2003

Header

Mshtml.h

IDL

Mshtml.idl

DLL

Mshtml.dll