MOUSEKEYS

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

This structure contains information about the mouse keys accessibility option. When the mouse keys option is active, the user can use the numeric keypad to control the mouse pointer, to click and double-click the mouse buttons, and to drag and drop items. By pressing NUM LOCK, the user can toggle the numeric keypad between mouse control mode and normal operation.

Syntax

typedef struct tagMOUSEKEYS{
  UINT cbSize;
  DWORD dwFlags;
  DWORD iMaxSpeed;
  DWORD iTimeToMaxSpeed;
  DWORD iCtrlSpeed;
  DWORD dwReserved1;
  DWORD dwReserved2;
} MOUSEKEYS, *LPMOUSEKEYS;

Members

  • cbSize
    Unsigned integer that specifies the size, in bytes, of this structure.
  • dwFlags
    DWORD that contains a set of bit flags that specify properties for the mouse keys option. The following table shows the possible values.

    Value Description

    MKF_AVAILABLE

    The mouse keys option is available for use.

    MKF_HOTKEYACTIVE

    The user can turn the mouse keys option on and off by using the hot key, which is Left ALT + Left SHIFT + NUM LOCK.

    MKF_HOTKEYSOUND

    The OS plays a siren sound when the user turns the mouse keys option on or off by using the hot key.

    MKF_MODIFIERS

    The user can press the CTRL key to increase cursor speed by the factor specified by the iCtrlSpeed member. If an application does not specify this value, the OS ignores the input from the CTRL key while the user moves the mouse cursor using the arrow keys.

    MKF_MOUSEKEYSON

    The mouse keys option is on.

    MKF_REPLACENUMBERS

    The user can use the numeric keypad to move the mouse when the NUM LOCK key is on. If an application does not specify this flag, the numeric keypad moves the mouse cursor when the NUM LOCK key is off.

  • iMaxSpeed
    DWORD that specifies the maximum speed that the mouse cursor attains when the user holds down an arrow key. The range of valid values is from 10 to 360.
  • iTimeToMaxSpeed
    DWORD that specifies the length of time, in milliseconds, that elapses before the mouse cursor reaches the maximum speed when the user holds down an arrow key. The range of valid values is from 1000 to 5000.
  • iCtrlSpeed
    DWORD that specifies the multiplier to apply to the speed of the mouse cursor when the user holds down the CTRL key while using the arrow keys to move the cursor. This value is ignored if you do not set dwFlags to MKF_MODIFIERS.
  • dwReserved1
    Reserved for future use. Set to 0.
  • dwReserved2
    Reserved for future use. Set to 0.

Remarks

Use a MOUSEKEYS structure when you call the SystemParametersInfo function with the wAction parameter set to the SPI_GETMOUSEKEYS or SPI_SETMOUSEKEYS value. When using SPI_GETMOUSEKEYS, you must specify the cbSize member of the MOUSEKEYS structure; the SystemParametersInfo function fills in the remaining members. Specify all structure members when using the SPI_SETMOUSEKEYS value.

Requirements

Header winuser.h
Windows Embedded CE Windows CE .NET 4.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also

Reference

SystemParametersInfo

Concepts

Enabling Mouse Keys

Other Resources

Accessibility Structures