Jump to content

MouGetNumButtons: Difference between revisions

From EDM2
Ak120 (talk | contribs)
mNo edit summary
Ak120 (talk | contribs)
mNo edit summary
 
(One intermediate revision by one other user not shown)
Line 2: Line 2:


==Syntax==
==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==
<PRE>
<PRE>
#define INCL_MOU
#define INCL_MOU
Line 11: Line 30:


rc = MouGetNumButtons(NumberOfButtons, DeviceHandle);
rc = MouGetNumButtons(NumberOfButtons, DeviceHandle);
</PRE>
</PRE>
==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:
Value  Definition
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


[[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);