en:docs:fapi:mouremoveptr

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Next revision
Previous revision
en:docs:fapi:mouremoveptr [2021/10/07 13:46] – created prokusheven:docs:fapi:mouremoveptr [2021/11/04 13:10] (current) prokushev
Line 1: Line 1:
 +{{page>en:templates:fapiint}}
 +
 +====== 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>
  MouRemovePtr (PtrArea, DeviceHandle)  MouRemovePtr (PtrArea, DeviceHandle)
 +</code>
  
-==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:Return code descriptions are: +    * 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:Return code descriptions are: 
 + 
 +  *0 NO_ERROR 
 +  *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           rc;            /* return code */ USHORT           rc;            /* return code */
-</PRE>+</code>
  
-===MASM=== +====MASM==== 
-<PRE>+<code asm>
 NOPTRRECT struc NOPTRRECT struc
  mourt_row  dw  ? ;upper left row coordinates  mourt_row  dw  ? ;upper left row coordinates
Line 65: Line 76:
  
 Returns WORD Returns WORD
-</PRE>+</code> 
  
-[[Category:Mou]]+{{page>en:templates:fapi}}