ripoffline(3X)                                               ripoffline(3X)

NAME
     ripoffline - Ein Zeile für einen bestimmten Zweck reservieren

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

     #include <curses.h>

     int ripoffline(int line, int (*init)(WINDOW *win, int columns));

BESCHREIBUNG
     Die Funktion ripoffline() reserviert eine Bildschirmzeile für eine
     Anwendung.

     Jeder Aufruf von ripoffline() muß dem Aufruf von initscr() oder
     newterm() vorausgehen. Ist line eine positive Zahl, wird oben aus dem
     Bildschirm stdscr eine Zeile entfernt. Ist line eine negative Zahl,
     wird unten eine Zeile entfernt. Das Entfernen der Zeile erfolgt wäh-
     rend des nachfolgenden Aufrufs von initscr() oder newterm(). Hierbei
     wird die Funktion, auf die init zeigt, mit zwei Argumenten aufgerufen:
     Mit einem Fensterzeiger (WINDOW) auf das einzeilige Fenster, das
     zugeordnet wurde, und mit einer Ganzzahl, die die Anzahl der Spalten
     im Fenster wiedergibt. Die Initialisierungsfunktion kann weder die
     externen Variablen LINES und COLS verwenden, noch wrefresh() bzw.
     doupdate() aufrufen. Es ist jedoch möglich, die Funktion
     wnoutrefresh() aufzurufen.

     Bis zu fünf Zeilen können abgeschnitten werden. Aufrufe von
     ripoffline(), die über dieses Maximum hinausgehen, haben zwar keine
     Auswirkungen, kehren jedoch erfolgreich zurück.

RÜCKGABEWERT
     Die Funktion ripoffline() gibt den Wert OK zurück.

FEHLER
     Es sind keine Fehlerzuordnungen definiert.

HINWEISE
     Durch den Aufruf von slkinit() wird die Größe des Bildschirms um eine
     Zeile verringert, wenn initscr() im späteren Verlauf eine Zeile des
     Bildschirms stdscr zum Emulieren von SLKs (Soft-Labeled Keys - nicht
     festverdrahtete Funktionstasten) verwendet. Wenn durch slkinit() eine
     Bildschirmzeile entfernt wird, wird auch die Anzahl der Zeilen um Eins
     reduziert, die von einer Anwendung durch nachfolgende Aufrufe von
     ripoffline() reserviert werden können. Dementsprechend dürfen portier-
     bare Anwendungen, die SLK-Funktionen verwenden, die Funktion
     ripoffline() noch maximal viermal verwenden.

     Wenn initscr() oder newterm() die Initialisierungsfunktion aufruft,
     auf die init zeigt, kann die Implementierung für das Argument win des
     Fensterzeigers WINDOW den Wert NULL weitergeben. Hiermit wird angege-
     ben, daß ein einzeiliges Fenster für die Zeile, die durch den Aufruf



Seite 1                      Reliant UNIX 5.44               Gedruckt 11/98

ripoffline(3X)                                               ripoffline(3X)

     von ripoffline() entfernt wurde, nicht zugeordnet werden kann. Por-
     tierbare Anwendungen sollten sicherstellen, daß das Argument win nicht
     NULL ist, bevor Operationen für das entsprechende Fenster durchgeführt
     werden.

SIEHE AUCH
     curses(3X), doupdate(3X), initscr(3X), slkattroff(3X), stdscr(3X),
     curses(5).














































Seite 2                      Reliant UNIX 5.44               Gedruckt 11/98