vidattr(3X)                                                     vidattr(3X)

NAME
     vidattr, vidattr, vidputs, vidputs - Attribute an das Terminal aus-
     geben

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

     #include <curses.h>

     int vidattr(chtype attr);

     int vidattr(attrt attr, short colorpairnumber, void *opt);

     int vidputs(chtype attr, int (*putfunc)(int));

     int vidputs(attrt attr, short colorpairnumber, void *opt, int
           (*putfunc)(int));

BESCHREIBUNG
     Diese Funktionen geben Kommandos an das Terminal aus, über die die
     Attribute des Terminals geändert werden.

     Wenn die Datenbasis terminfo angibt, daß das verwendete Terminal Zei-
     chen in der durch attr angegebenen Darstellung anzeigen kann, gibt
     vidattr() ein oder mehrere Kommando(s) aus, über die das Terminal auf-
     gefordert wird, alle nachfolgenden Zeichen in der entsprechenden Dar-
     stellung anzuzeigen. Die Ausgabe erfolgt nach einem Aufruf von
     putchar(). Von der Funktion vidattr() wird das innerhalb von Curses
     verwendete Modell des vorherigen Darstellungsmodus weder zugrundege-
     legt noch aktualisiert.

     Die Funktion vidputs() gibt denselben String wie vidattr() an das Ter-
     minal aus, basierend auf attr, mit der Ausnahme, daß die Ausgabe von
     vidputs() über den Aufruf der benutzerdefinierten Funktion putfunc
     erfolgt. Die Funktionen vidattr() und vidputs() entsprechen den
     Funktionen vidattr() bzw. vidputs(), verwenden jedoch mehrere Argu-
     mente (ein Argument vom Typ attrt für die Attribute, eines vom Typ
     short für die Nummer des Farbpaares und eines vom Typ void *) und
     unterstützen so die Attributkonstanten mit dem Präfix WA.

     Das Argument opts wird in einer späteren Ausgabe der vorliegenden
     Handbuchseite (Man Page) definiert. Derzeit muß die Anwendung für opts
     einen Null-Zeiger angeben.

     Bei der benutzerdefinierten Funktion putfunc (die als ein Argument
     sowohl für vidputs() als auch für vidputs() angegeben werden kann)
     handelt es sich entweder um putchar() oder um eine andere Funktion mit
     demselben Prototyp. Sowohl vidputs() als auch vidputs() ignorieren
     den Rückgabewert von putfunc.






Seite 1                      Reliant UNIX 5.44               Gedruckt 11/98

vidattr(3X)                                                     vidattr(3X)

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.

HINWEISE
     Nach der Verwendung einer dieser Funktionen entspricht das Modell des
     Terminalstatus innerhalb von Curses möglicherweise nicht mehr dem tat-
     sächlichen Status des Terminals. Die Anwendung sollte das Fenster als
     geändert markieren und aktualisieren, bevor die normale Verwendung von
     Curses wiederaufgenommen wird.

     Für die Verwendung dieser Funktionen muß die Anwendung so viele Infor-
     mationen zu einer bestimmten Terminalklasse enthalten, daß es keinen
     Grund für den Einsatz von Curses mehr gibt.

     Auf einigen Terminals belegt ein Kommando zur Änderung der Darstellung
     vom Konzept her Platz im Bildschirmpuffer (mit oder ohne Breite). Dem-
     nach würde ein Kommando, das das Terminal auf eine neue Darstellung
     setzt, die Darstellung einiger bereits angezeigter Zeichen ändern.

SIEHE AUCH
     putchar(3S), putwchar(3S), curses(3X), doupdate(3X),
     islinetouched(3X), tigetflag(3X), curses(5).




























Seite 2                      Reliant UNIX 5.44               Gedruckt 11/98