MOUSEKEYS

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.

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 and press the SHIFT key to cause the cursor to delay briefly after moving a single pixel, allowing fine positioning of the cursor. If an application does not specify this value, the OS ignores the input from the CTRL and SHIFT keys 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

OS Versions: Windows CE .NET 4.0 and later.
Header: Windows.h.

See Also

SystemParametersInfo | Enabling Mouse Keys | Accessibility Structures

 Last updated on Thursday, April 08, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.