GpiSetCp
This function sets the default graphics code page.
Syntax
GpiSetCp(hps, ulCodePage)
Parameters
- hps (HPS) - input
- Presentation-space handle.
- ulCodePage (ULONG) - input
- Code-page identifier.
Return Code
- rc (BOOL) - returns
- Success indicator.
- TRUE
- Successful completion
- FALSE
- Error occurred.
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_CODEPAGE (0x2052)
- An invalid code-page parameter was specified with GpiSetCp.
Remarks
The default graphics code page is used for the default font (unless it is overridden by GpiCreateLogFont). It is also used for other fonts for which the usCodePage field in the FATTRS structure for GpiCreateLogFont is specified as 0. This includes existing fonts that are defined in this way.
Any code page that is defined in the CONFIG.SYS file, or is a supported EBCDIC code page, can be selected. The following is the list of valid code pages:
Country Code Page Canadian-French 863 Desktop Publishing 1004 Iceland 861 Latin 1 Multilingual 850 Latin 2 Multilingual 852 Nordic 865 Portuguese 860 Turkey 857 U.S. (IBM PC) 437
Code page 1004 is compatible with Microsoft** Windows**.
The following EBCDIC code pages, based on character set 697, are also available for output:
Country Code Page Austrian/German 273 Belgian 500 Brazil 037 Czechoslovakia 870 Danish/Norwegian 277 Finnish/Swedish 278 French 297 Hungary 870 Iceland 871 International 500 Italian 280 Poland 870 Portuguese 037 Spanish 284 Turkey 1026 UK English 285 US English 037 Yugoslavia 870
Code pages 274 (Belgian) and 282 (Portuguese) can be used to provide access to old data.
When a GPI presentation space is first created, it uses code page 850 if available, otherwise it uses the current code page.
If this function occurs within a path definition when the drawing mode (see GpiSetDrawingMode) is retain or draw-and-retain, its effect is not stored with the definition.
Note: There are restrictions on the use of this function when creating SAA-conforming metafiles; see "MetaFile Resolutions" in the Presentation Manager Programming Reference for more information.
Example Code
This example sets the code page to 850.
#define INCL_GPILCIDS #include <os2.h> HPS hps; /* Presentation space handle */ ULONG ulCodePage = 850; GpiSetCp(hps, ulCodePage);
Related Functions
The DOS calls DosGetCp, DosSetCp, and DosSetProcCp are related to GpiSetCp, but they are not a part of the Presentation Manager, for more information on the mentioned DOS calls refer to the Control Program Reference.
- GpiCreateLogFont
- GpiQueryCurrentPosition