====== POSBYCURSOR method (PropertyGrid) ======


 
==== Description ====
 
 
Returns the closest visible property item to the passed screen coordinates.
 
 
 
 
==== Syntax ====
 
<code>
itemPos = Exec_Method( ctrlEntID,     
                       "POSBYCURSOR", 
                       xPos,          
                       yPos )
 
</code> 
 
 
==== Parameters ====
 
 
 
 
 
 
 
^Name^Required^Description^
|xPos|No|X-position of the cursor in screen coordinates|
|yPos|No|Y-position of the cursor in screen coordinates|

 


 
==== Returns ====
 
 
The position of the closest property item in the "visible" list, or null if the coordinates are not above an item.
 
 
 
 
==== Remarks ====
 
 
If xPos and yPos are omitted the current cursor position is used instead.
 
 
 
 
==== Example ====
 
<code>
 
$Insert PS_Property_Grid_Equates

   $Insert Logical

   

   CtrlEntID = @Window : ".PRG_MAIN"

   

   XYPos   = Get_Property( "SYSTEM", "CURSORPOS" )

   ItemPos = Exec_Method( CtrlEntID, "POSBYCURSOR", XYPos<1>, XYPos<2> )

   

   If ItemPos Then

      * // Get the item details from the position

      Item = Get_Property( CtrlEntID, "LIST", ItemPos )

   End
 
 
 

</code>

 
==== See Also ====
 
 
N/A