====== MAPWINDOWPOINTS method (System) ======


 
==== Description ====
 
 
This method converts (maps) a set of points from a coordinate space relative to a form or control to a coordinate space relative to another form or control.
 
 
 
 
==== Syntax ====
 
<code>
PointsTo = Exec_Method( "SYSTEM", "MAPWINDOWPOINTS", MapFrom, MapTo,
                        PointsFrom )
</code>
 
 
 
==== Parameters ====
 
 
 
^Name^Required^Description^
|MapFrom|No|ID of the object to map from.  The passed PointsFrom are assumed to be in DIPs relative to this object unless:\\ \\ If MapFrom is null then PointsFrom are assumed to be Pixel coordinates relative to the desktop.\\ \\ If MapFrom is numeric then it is assumed to be a window handle (HWND) and PointsFrom are assumed to be Pixel coordinates.|
|MapTo|No|ID of the object to map to.  The returned PointsTo will be in DIPs relative to this object unless:\\ \\ If MapTo is null then the returned PointsTo will be Pixel coordinates relative to the desktop.\\ \\ If MapTo  is numeric then it is assumed to be a window handle (HWND), and the returned PointsTo will be Pixel coordinates.|
|PointsFrom|No|An @fm delimited list of points to map.|

 


 
==== Returns ====
 
 
The mapped set of points in the same format as the PointsFrom parameter.  These may be in DIPs or Pixels depending on the contents of the MapFrom and MapTo parameters
 
 
 
 
==== Remarks ====
 
 
This method is essentially a wrapper around the Windows API MapWindowPoints function – for further information please see the MSDN website.
 
 
 
 
 
 
==== Example ====
 
<code>
 
//// Example - map the RECT coordinates of an editline to another form. //
   
   MapFrom    = "MYWIN.EDL_DATA"
   MapTo      = "ANOTHERWIN"
   
   SourceRect = Get_Property( MapFrom, "RECT" )
   
   DestRect = Exec_Method( "SYSTEM", "MAPWINDOWPOINTS", MapFrom, MapTo, SourceRect )
 
 
 

</code>

 
==== See Also ====
 
 
Common GUI PARENT property, Common GUI RECT property, Common GUI SIZE property.