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.

 ◄Summary► ◄Example►                         ◄Up► ◄Contents► ◄Index► ◄Back►
─────Run-Time Library───────────────────────────────────────────────────────
 
     The _settextcursor function sets the text cursor attribute
     (i.e., the shape) to the value specified by the <attr> argument.
     The high-order byte of <attr> determines the start line of the
     cursor within the character cell. The low-order byte of <attr>
     determines the stop line of the cursor. The lines are filled
     from the start line down to the stop line.
 
     The _settextcursor function assumes a cursor made up of eight
     scan lines. Line 0 is the top line; line 7 is the bottom. The
     actual text cursor may be made up of more lines (for example,
     0-14 on a monochrome adapter). However, _settextcursor maps the
     number given in the virtual 0-7 cursor grid onto the nearest
     actual cursor line.
 
     Sample values for the cursor attribute are shown below:
 
     Cursor     Shape
 
     0x0707     Underline
     0x0007     Full block cursor
     0x0607     Double underline
     0x2000     No cursor
 
     Note that this function works only in text video modes.
 
     Return Value
 
     The function returns the previous cursor attribute, or -1 if an
     error occurs (such as calling the function in graphics screen
     mode).
                                    -♦-