derwin(3X)                                                       derwin(3X)

NAME
     derwin, newwin, subwin - Funktionen zum Erstellen von Fenstern

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

     #include <curses.h>

     WINDOW *derwin(WINDOW *orig, int nlines, int ncols, int beginy,
             int beginx);

     WINDOW *newwin(int nlines, int ncols, int beginy, int beginx);

     WINDOW *subwin(WINDOW *orig, int nlines, int ncols, int beginy,
             int beginx);

BESCHREIBUNG
     Die Funktion derwin() entspricht der Funktion subwin(), nur beziehen
     sich hier beginy und beginx auf den Ursprung des Originalfensters
     orig und nicht auf absolute Bildschirmpositionen.

     Die Funktion newwin() erstellt ein neues Fenster mit der angegebenen
     Anzahl von Zeilen (nlines) und Spalten (ncols), wobei der Ursprung bei
     (beginy, beginx) liegt. Wenn nlines gleich null ist, wird als Vor-
     einstellung LINES - beginy angenommen; Wenn ncols gleich null ist,
     wird als Voreinstellung COLS - beginx angenommen.

     Die Funktion subwin() erstellt ein neues Fenster mit nlines Zeilen und
     ncols Spalten, wobei der Ursprung bei (beginy, beginx) liegt. (Dies
     ist eine absolute Bildschirmposition, keine Position, die sich auf das
     Fenster orig bezieht.) Liegt ein Teil des neuen Fensters außerhalb von
     orig, schlägt die Funktion fehl und das Fenster wird nicht erstellt.

RÜCKGABEWERT
     Bei erfolgreicher Ausführung geben diese Funktionen einen Zeiger auf
     das neue Fenster zurück. Andernfalls geben sie einen Nullzeiger
     zurück.

FEHLER
     Es sind keine Fehlerzuordnungen definiert.

HINWEISE
     Vor der ersten Aktualisierung eines untergeordneten Fensters sollten
     portierbare Anwendungen für das übergeordnete Fenster die Funktion
     touchwin() oder touchline() aufrufen.

     Jedes Fenster führt interne Beschreibungen zur Bildschirmabbildung und
     zum Status. Die Bildschirmabbildung wird von allen Fenstern in der
     Fensterhierarchie gemeinsam verwendet. Bei Aktualisierungen werden
     Informationen zu Änderungen innerhalb eines Fensters zugrundegelegt,
     die für jedes Fenster spezifisch sind. Wird ein Fenster aktualisiert,
     wenn zuvor Änderungen in einem anderen Fenster vorgenommen wurden,



Seite 1                      Reliant UNIX 5.44               Gedruckt 11/98

derwin(3X)                                                       derwin(3X)

     werden erforderliche Aktualisierungen möglicherweise nicht vorgenom-
     men, da die Fenster diese Änderungsinformationen nicht gemeinsam ver-
     wenden.

     Ein neues Fenster in voller Bildschirmgröße wird durch folgenden Auf-
     ruf erstellt:

          newwin(0, 0, 0, 0);

SIEHE AUCH
     curses(3X), delwin(3X), doupdate(3X), islinetouched(3X), curses(5).











































Seite 2                      Reliant UNIX 5.44               Gedruckt 11/98