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
PointsTo = Exec_Method( "SYSTEM", "MAPWINDOWPOINTS", MapFrom, MapTo,
PointsFrom )
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
//// 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 )
See Also
Common GUI PARENT property, Common GUI RECT property, Common GUI SIZE property.