MouGetNumButtons: Difference between revisions
mNo edit summary |
mNo edit summary |
||
| Line 2: | Line 2: | ||
==Syntax== | ==Syntax== | ||
MouGetNumButtons(NumberOfButtons, DeviceHandle) | MouGetNumButtons(NumberOfButtons, DeviceHandle) | ||
==Parameters== | ==Parameters== | ||
; | ;NumberOfButtons (PULONG) - output : Number of mouse buttons. | ||
:Address where the number of physical buttons is to be returned. | :Address where the number of physical buttons is to be returned. | ||
:The return values for the number of buttons supported are: | :The return values for the number of buttons supported are: | ||
::1 - One mouse button. | |||
::2 - Two mouse buttons. | |||
::3 - Three mouse buttons. | |||
;DeviceHandle (HMOU) - input : Mouse device handle. | |||
; DeviceHandle (HMOU) - input : Mouse device handle. | :Reserved. Set to 0. | ||
Reserved. Set to 0. | |||
==Return Code== | ==Return Code== | ||
;rc (APIRET) - returns:MouGetNumButtons returns one of the following values: | |||
* 0 NO_ERROR | |||
MouGetNumButtons returns one of the following values: | *466 ERROR_MOU_DETACHED | ||
* 0 | *501 ERROR_MOUSE_NO_CONSOLE | ||
* 466 | |||
* 501 | |||
==Sample== | ==Sample== | ||
| Line 32: | Line 30: | ||
rc = MouGetNumButtons(NumberOfButtons, DeviceHandle); | rc = MouGetNumButtons(NumberOfButtons, DeviceHandle); | ||
</PRE> | </PRE> | ||
[[Category:Mou]] | [[Category:Mou]] | ||
Latest revision as of 22:33, 7 December 2022
Returns the number of buttons supported on the installed mouse device driver.
Syntax
MouGetNumButtons(NumberOfButtons, DeviceHandle)
Parameters
- NumberOfButtons (PULONG) - output
- Number of mouse buttons.
- Address where the number of physical buttons is to be returned.
- The return values for the number of buttons supported are:
- 1 - One mouse button.
- 2 - Two mouse buttons.
- 3 - Three mouse buttons.
- DeviceHandle (HMOU) - input
- Mouse device handle.
- Reserved. Set to 0.
Return Code
- rc (APIRET) - returns
- MouGetNumButtons returns one of the following values:
- 0 NO_ERROR
- 466 ERROR_MOU_DETACHED
- 501 ERROR_MOUSE_NO_CONSOLE
Sample
#define INCL_MOU #include <os2.h> PULONG NumberOfButtons; /* Number of mouse buttons. */ HMOU DeviceHandle; /* Mouse device handle. */ APIRET rc; /* Return code. */ rc = MouGetNumButtons(NumberOfButtons, DeviceHandle);