Edit

Share via

Cursor (MSAA UI Element Reference)

  • Article

Note

This topic describes cursors for purposes of MSAA UI Element Reference. How to use cursors in various UI frameworks is not described here. See the API reference documentation for the UI framework you're using.

 

A cursor is a small picture whose location on the screen is controlled by a pointing device, such as a mouse, pen, or trackball. When the user moves the pointing device, the Windows operating system moves the cursor.

IAccessible Methods

A cursor supports the following IAccessible methods:

IAccessible Properties

A cursor supports the following IAccessible properties:

  • get_accChildCount—The ChildCount property is zero.

  • get_accName—Developers can create custom cursors or use the predefined cursors that are identified by their cursor ID. The Name property of the cursor depends on its shape and is one of the following:

    Cursor shape Name
    Custom cursor "Unknown"
    IDC_ARROW "Normal"
    IDC_IBEAM "Edit"
    IDC_WAIT "Wait"
    IDC_CROSS "Graphic"
    IDC_UPARROW "Up"
    IDC_SIZENWSE "NWSE size"
    IDC_SIZENESW "NESW size"
    IDC_SIZEWE "Horizontal size"
    IDC_SIZENS "Vertical size"
    IDC_SIZEALL "Move"
    IDC_NO "Forbidden"
    IDC_APPSTARTING "App start"
    IDC_HELP "Help"

     

  • get_accRole—The Role property is ROLE_SYSTEM_CURSOR.

  • get_accState—The State property is a combination of one or more of the following values:

    STATE_SYSTEM_INVISIBLE | STATE_SYSTEM_FLOATING

Notes

  • Unlike other UI elements, the cursor object does not have an associated window handle. To obtain access to the cursor object, clients must set a WinEventProc and wait for the cursor object to generate events.

IAccessible Interface