overlay(3X)                                                     overlay(3X)

NAME
     overlay, overwrite - Überlagerte Fenster kopieren

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

     #include <curses.h>

     int overlay(const WINDOW *srcwin, WINDOW *dstwin);

     int overwrite(const WINDOW *srcwin, WINDOW *dstwin);

BESCHREIBUNG
     Mit den Funktionen overlay() und overwrite() wird das Zielfenster
     dstwin vom Quellfenster srcwin überlagert. Die Argumente scrwin und
     dstwin müssen nicht gleich groß sein. Nur der Text in dem Bereich, wo
     sich die beiden Fenster überlagern, wird kopiert.

     Die Funktion overwrite() kopiert die Zeichen so, als würden die Fun-
     kionen winwch() und waddwch() nacheinander aufgerufen, wobei die
     Attribute des Zielfensters und die Hintergrundattribute gelöscht wer-
     den.

     Die Funktion overlay() geht genauso vor, es sei denn, es handelt sich
     bei dem zu kopierenden Zeichen um ein Hintergrundzeichen des Quellfen-
     sters. In diesem Fall kopiert overlay() das Zeichen nicht, sondern
     verschiebt lediglich den Cursor im Zielfenster um die Breite des Hin-
     tergrundzeichens aus dem Quellfenster.

     Wenn es sich bei irgendeinem Teil des überlagernden Fensterrahmens
     nicht um die erste Spalte eines mehrspaltigen Zeichens handelt, werden
     alle Spaltenpositionen durch das Hintergrundzeichen mit Darstellung
     ersetzt, bevor die Überlagerung erfolgt. Wenn dieser Fall eintritt und
     das vorgegebene Hintergrundzeichen ein mehrspaltiges Zeichen ist,
     schlagen die Funktionen fehl.

RÜCKGABEWERT
     Nach erfolgreicher Ausführung geben diese Funktionen den Wert OK
     zurück. Andernfalls wird ERR zurückgegeben.

FEHLER
     Es sind keine Fehlerzuordnungen definiert.

SIEHE AUCH
     copywin(3X), curses(3X), curses(5).










Seite 1                      Reliant UNIX 5.44               Gedruckt 11/98