subcalls.hlp (Topic list)
VioSetCurPos (1.2)
Overview                                            Up Next Previous
────────────────────────────────────────────────────────────────────────────
 
#define INCL_VIO
 
USHORT VioSetCurPos(usRow, usColumn, hvio)
USHORT usRow;       /* row position    */
USHORT usColumn;    /* column position */
HVIO hvio;          /* video handle    */
 
The VioSetCurPos function sets the screen position of the cursor.
 
The VioSetCurPos function is a family API function.
 
Parameter  Description
────────────────────────────────────────────────────────────────────────────
 
usRow      Specifies the row position of the cursor, where zero is the top
           row.
 
usColumn   Specifies the column position of the cursor, where zero is the
           leftmost column.
 
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 VioSetCurPos to place the cursor in the first column of
the last row on the screen, and then displays the text "Hello World!":
 
VioSetCurPos(24,                 /* cursor row    */
    0,                           /* cursor column */
    0);                          /* video handle  */
VioWrtTTY("Hello World!", 12, 0);
 
See Also
 
VioCreatePS, VioGetCurPos, VioSetCurType