[Toc][Index]

VioSetCp


Bindings:  C, MASM 

This call allows a process to set the code page used to display text data 
on the screen for the specified handle. 
 VioSetCp    (Reserved, CodePageID, VioHandle) 
 
 Reserved (USHORT) - input 
    Reserved word of 0s. 
 CodePageID (USHORT) - input 
    The CodePageID must be either 0, -1, -2, or have been specified on the 
    CONFIG.SYS CODEPAGE = statement. A value of 0000 indicates that the 
    code page is to be set to the default ROM code page provided by the 
    hardware. A value of -1 enables the user font codepage if user fonts 
    have previously been set with VioSetFont. A value of -2 disables the 
    user font and re-enables the prepared system codepage or ROM codepage 
    that was active before the user font was enabled. 
    If the code page ID is not 0, -1, -2, or does not match one of the 
    ID's on the CODEPAGE = statement, an error results. Refer to IBM 
    Operating System/2 Command Reference for a complete description of 
    CODEPAGE. 
 VioHandle (HVIO) - input 
    This must be zero unless the caller is a Presentation Manager 
    application, in which case it must be the value returned by VioGetPs. 
 rc (USHORT) - return 
    Return code descriptions are: 
    0         NO_ERROR 
    355       ERROR_VIO_MODE 
    436       ERROR_VIO_INVALID_HANDLE 
    465       ERROR_VIO_DETACHED 
    469       ERROR_VIO_BAD_CP 
    470       ERROR_VIO_NO_CP 
    471       ERROR_VIO_NA_CP 
 
 Remarks 
 VioSetCp can be used to enable and disable the user font code page as 
 well as the prepared system code pages.  If a prepared system code page 
 or the ROM code page is specified, any previously set code page is 
 disabled and the specified code page is enabled. 
 Specifying the special code page of -1 enables the user font code page if 
 user fonts have previously been set.  Specifying the special code page of 
 -2 disables the user font code page and re-enables the prepared system 
 code page or ROM code page that was active before the user font code page 
 was enabled. 
 
 PM Considerations 
 Valid CodePageID values are 0 or one that was specified on the CONFIG.SYS 
 
 CODEPAGE = statement; -1 and -2 are not valid for PM. 
 This call can be used to set an EBCDIC code page for Advanced VIO.  For a 
 full-screen or Vio-windowed application, this function causes the 
 displayed characters to be reinterpreted immediately in the new code 
 page.  For a Presentation Manager application, the characters in the base 
 font are reinterpreted in the new code page only when other events cause 
 the characters to be repainted.  This function has no effect on displayed 
 characters that use a font other than the base font. 

Created using Inf-PHP v.2 (c) 2003 Yuri Prokushev
Created using Inf-HTML v.0.9b (c) 1995 Peter Childs