Simulation support:

None. This function is mandatory for all drivers.

Description:

GreCharString draws a character string starting at the current (X,Y) position. Upon completion, the current (X,Y) position is the start point for the character cell immediately after the last character in the string.

GreCharString must be supported by the presentation driver. The handling routine must provide full support for drawing characters from an image font in CM_MODE1 when the character direction is CHDIRN_LEFTRIGHT (see Character Attributes). For outline characters or characters in any other mode or direction, the handling routine can dispatch the call to the graphics engine at the address given for this call in the default dispatch table.

GreCharString is called by the function GpiCharString. GreCharString is used to draw a character string from the current position within the presentation space. It updates the current presentation space position upon completion of output and produces a call to GreSetCurrentPosition.

#define INCL_GRE_STRINGS
#include <os2.h>

HDC      hdc;        /*  Device context handle. */
LONG     cChars;     /*  Number of characters in the string. */
PCH      pchString;  /*  Pointer to the character string. */
PVOID    pInstance;  /*  Pointer to instance data. */
ULONG    lFunction;
LONG     rc;         /*  Return Codes. */

rc = GreCharString(hdc, cChars, pchString,
       pInstance, lFunction);