SetCursorCouplingMode

Enables or disables input and output cursor coupling for the current screen

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

Syntax

  #include <nwconio.h>  
   
  BYTE SetCursorCouplingMode  (  
     BYTE   newMode); 
  

Parameters

newMode

(IN) Specifies TRUE = Enable cursor coupling. FALSE = Disable cursor coupling.

Return Values

This function returns the value of the old cursor-coupling mode setting.

If an error occurs, the function returns a value of -1, and errno is set to:

Value

Hex

Name

Description

23

(0x17)

ENO_SCRNS

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

Remarks

When cursor coupling is disabled, the input and output cursors for the specified screen occupy separate positions on the screen. The position of the input cursor indicates the starting column/row position on the screen where the blinking cursor is located when a function that takes input from the keyboard is called. The output cursor indicates the starting column/row position on the screen where the output goes when a function that writes to the screen is called. The position of one cursor can be changed without affecting the other cursor’s position.

When cursor coupling is enabled, the input and output cursors for the specified screen always occupy the same position. In effect, there is only one cursor for the screen.

See Also

GetCursorCouplingMode