SetPositionOfInputCursor

Sets the position of the input cursor on the current screen

Local Servers:blocking
Remote Servers:N/A
Classification:3.x, 4.x, 5.x, 6.x
Service:Screen Handling

Syntax

  #include <nwconio.h>  
   
  int SetPositionOfInputCursor  (  
     WORD   row,   
     WORD   column);

Parameters

row

(IN) Specifies the row number on which to position the cursor (top row is 0).

column

(IN) Specifies the column number on which to position the cursor (leftmost column is 0).

Return Values

The following table lists return values and descriptions.

Value

Hex

Name

Description

0

(0x00)

ESUCCESS

Successful.

19

(0x13)

EWRNGKND

Input to System Console was attempted.

23

(0x17)

ENO_SCRNS

Screen I/O was attempted when no screens were open.

Remarks

The application must check that the row and column positions are within the current screen size.

The SetPositionOfInputCursor function positions the input cursor on the current screen. It also positions the output cursor if cursor coupling for the current screen is enabled. If another thread is waiting on the keyboard, the calling thread is blocked until the keyboard is free.

See Also

DisplayInputCursor, HideInputCursor