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►                                            ◄Up► ◄Next► ◄Previous►
────────────────────────────────────────────────────────────────────────────
 
#define INCL_VIO
 
USHORT VioWrtCharStr(pchString, cbString, usRow, usColumn, hvio)
PCH pchString;      /* pointer to string to write */
USHORT cbString;    /* length of character string */
USHORT usRow;       /* starting position (row)    */
USHORT usColumn;    /* starting position (column) */
HVIO hvio;          /* video handle               */
 
The VioWrtCharStr function writes a character string to the screen. A
character string contains one or more character values, but no attributes.
The function uses the present screen attributes to display the new
characters. 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 VioWrtCharStr function is a family API function.
 
Parameter  Description
────────────────────────────────────────────────────────────────────────────
 
pchString  Points to the character string to write.
 
cbString   Specifies the length (in bytes) of the character string.
 
usRow      Specifies the row at which to start writing the string.
 
usColumn   Specifies the column at which to start writing the 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
 
Comments
 
Rows and columns are zero-based. Therefore, to specify the first row on the
screen, you would use a value of zero.
 
Example
 
This example calls VioWrtCharStr to display the string "Hello World!" on the
screen at Row 13, Column 31:
 
VioWrtCharStr("Hello World!",    /* string to display */
    12,                          /* length of string  */
    12,                          /* row               */
    30,                          /* column            */
    0);                          /* video handle      */
 
See Also
 
VioCreatePS, VioReadCharStr, VioWrtCharStr, VioWrtTTY
 
                                      ♦