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 VioWrtNAttr(pbAttr, cb, usRow, usColumn, hvio)
PBYTE pbAttr;       /* pointer to attribute to write */
USHORT cb;          /* number of times to write      */
USHORT usRow;       /* starting position (row)       */
USHORT usColumn;    /* starting position (column)    */
HVIO hvio;          /* video handle                  */
 
The VioWrtNAttr function writes a character attribute to the screen a
specified number of times. If the attribute is repeated more times than can
fit on 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 VioWrtNAttr function is a family API function.
 
Parameter  Description
────────────────────────────────────────────────────────────────────────────
 
pbAttr     Points to the variable that specifies the character attribute to
           write.
 
cb         Specifies the number of times to write the character attribute.
 
usRow      Specifies the row at which to start writing the attribute.
 
usColumn   Specifies the column at which to start writing the attribute.
 
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 VioWrtNAttr to change all the character attributes on the
screen to green letters on a black background (on an EGA color monitor):
 
BYTE bAttr = 0x02;       /* green character, black background  */
VioWrtNAttr(&bAttr,      /* address of attribute               */
    25 * 80,             /* number of times to write attribute */
    0,                   /* row                                */
    0,                   /* column                             */
    0);                  /* video handle                       */
 
See Also
 
VioCreatePS, VioWrtCharStrAtt, VioWrtNCell
 
                                      ♦