Table of Contents

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

NameRequiredDescription
MapFromNoID 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.
MapToNoID 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.
PointsFromNoAn @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.