HP 3000 Manuals

MPE/iX Developer's Kit Reference Manual Volume II

leaveok 

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

MPE/iX 5.0 Documentation