Jump to content

MouDrawPtr: Difference between revisions

From EDM2
No edit summary
Ak120 (talk | contribs)
 
(4 intermediate revisions by the same user not shown)
Line 1: Line 1:
==Description==
Notifies the mouse device driver that an area previously restricted by [[MouRemovePtr]] is now available to the mouse device driver when drawing pointer images.
Notifies the mouse device driver that an area previously restricted by MouRemovePtr is now available to the mouse device driver when drawing pointer images.


==Syntax==
==Syntax==
 
  MouDrawPtr(DeviceHandle)
 
  #define INCL_MOU
#include <os2.h>
HMOU      DeviceHandle;  /*  Mouse device handle. */
APIRET    rc;            /*  Return code. */
rc = MouDrawPtr(DeviceHandle);
 


==Parameters==
==Parameters==
;DeviceHandle (HMOU) - input :Mouse device handle.
:Reserved. Must be 0.


; '''DeviceHandle''' (HMOU) - input : Mouse device handle.
;rc (APIRET) - returns:Return code:
Reserved. Must be 0.
::0 NO_ERROR
 
::466 ERROR_MOU_DETACHED
===Return code===
::501 ERROR_MOUSE_NO_CONSOLE
rc (APIRET) - returns
MouDrawPtr returns one of the following values:
 
* 0   NO_ERROR  
* 466 ERROR_MOU_DETACHED  
* 501 ERROR_MOUSE_NO_CONSOLE


==Remarks==
==Remarks==
MouDrawPtr is required to begin a pointer-image drawing session. At session start, the collision area (the area restricted from pointer-image drawing) is defined as the size of the display.
MouDrawPtr is required to begin a pointer-image drawing session. At session start, the collision area (the area restricted from pointer-image drawing) is defined as the size of the display.


After a call to MouDrawPtr, MouRemovePtr can be used to define a new collision area. A subsequent call to MouDrawPtr will cancel the collision area.  
After a call to MouDrawPtr, MouRemovePtr can be used to define a new collision area. A subsequent call to MouDrawPtr will cancel the collision area.
 
==Example Code==
<PRE>
 
</PRE>


==Related Functions==
==Related Functions==
* [[OS2 API:CPI:
* [[MouRemovePtr]]


[[Category:The OS/2 API Project]]
[[Category:Mou]]

Latest revision as of 23:47, 11 December 2019

Notifies the mouse device driver that an area previously restricted by MouRemovePtr is now available to the mouse device driver when drawing pointer images.

Syntax

MouDrawPtr(DeviceHandle)

Parameters

DeviceHandle (HMOU) - input
Mouse device handle.
Reserved. Must be 0.
rc (APIRET) - returns
Return code:
0 NO_ERROR
466 ERROR_MOU_DETACHED
501 ERROR_MOUSE_NO_CONSOLE

Remarks

MouDrawPtr is required to begin a pointer-image drawing session. At session start, the collision area (the area restricted from pointer-image drawing) is defined as the size of the display.

After a call to MouDrawPtr, MouRemovePtr can be used to define a new collision area. A subsequent call to MouDrawPtr will cancel the collision area.

Related Functions