GpiQueryDrawingMode: Difference between revisions
Created page with "This function returns the current drawing mode, as set by GpiSetDrawingMode. ==Syntax== GpiQueryDrawingMode(hps) ==Parameters== ; hps (HPS) - input : Presentation-space handle. ==Return Value== ; lMode (LONG) - returns : Drawing mode. : (See GpiSetDrawingMode for details): :; >0 :: Drawing mode :; DM_ERROR :: Error. ==Remarks== This function retrieves the current drawing mode of the presentation space. ==Errors== Possible returns from WinGetLastErro..." |
(No difference)
|
Latest revision as of 21:56, 6 April 2025
This function returns the current drawing mode, as set by GpiSetDrawingMode.
Syntax
GpiQueryDrawingMode(hps)
Parameters
- hps (HPS) - input
- Presentation-space handle.
Return Value
- lMode (LONG) - returns
- Drawing mode.
- (See GpiSetDrawingMode for details):
- >0
- Drawing mode
- DM_ERROR
- Error.
Remarks
This function retrieves the current drawing mode of the presentation space.
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_MICROPS_FUNCTION (0x20A1)
- An attempt was made to issue a function that is invalid in a micro presentation space.
Example Code
#define INCL_GPICONTROL /* Or use INCL_GPI, INCL_PM, */ #include <os2.h> HPS hps; /* Presentation-space handle. */ LONG lMode; /* Drawing mode. */ lMode = GpiQueryDrawingMode(hps);
This example uses GpiQueryDrawingMode to return the current drawing mode, as set by GpiSetDrawingMode.
#define INCL_GPICONTROL /* Control functions */ #include <os2.h> LONG lMode; /* drawing mode */ HPS hps; /* Presentation-space handle */ lMode = GpiQueryDrawingMode(hps);