is_linetouched, is_wintouched, touchline, touchwin, untouchwin ou wtouchin Sous-routine

Objectif

Fonctions de contrôle d'actualisation de fenêtre.

Bibliothèque

Bibliothèque Curses (libcurses.a)

Syntaxe

#include <curses.h>

bool is_linetouched(WINDOW *win,
int line);

bool is_wintouched(WINDOW *win);

int touchline(WINDOW *win,
int start,
int count);

int touchwin(WINDOW *win);

int untouchwin(WINDOW *win);

int wtouchln(WINDOW *win,
int y,
int n,
int changed);

Descriptif

La sous-routine touchline touche la fenêtre spécifiée (c'est-à-dire qu'elle la marque comme ayant été modifiée plus récemment que la dernière opération d'actualisation). La sous-routine touchline ne touche que les lignes de comptage, en commençant par le début de la ligne.

La sous-routine untouchwin marque toutes les lignes de la fenêtre comme inchangées depuis la dernière opération d'actualisation.

L'appel de la sous-routine wtouchln , si la valeur est 1, touche n lignes dans la fenêtre spécifiée, en commençant à la ligne y. Si la valeur modifiée est 0, wtouchln marque ces lignes comme inchangées depuis la dernière opération d'actualisation.

La sous-routine is_wintouchwin détermine si la fenêtre spécifiée est touchée. La sous-routine is_linetouched détermine si la ligne de la fenêtre spécifiée est touchée.

Paramètres

Valeurs renvoyées

Les sous-routines is_linetouched et is_wintouched renvoient TRUE si l'une des lignes spécifiées, ou la fenêtre spécifiée, respectivement, a été touchée depuis la dernière opération d'actualisation. Sinon, ils renvoient FALSE.

Une fois l'opération terminée, les autres sous-routines renvoient OK. Dans le cas contraire, ils renvoient ERR. Des exceptions à cette règle sont notées dans le sous-programme précédent.

Exemples

Pour la sous-routine touchline :

A définir10lignes pour l'actualisation à partir de la ligne5de la fenêtre définie par l'utilisateurmy_window, utilisez:

WINDOW *my_window;
touchline(my_window, 5, 10);
wrefresh(my_window);

Cela force malédiction à ignorer toutes les informations d'optimisation qu'elle peut avoir pour les lignes 0 à 4 dansmy_window. curses suppose que tous les caractères des lignes 0 à 4 ont été modifiés.

Pour la sous-routine touchwin :

Pour actualiser une fenêtre parent définie par l'utilisateur,parent_window, qui a été édité via ses sous-fenêtres, utilisez:

WINDOW *parent_window;
touchwin(parent_window);
 
wrefresh(parent_window);

Cela force malédiction à ignorer les informations d'optimisation qu'elle peut avoir pourmy_window. curses suppose que toutes les lignes et colonnes ont été modifiées pourmy_window.