2011-07-07 15:41:53 +02:00
|
|
|
/* Public Domain Curses */
|
|
|
|
|
|
|
|
#include <curspriv.h>
|
|
|
|
|
|
|
|
RCSID("$Id: touch.c,v 1.29 2008/07/13 16:08:18 wmcbrine Exp $")
|
|
|
|
|
|
|
|
/*man-start**************************************************************
|
|
|
|
|
|
|
|
Name: touch
|
|
|
|
|
|
|
|
Synopsis:
|
|
|
|
int touchwin(WINDOW *win);
|
|
|
|
int touchline(WINDOW *win, int start, int count);
|
|
|
|
int untouchwin(WINDOW *win);
|
|
|
|
int wtouchln(WINDOW *win, int y, int n, int changed);
|
|
|
|
bool is_linetouched(WINDOW *win, int line);
|
|
|
|
bool is_wintouched(WINDOW *win);
|
|
|
|
|
|
|
|
Description:
|
2011-10-31 20:54:00 +01:00
|
|
|
touchwin() and touchline() throw away all information about
|
|
|
|
which parts of the window have been touched, pretending that the
|
|
|
|
entire window has been drawn on. This is sometimes necessary
|
|
|
|
when using overlapping windows, since a change to one window
|
|
|
|
will affect the other window, but the records of which lines
|
|
|
|
have been changed in the other window will not reflect the
|
2011-07-07 15:41:53 +02:00
|
|
|
change.
|
|
|
|
|
2011-10-31 20:54:00 +01:00
|
|
|
untouchwin() marks all lines in the window as unchanged since
|
2011-07-07 15:41:53 +02:00
|
|
|
the last call to wrefresh().
|
|
|
|
|
2011-10-31 20:54:00 +01:00
|
|
|
wtouchln() makes n lines in the window, starting at line y, look
|
|
|
|
as if they have (changed == 1) or have not (changed == 0) been
|
2011-07-07 15:41:53 +02:00
|
|
|
changed since the last call to wrefresh().
|
|
|
|
|
2011-10-31 20:54:00 +01:00
|
|
|
is_linetouched() returns TRUE if the specified line in the
|
|
|
|
specified window has been changed since the last call to
|
2011-07-07 15:41:53 +02:00
|
|
|
wrefresh().
|
|
|
|
|
2011-10-31 20:54:00 +01:00
|
|
|
is_wintouched() returns TRUE if the specified window
|
2011-07-07 15:41:53 +02:00
|
|
|
has been changed since the last call to wrefresh().
|
|
|
|
|
|
|
|
Return Value:
|
|
|
|
All functions return OK on success and ERR on error except
|
|
|
|
is_wintouched() and is_linetouched().
|
|
|
|
|
|
|
|
Portability X/Open BSD SYS V
|
|
|
|
touchwin Y Y Y
|
|
|
|
touchline Y - 3.0
|
|
|
|
untouchwin Y - 4.0
|
|
|
|
wtouchln Y Y Y
|
|
|
|
is_linetouched Y - 4.0
|
|
|
|
is_wintouched Y - 4.0
|
|
|
|
|
|
|
|
**man-end****************************************************************/
|
|
|
|
|
|
|
|
int touchwin(WINDOW *win)
|
|
|
|
{
|
|
|
|
int i;
|
|
|
|
|
|
|
|
PDC_LOG(("touchwin() - called: Win=%x\n", win));
|
|
|
|
|
|
|
|
if (!win)
|
|
|
|
return ERR;
|
|
|
|
|
|
|
|
for (i = 0; i < win->_maxy; i++)
|
|
|
|
{
|
|
|
|
win->_firstch[i] = 0;
|
|
|
|
win->_lastch[i] = win->_maxx - 1;
|
|
|
|
}
|
|
|
|
|
|
|
|
return OK;
|
|
|
|
}
|
|
|
|
|
|
|
|
int touchline(WINDOW *win, int start, int count)
|
|
|
|
{
|
|
|
|
int i;
|
|
|
|
|
|
|
|
PDC_LOG(("touchline() - called: win=%p start %d count %d\n",
|
|
|
|
win, start, count));
|
|
|
|
|
|
|
|
if (!win || start > win->_maxy || start + count > win->_maxy)
|
|
|
|
return ERR;
|
|
|
|
|
|
|
|
for (i = start; i < start + count; i++)
|
|
|
|
{
|
|
|
|
win->_firstch[i] = 0;
|
|
|
|
win->_lastch[i] = win->_maxx - 1;
|
|
|
|
}
|
|
|
|
|
|
|
|
return OK;
|
|
|
|
}
|
|
|
|
|
|
|
|
int untouchwin(WINDOW *win)
|
|
|
|
{
|
|
|
|
int i;
|
|
|
|
|
|
|
|
PDC_LOG(("untouchwin() - called: win=%p", win));
|
|
|
|
|
|
|
|
if (!win)
|
|
|
|
return ERR;
|
|
|
|
|
|
|
|
for (i = 0; i < win->_maxy; i++)
|
|
|
|
{
|
|
|
|
win->_firstch[i] = _NO_CHANGE;
|
|
|
|
win->_lastch[i] = _NO_CHANGE;
|
|
|
|
}
|
|
|
|
|
|
|
|
return OK;
|
|
|
|
}
|
|
|
|
|
|
|
|
int wtouchln(WINDOW *win, int y, int n, int changed)
|
|
|
|
{
|
|
|
|
int i;
|
|
|
|
|
|
|
|
PDC_LOG(("wtouchln() - called: win=%p y=%d n=%d changed=%d\n",
|
|
|
|
win, y, n, changed));
|
|
|
|
|
|
|
|
if (!win || y > win->_maxy || y + n > win->_maxy)
|
|
|
|
return ERR;
|
|
|
|
|
|
|
|
for (i = y; i < y + n; i++)
|
|
|
|
{
|
|
|
|
if (changed)
|
|
|
|
{
|
|
|
|
win->_firstch[i] = 0;
|
|
|
|
win->_lastch[i] = win->_maxx - 1;
|
|
|
|
}
|
2011-10-31 20:54:00 +01:00
|
|
|
else
|
2011-07-07 15:41:53 +02:00
|
|
|
{
|
|
|
|
win->_firstch[i] = _NO_CHANGE;
|
|
|
|
win->_lastch[i] = _NO_CHANGE;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
return OK;
|
|
|
|
}
|
|
|
|
|
|
|
|
bool is_linetouched(WINDOW *win, int line)
|
|
|
|
{
|
|
|
|
PDC_LOG(("is_linetouched() - called: win=%p line=%d\n", win, line));
|
|
|
|
|
|
|
|
if (!win || line > win->_maxy || line < 0)
|
|
|
|
return FALSE;
|
|
|
|
|
|
|
|
return (win->_firstch[line] != _NO_CHANGE) ? TRUE : FALSE;
|
|
|
|
}
|
|
|
|
|
|
|
|
bool is_wintouched(WINDOW *win)
|
|
|
|
{
|
|
|
|
int i;
|
|
|
|
|
|
|
|
PDC_LOG(("is_wintouched() - called: win=%p\n", win));
|
|
|
|
|
|
|
|
if (win)
|
|
|
|
for (i = 0; i < win->_maxy; i++)
|
|
|
|
if (win->_firstch[i] != _NO_CHANGE)
|
|
|
|
return TRUE;
|
|
|
|
|
|
|
|
return FALSE;
|
|
|
|
}
|