HPlogo MPE/iX Developer's Kit Reference Manual Volume 2: HP 3000 MPE/iX Computer Systems > Chapter 4 CURSES

leaveok

» 

Technical documentation

Complete book in PDF
» Feedback

 » Table of Contents

 » Index

The leaveok routine is used to ignore cursor relocation.

Syntax

   #include <curses.h>



   int leaveok(WINDOW *win, bool bf);

Parameters

win

A pointer to the window in which to ignore the position of the cursor.

bf

A Boolean expression.

Return Values

OK

Successful completion.

ERR

An error occurred.

Description

If bf is TRUE, leaveok() leaves the cursor in a position that CURSES finds convenient at the time that the window is refreshed. Normally, when a window is refreshed, leaveok() is disabled and the cursor is mapped from the logical window to the same location in the physical window.

Enabling leavok() is useful when the cursor is not used or is not important in the application. Reducing cursor movements simplifies program interaction.

Once leaveok() is set to TRUE, it remains enabled until another call sets it to FALSE or until the program terminates.

Implementation Considerations

Identical to XPG/3

See Also

wrefresh()

Portability

HP-UX, UNIX System V, XPG/3

Feedback to webmaster