GpiQueryDrawingMode

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

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);