View source for GpiSetPickAperturePosition

This function sets the center of the pick aperture, in presentation page space, for subsequent nonretained correlation operations.

==Syntax==
 GpiSetPickAperturePosition(hps, pptlPick)

==Parameters==
;hps (HPS) - input : Presentation-space handle.
;pptlPick (PPOINTL) - input : Center of the pick aperture.
:The center is in presentation page coordinates.

==Return Code==
;rc (BOOL) - returns : Success indicator.
* TRUE Successful completion
* FALSE Error occurred.

==Errors== 
Possible returns from WinGetLastError
;PMERR_INV_HPS (0x207F) : An invalid presentation-space handle was specified.
;PMERR_PS_BUSY (0x20F4) : An attempt was made to access the presentation space from more than one thread simultaneously.
;PMERR_INV_COORDINATE (0x205B) : An invalid coordinate value was specified.

==Example Code==
In this example we query the position of the center of the pick aperture.
<PRE>
#define INCL_GPICORELATION
#include <OS2.H>

BOOL flResult;
HPS hps;                         /* Presentation space handle. */
POINTL ptlPoint = {50L, 50L};    /* Pick-aperture position. */

flResult = GpiSetPickAperturePosition(hps, &ptlPoint);
</PRE>

==Related Functions==
* [[GpiQueryPickAperturePosition]]
* [[GpiQueryPickApertureSize]]
* [[GpiSetPickApertureSize]]

[[Category:Gpi]]