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. 
 * 1) define INCL_GPICORELATION
 * 2) include 

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

flResult = GpiSetPickAperturePosition(hps, &ptlPoint); 

Related Functions

 * GpiQueryPickAperturePosition
 * GpiQueryPickApertureSize
 * GpiSetPickApertureSize