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►                          ◄Up► ◄Next► ◄Previous►
────────────────────────────────────────────────────────────────────────────
 
#define INCL_VIO
 
USHORT VioSetFont(pviofi, hvio)
PVIOFONTINFO pviofi;    /* pointer to structure for display font */
HVIO hvio;              /* video handle                          */
 
The VioSetFont function sets the font used to display characters on the
screen. A font consists of several bitmaps, one for each character in a
character set. The bitmaps define the character shapes. The font must be
compatible with the current screen mode; that is, the bitmap size must match
the current character-cell size.
 
The VioSetFont function resets the current code page. A subsequent call to
the VioGetCp function returns an error value.
 
Not all display adapters permit the font to be set.
 
The VioSetFont function is a family API function.
 
Parameter  Description
────────────────────────────────────────────────────────────────────────────
 
pviofi     Points to the VIOFONTINFO structure that specifies the display
           font.
 
hvio       Identifies an advanced video-input-and-output (AVIO) presentation
           space. For AVIO programs, this handle must have been created
           previously using the VioCreatePS function. For other programs,
           hvio must be NULL.
 
Return Value
 
The return value is zero if the function is successful. Otherwise, it is an
error value, which may be the following:
 
     ERROR_VIO_INVALID_LENGTH
 
See Also
 
VioCreatePS, VioGetCp, VioGetFont, VIOFONTINFO
 
                                      ♦