clearok(3X)                                                     clearok(3X)

NAME
     clearok, idlok, leaveok, scrollok, setscrreg, wsetscrreg - Funktionen
     zur Steuerung des Ausgabemodus

SYNTAX
     cc [flag ...] file ... -lcurses [library ...]

     #include <curses.h>

     int clearok(WINDOW *win, bool bf);

     int idlok(WINDOW *win, bool bf);

     int leaveok(WINDOW *win, bool bf);

     int scrollok(WINDOW *win, bool bf);

     int setscrreg(int top, int bot);

     int wsetscrreg(WINDOW *win, int top, int bot);

BESCHREIBUNG
     Diese Funktionen setzen Optionen, die die Ausgabe innerhalb von Curses
     steuern.

     Die Funktion clearok() ordnet den Wert von bf einem internen Flag im
     angegebenen Fenster zu, das das Löschen des Bildschirminhalts während
     des Aktualisierens steuert. Wenn eine Aktualisierung im angegebenen
     Fenster durchgeführt wird, und das Flag in curscr oder das Flag im
     angegebenen Fenster auf TRUE gesetzt ist, löscht die Implementierung
     den Bildschirminhalt, baut den Bildschirm ganz neu auf und setzt das
     Flag in curscr und im angegebenen Fenster auf FALSE. Der Anfangsstatus
     ist nicht definiert.

     Die Funktion idlok() gibt an, ob die Implementierung bei entsprechend
     ausgestatteten Terminals die Hardwarefunktionen zum Einfügen/Löschen
     von Zeilen und zum Blättern (Scrolling) verwenden kann. Wenn bf auf
     TRUE gesetzt ist, sind diese Hardwarefunktionen aktiviert. Wenn bf auf
     FALSE gesetzt ist, sind diese Hardwarefunktionen nicht aktiviert und
     statt dessen werden die Zeilen nach Bedarf neu aufgebaut. Der Anfangs-
     status ist FALSE.

     Die Funktion leaveok() steuert die Cursor-Position nach einer Aktuali-
     sierung. Wenn bf auf TRUE gesetzt ist, bleibt der Terminal-Cursor nach
     einer Aktualisierung an einer beliebigen Position im angegebenen Fen-
     ster stehen. Wenn bf auf FALSE gesetzt ist, wird der Terminal-Cursor
     nach einer Aktualisierung auf die Cursor-Position im angegebenen Fen-
     ster gestellt. Der Anfangsstatus ist FALSE.







Seite 1                      Reliant UNIX 5.44               Gedruckt 11/98

clearok(3X)                                                     clearok(3X)

     Die Funktion scrollok() steuert die Verwendung des Blätterns. Wenn bf
     auf TRUE gesetzt ist, ist die Blätterfunktion im angegebenen Fenster
     aktiviert und zwar mit allen in "X/Open Curses, Issue 4, Version 2,
     Abschnitt 3.4.2" beschriebenen Konsequenzen. Wenn bf auf FALSE gesetzt
     ist, ist die Blätterfunktion für das angegebene Fenster deaktiviert.
     Der Anfangsstatus ist FALSE.

     Die Funktionen setscrreg() und wsetscrreg() definieren einen software-
     spezifischen Scroll-Bereich im aktuellen oder angegebenen Fenster. Die
     Argumente top und bot sind die Zeilennummern für die erste und letzte
     Zeile, durch die der Scroll-Bereich definiert wird. (Zeile 0 ist die
     oberste Zeile des Fensters.) Ist diese Option zusammen mit scrollok()
     aktiviert, werden alle Zeilen im Scroll-Bereich um eine Zeile in Rich-
     tung der ersten Zeile verschoben, wenn versucht wird, über die letzte
     Zeile des Rands weiterzublättern. Nur die Zeichen im Fenster werden
     geblättert. Wenn ein softwarespezifischer Scroll-Bereich gesetzt und
     scrollok() nicht aktiviert ist, werden bei dem Versuch, über die
     letzte Zeile des Rands weiterzublättern, keine Zeilen im Scroll-
     Bereich verschoben.

RÜCKGABEWERT
     Die Funktionen setscrreg() und wsetscrreg() geben bei erfolgreicher
     Ausführung den Wert OK zurück. Andernfalls wird der Wert ERR zurückge-
     geben.

     Die anderen Funktionen geben immer den Wert OK zurück.

FEHLER
     Es sind keine Fehlerzuordnungen definiert.

HINWEISE
     Der einzige Grund zur Aktivierung der Funktion idlok() liegt darin,
     durch das Blättern den visuellen Effekt der Bewegung eines Teilfen-
     sters zu erreichen, wie zum Beispiel für einen bildschirmorientierten
     Editor. In anderen Fällen kann diese Funktion äußerst lästig für das
     Auge sein.

     Die Option leaveok() wirkt sich bei Anwendungen, die den Cursor nicht
     verwenden, positiv auf die Leistung aus.

SIEHE AUCH
     clear(3X), curscr(3X), curses(3X), delscreen(3X), doupdate(3X),
     scrl(3X), curses(5).











Seite 2                      Reliant UNIX 5.44               Gedruckt 11/98