scrollok Subroutine

Purpose

Enables or disables scrolling.

Library

Curses Library (libcurses.a)

Syntax

#include <curses.h>
scrollok( Window,  Flag)
WINDOW *Window;
bool Flag;

Description

The scrollok subroutine enables or disables scrolling. Scrolling occurs when a program or user:

  • Moves the cursor off the window's bottom edge.
  • Enters a new-line character on the last line.
  • Types the last character of the last line.

If enabled, curses calls a refresh as part of the scrolling action on both the window and the physical display. To get the physical scrolling effect on the terminal, it is also necessary to call the idlok (idlok Subroutine) subroutine.

If scrolling is disabled, the cursor is left on the bottom line at the location where the character was entered.

Parameters

Item Description
Flag Enables scrolling when set to TRUE. Otherwise, set the Flag parameter to FALSE to disable scrolling.
Window Identifies the window to enable or disable scrolling in.

Examples

  1. To turn scrolling on in the user-defined window my_window, enter: 
    WINDOW *my_window;
scrollok(my_window, TRUE);
  2. To turn scrolling off in the user-defined window my_window, enter: 
    WINDOW *my_window;
scrollok(my_window, FALSE);