GpiQueryPickApertureSize
From EDM2
This function returns the value of the pick-aperture size, as set by the GpiSetPickApertureSize function.
Syntax
GpiQueryPickApertureSize(hps, psizlSize)
Parameters
- hps (HPS)
- Presentation-space handle.
- psizlSize (PSIZEL)
- Pick-aperture size.
- Size of the pick aperture, in presentation-page coordinates.
Return Code
- rc (BOOL)
- 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_DC_TYPE (0x2060)
- An invalid type parameter was specified with DevOpenDC, or a function was issued that is invalid for a OD_METAFILE_NOQUERY device context.
Example Code
In this example we query the pick-aperture size, as set by the GpiSetPickApertureSize call.
#define INCL_GPICORRELATION #include <os2.h> BOOL flResult; HPS hps; /* Presentation space handle. */ SIZEL sizel; /* Pick-aperture position. */ LONG xcoord, ycoord; flResult = GpiQueryPickApertureSize(hps, &sizel); xcoord = sizel.cx; ycoord = sizel.cy;