MouSetScaleFact: Difference between revisions
Created page with "==Description== Assigns a new set of scaling factors to the current mouse device driver. ==Syntax== <PRE> #define INCL_MOU #include <os2.h> PSCALEFACT ScaleStruct; /* ..." |
mNo edit summary |
||
| (2 intermediate revisions by 2 users not shown) | |||
| Line 1: | Line 1: | ||
Assigns a new set of scaling factors to the current mouse device driver. | Assigns a new set of scaling factors to the current mouse device driver. | ||
| Line 12: | Line 11: | ||
rc = MouSetScaleFact(ScaleStruct, DeviceHandle); | rc = MouSetScaleFact(ScaleStruct, DeviceHandle); | ||
</PRE> | |||
==Parameters== | ==Parameters== | ||
; | ;ScaleStruct (P[[SCALEFACT]]) - input: Address of scaling factors. | ||
:The address of the control block structure that contains the current row-and-column coordinate scaling factors. The scaling factors must be greater than or equal to 1 and less than or equal to (32K-1). | |||
;DeviceHandle (HMOU) - input : Reserved. Must be 0. | |||
==Return Code== | ==Return Code== | ||
;rc (APIRET) - returns:MouSetScaleFact returns one of the following values: | |||
* 0 NO_ERROR | |||
MouSetScaleFact returns one of the following values: | * 387 ERROR_MOUSE_INV_PARMS | ||
* 466 ERROR_MOU_DETACHED | |||
* 0 | * 501 ERROR_MOUSE_NO_CONSOLE | ||
* 387 | |||
* 466 | |||
* 501 | |||
==Remarks== | ==Remarks== | ||
MouSetScaleFact sets the mickey-to-pixel ratio for mouse motion. The row scale and column scale ratios specify a number of mickeys for each 8 pixels. The default value for the row scale is 16 mickeys for each 8 pixels. The default value for the column scale is 8 mickeys to 8 pixels. | MouSetScaleFact sets the mickey-to-pixel ratio for mouse motion. The row scale and column scale ratios specify a number of mickeys for each 8 pixels. The default value for the row scale is 16 mickeys for each 8 pixels. The default value for the column scale is 8 mickeys to 8 pixels. | ||
The number of pixels moved does not have to be one-to-one for the number of mickeys the mouse moves. The scaling factor defines a sensitivity for the mouse that is a ratio of the number of mickeys required to move the cursor 8 pixels on the screen. The sensitivity determines at what rate the cursor moves on the screen. | The number of pixels moved does not have to be one-to-one for the number of mickeys the mouse moves. The scaling factor defines a sensitivity for the mouse that is a ratio of the number of mickeys required to move the cursor 8 pixels on the screen. The sensitivity determines at what rate the cursor moves on the screen. | ||
[[Category: | [[Category:Mou]] | ||
Latest revision as of 18:00, 14 September 2019
Assigns a new set of scaling factors to the current mouse device driver.
Syntax
#define INCL_MOU #include <os2.h> PSCALEFACT ScaleStruct; /* Address of scaling factors. */ HMOU DeviceHandle; /* Reserved. Must be 0. */ APIRET rc; /* Return code */ rc = MouSetScaleFact(ScaleStruct, DeviceHandle);
Parameters
- ScaleStruct (PSCALEFACT) - input
- Address of scaling factors.
- The address of the control block structure that contains the current row-and-column coordinate scaling factors. The scaling factors must be greater than or equal to 1 and less than or equal to (32K-1).
- DeviceHandle (HMOU) - input
- Reserved. Must be 0.
Return Code
- rc (APIRET) - returns
- MouSetScaleFact returns one of the following values:
- 0 NO_ERROR
- 387 ERROR_MOUSE_INV_PARMS
- 466 ERROR_MOU_DETACHED
- 501 ERROR_MOUSE_NO_CONSOLE
Remarks
MouSetScaleFact sets the mickey-to-pixel ratio for mouse motion. The row scale and column scale ratios specify a number of mickeys for each 8 pixels. The default value for the row scale is 16 mickeys for each 8 pixels. The default value for the column scale is 8 mickeys to 8 pixels.
The number of pixels moved does not have to be one-to-one for the number of mickeys the mouse moves. The scaling factor defines a sensitivity for the mouse that is a ratio of the number of mickeys required to move the cursor 8 pixels on the screen. The sensitivity determines at what rate the cursor moves on the screen.