newpad(3X) newpad(3X)
NAME
newpad, pnoutrefresh, prefresh, subpad - Funktionen zur Verwaltung
kleiner Fenster (Pads)
SYNTAX
cc [flag ...] file ... -lcurses [library ...]
#include <curses.h>
WINDOW *newpad(int nlines, int ncols);
int pnoutrefresh(WINDOW *pad, int pminrow, int pmincol, int sminrow,
int smincol, int smaxrow, int smaxcol);
int prefresh(WINDOW *pad, int pminrow, int pmincol, int sminrow,
int smincol, int smaxrow, int smaxcol);
WINDOW *subpad(WINDOW *orig, int nlines, int ncols, int beginy,
int beginx);
BESCHREIBUNG
Die Funktion newpad() erstellt eine Sonderdatenstruktur WINDOW, die
ein kleines Fenster (Pad) mit nlines Zeilen und ncols Spalten dar-
stellt. Ein Pad gleicht einem Fenster, muß allerdings nicht unbedingt
einem darstellbaren Teil des Bildschirms zugeordnet sein. Kleine Fen-
ster werden nicht automatisch aktualisiert.
Die Funktion subpad() erstellt ein untergeordnetes Fenster innerhalb
eines kleinen Fensters mit nlines Zeilen und ncols Spalten. Anders als
bei der Funktion subwin(), die Bildschirmkoordinaten verwendet, befin-
det sich hier das Fenster an der Position (beginy, beginx) im klei-
nen Fenster. Das Fenster wird in der Mitte des Originalfensters orig
erstellt, so daß Änderungen in einem Fenster auch das jeweils andere
Fenster betreffen.
Die Funktionen prefresh() und pnoutrefresh() werden analog zu
wrefresh() und wnoutrefresh() verwendet, mit der Ausnahme, daß sie
sich auf kleine Fenster und nicht auf Fenster beziehen. Über die
zusätzlichen Argumente wird angegeben, welcher Teil im kleinen Fenster
und auf dem Bildschirm betroffen ist. Die Argumente pminrow und
pmincol geben den Ursprung des Rechtecks an, das im kleinen Fenster
angezeigt werden soll. Die Argumente sminrow, smincol, smaxrow und
smaxcol geben die Seiten des Rechtecks an, das auf dem Bildschirm
angezeigt werden soll. Die untere rechte Ecke des im kleinen Fenster
anzuzeigenden Rechtecks wird aus den Bildschirmkoordinaten berechnet,
da beide Rechtecke dieselbe Größe aufweisen müssen. Beide Rechtecke
müssen in den zugehörigen Strukturen vollständig enthalten sein. Nega-
tive Werte für pminrow, pmincol, sminrow oder smincol werden wie Null-
werte behandelt.
Seite 1 Reliant UNIX 5.44 Gedruckt 11/98
newpad(3X) newpad(3X)
RÜCKGABEWERT
Nach erfolgreicher Ausführung geben die Funktionen newpad() und
subpad() einen Zeiger auf die Datenstruktur des kleinen Fensters
zurück. Andernfalls wird ein Null-Zeiger zurückgegeben.
Nach erfolgreicher Ausführung geben die Funktionen pnoutrefresh() und
prefresh() den Wert OK zurück. Andernfalls wird ERR zurückgegeben.
FEHLER
Es sind keine Fehlerzuordnungen definiert.
HINWEISE
Rufen Sie zur Aktualisierung eines kleinen Fensters die Funktion
prefresh() oder pnoutrefresh() und nicht die Funktion wrefresh() auf.
Denken Sie beim Portieren von Code aus Fensterdatenstrukturen (WINDOW)
für kleine Fenster daran, daß für diese Funktionen zusätzliche Argu-
mente erforderlich sind, um den anzuzeigenden Teil des kleinen Fen-
sters und die Position für die Anzeige auf dem Bildschirm zu spezifi-
zieren.
Ein untergeordnetes Fenster und das zugehörige übergeordnete kleine
Fenster können zwar Speicher für die Darstellung der Zeichen im klei-
nen Fenster gemeinsam verwenden, dies bedeutet jedoch nicht, daß sie
auch die Statusinformationen zu den Änderungen im kleinen Fenster
gemeinsam verwenden. Aus diesem Grunde muß nach dem Ändern eines
untergeordneten Fensters innerhalb eines kleinen Fensters möglicher-
weise vor dem Aufrufen von prefresh() die Funktion touchwin() oder
touchline() für das kleine Fenster aufgerufen werden.
SIEHE AUCH
curses(3X), derwin(3X), doupdate(3X), islinetouched(3X), curses(5).
Seite 2 Reliant UNIX 5.44 Gedruckt 11/98