Sous-routine vidattr, vid_attr, vidputs ou vid_puts

Objectif

Sorties des attributs du terminal.

Bibliothèque

Bibliothèque Curses (libcurses.a)

Syntaxe

#include <curses.h>

int vidattr
(chtype attr);

int vid_attr
(attr_t attr,
short color_pair_number,
void *opt);

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

int vid_puts
(attr_t attr,
short color_pair_number,
void *opt,
int (*putfunc)(int));

Descriptif

Ces sous-routines extront des commandes vers un terminal qui modifie les attributs du terminal.

Si la base de données Terminfo indique que le terminal en cours d'utilisation peut afficher des caractères dans le rendu spécifié par Attr, la sous-routine Attr. Vadattr génère une ou plusieurs commandes pour demander que le terminal affiche les caractères suivants dans cette version. Les sorties de sous-routine en appelant la sous-routine Chipar. La sous-routine Vidattr n'utilise ni ne met à jour le modèle que Curses maintient du mode de rendu antérieur.

La sous-routine Vidonnes calcule la même chaîne de sortie de terminal que Vidattr , basée sur Attr, mais les sorties de sous-routine Vidonnes en appelant le sous-programme Putfuncfourni par l'utilisateur. Les sous-routines Vid_attr et Vid_puts correspondent respectivement à Vidattr et Vidonnes , mais prennent un ensemble d'arguments, un de type Attr_t pour les attributs, Abrégé pour le numéro de paire de couleurs et un Void *, et prennent donc en charge les constantes d'attribut avec le préfixe WA_prefix.

L'argument Opts est réservé pour la définition dans une édition ultérieure de ce document. Actuellement, l'application doit fournir un pointeur nul en tant qu'opts.

Le sous-programme Putfunc fourni par l'utilisateur (qui peut être spécifié en tant qu'argument de Vidonnes ou Vid_puts est Putchar ou une autre sous-routine avec le même prototype. Les sous-routines Vidonnes et Vid_puts ignorent la valeur de retour de Putfunc.

Paramètres

Valeurs renvoyées

Une fois l'exécution terminée, ces sous-routines renvoient OK. Sinon, ils retournent ERR.

Exemples

1. Pour générer la chaîne qui place le terminal dans son mode d'arrêt optimal via le sous-programme Putchar , entrez

   vidattr(A_STANDOUT);

2. Pour générer la chaîne qui place le terminal dans son mode de fonctionnement optimal via la sous-routine Putcharmy_putc, entrez

   int (*my_putc) ();
   vidputs(A_STANDOUT, my_putc);