Differences
This shows you the differences between two versions of the page.
Next revision | Previous revision | ||
en:docs:fapi:mouremoveptr [2021/10/07 13:46] – created prokushev | en:docs:fapi:mouremoveptr [2021/11/04 13:10] (current) – prokushev | ||
---|---|---|---|
Line 1: | Line 1: | ||
+ | {{page> | ||
+ | |||
+ | ====== MouRemovePtr ====== | ||
+ | |||
This call allows a process to notify the mouse device driver that the area defined by the passed parameters is for the exclusive use of the application. This area is defined as the collision area and is not available to the mouse device driver when drawing pointer images. | This call allows a process to notify the mouse device driver that the area defined by the passed parameters is for the exclusive use of the application. This area is defined as the collision area and is not available to the mouse device driver when drawing pointer images. | ||
- | ==Syntax== | + | ===== Syntax ===== |
+ | <code c> | ||
| | ||
+ | </ | ||
- | ==Parameters== | + | ===== Parameters ===== |
- | ;PtrArea (PNOPTRRECT) - input : Address of the pointer shape collision area structure: | + | |
- | :leftrow (USHORT) : Upper left row coordinate (pels or characters). | + | |
- | :leftcol (USHORT) : Upper left column coordinate (pels or characters). | + | |
- | :rightrow (USHORT) : Lower right row coordinate (pels or characters). | + | |
- | :rightcol (USHORT) : Lower right column coordinate (pels or characters). | + | |
- | ; DeviceHandle (HMOU) - input : Handle of the mouse device from a previous MouOpen. | + | |
- | ==Return Code== | + | * PtrArea (PNOPTRRECT) - input : Address of the pointer shape collision area structure: |
- | ;rc (USHORT) - return: | + | * leftrow (USHORT) : Upper left row coordinate (pels or characters). |
- | *0 NO_ERROR | + | * leftcol (USHORT) : Upper left column coordinate (pels or characters). |
- | *385 ERROR_MOUSE_NO_DEVICE | + | * rightrow (USHORT) : Lower right row coordinate (pels or characters). |
- | *387 ERROR_MOUSE_INV_PARMS | + | * rightcol (USHORT) : Lower right column coordinate (pels or characters). |
- | *466 ERROR_MOU_DETACHED | + | * DeviceHandle (HMOU) - input : Handle of the mouse device from a previous MouOpen. |
- | *501 ERROR_MOUSE_NO_CONSOLE | + | |
- | *505 ERROR_MOU_EXTENDED_SG | + | ===== Return Code ===== |
+ | |||
+ | rc (USHORT) - return: | ||
+ | |||
+ | | ||
+ | *385 ERROR_MOUSE_NO_DEVICE | ||
+ | *387 ERROR_MOUSE_INV_PARMS | ||
+ | *466 ERROR_MOU_DETACHED | ||
+ | *501 ERROR_MOUSE_NO_CONSOLE | ||
+ | *505 ERROR_MOU_EXTENDED_SG | ||
+ | |||
+ | ===== Remarks ===== | ||
- | ==Remarks== | ||
MouRemovePtr may be issued by any process in the session. However, only one collision area is active at a time. Each MouRemovePtr command has the effect of resetting the collision area to the location and area specified by the current command. | MouRemovePtr may be issued by any process in the session. However, only one collision area is active at a time. Each MouRemovePtr command has the effect of resetting the collision area to the location and area specified by the current command. | ||
Line 28: | Line 38: | ||
The MouDrawPtr command effectively cancels the MouRemovePtr command and allows the pointer to be drawn anywhere on the screen, until a new MouRemovePtr command is issued. | The MouDrawPtr command effectively cancels the MouRemovePtr command and allows the pointer to be drawn anywhere on the screen, until a new MouRemovePtr command is issued. | ||
- | ==Bindings== | + | ===== Bindings |
- | ===C=== | + | |
- | <PRE> | + | ====C==== |
+ | <code c> | ||
typedef struct _NOPTRRECT { /* mourt */ | typedef struct _NOPTRRECT { /* mourt */ | ||
USHORT row; /* upper left row coordinates */ | USHORT row; /* upper left row coordinates */ | ||
Line 46: | Line 57: | ||
USHORT | USHORT | ||
- | </PRE> | + | </code> |
- | ===MASM=== | + | ====MASM==== |
- | <PRE> | + | <code asm> |
NOPTRRECT struc | NOPTRRECT struc | ||
| | ||
Line 65: | Line 76: | ||
Returns WORD | Returns WORD | ||
- | </PRE> | + | </code> |
- | [[Category:Mou]] | + | {{page> |