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.

◄Overview►  ◄Changes►                                 ◄Up► ◄Next► ◄Previous►
────────────────────────────────────────────────────────────────────────────
 
#define INCL_VIO
 
USHORT VioWrtCellStr(pchCellString, cbCellString, usRow, usColumn,
    hvio)
PCH pchCellString;      /* pointer to cell string     */
USHORT cbCellString;    /* length of string           */
USHORT usRow;           /* starting position (row)    */
USHORT usColumn;        /* starting position (column) */
HVIO hvio;              /* video handle               */
 
The VioWrtCellStr function writes a cell string to the screen. A cell string
is one or more character/attribute combinations. A character/attribute
combination defines the character to be written and the character attribute
by which it is displayed.
 
If the string is longer than the current line, the function continues
writing it at the beginning of the next line, but does not write past the
end of the screen.
 
The VioWrtCellStr function is a family API function.
 
Parameter      Description
────────────────────────────────────────────────────────────────────────────
 
pchCellString  Points to the cell string to write.
 
cbCellString   Specifies the length (in bytes) of the cell string. The
               length should be an even number.
 
usRow          Specifies the row at which to start writing the cell string.
 
usColumn       Specifies the column at which to start writing the cell
               string.
 
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 one of the following:
 
     ERROR_VIO_COL
     ERROR_VIO_INVALID_HANDLE
     ERROR_VIO_ROW
 
Example
 
This example calls the VioWrtCellStr function to display the string "Hello
World!" using 12 different attributes.
 
CHAR achCellString[] = "H\1e\2l\3l\4o\5 \6W\7o\10r\11l\13d\14!";
    .
    .
    .
VioWrtCellStr(achCellString,      /* character/attribute string */
    sizeof(achCellString),        /* length of string           */
    10,                           /* row                        */
    35,                           /* column                     */
    0);                           /* video handle               */
 
See Also
 
VioCreatePS, VioReadCellStr, VioWrtCharStr, VioWrtTTY
 
                                      ♦