gpi12.hlp (Table of Contents; Topic list)
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.
GpiSetCp (1.2)
Function Group  Overview                          Up Next Previous
────────────────────────────────────────────────────────────────────────────
 
#define INCL_GPILCIDS
 
BOOL GpiSetCp(hps, idcp)
HPS hps;        /* presentation-space handle */
USHORT idcp;    /* code-page identifier      */
 
The GpiSetCp function selects the code-page identifier to be used for
graphics characters for the default character set.
 
When a presentation space is first created, the code page used is the one
defined by the process code page, as set by the DosSetProcCp function.
 
Parameter  Description
────────────────────────────────────────────────────────────────────────────
 
hps        Identifies the presentation space.
 
idcp       Specifies the code-page identifier. The WinQueryCpList function
           can be used to find which code pages are available.
 
Return Value
 
The return value is GPI_OK if the function is successful or GPI_ERROR if an
error occurred.
 
Errors
 
Use the WinGetLastError function to retrieve the error value, which may be
one of the following:
 
     PMERR_INV_CODEPAGE
     PMERR_INV_HPS
     PMERR_PS_BUSY
 
See Also
 
GpiQueryCp, WinGetLastError