Important Notice

The pages on this site contain documentation for very old MS-DOS software, purely for historical purposes. If you're looking for up-to-date documentation, particularly for programming, you should not rely on the information found here, as it will be woefully out of date.

◄Function Group►  ◄Overview►  ◄Changes►               ◄Up► ◄Next► ◄Previous►
────────────────────────────────────────────────────────────────────────────
 
#define INCL_GPIPRIMITIVES
 
LONG GpiQueryCharDirection(hps)
HPS hps;    /* presentation-space handle */
 
The GpiQueryCharDirection function retrieves the current value of the
character-direction attribute. This function cannot be used in an open
segment when the drawing mode is DM_RETAIN.
 
Parameter  Description
────────────────────────────────────────────────────────────────────────────
 
hps        Identifies the presentation space.
 
Return Value
 
The return value is the current character-direction attribute if the
function is successful, or CHDIRN_ERROR if an error occurs.
 
Errors
 
Use the WinGetLastError function to retrieve the error value, which may be
one of the following:
 
     PMERR_INV_HPS
     PMERR_INV_IN_RETAIN_MODE
     PMERR_PS_BUSY
 
Comments
 
In MS OS/2 version 1.2, the following character directions are available:
 
Value             Meaning
────────────────────────────────────────────────────────────────────────────
CHDIRN_LEFTRIGHT  Left to right
 
CHDIRN_RIGHTLEFT  Right to left
 
CHDIRN_TOPBOTTOM  Top to bottom
 
CHDIRN_BOTTOMTOP  Bottom to top
 
See Also
 
GpiSetCharDirection, GpiSetDrawingMode
 
                                      ♦