


curs_touch(3X)                                     curs_touch(3X)


NNAAMMEE
       ccuurrss__ttoouucchh:  ttoouucchhwwiinn,  ttoouucchhlliinnee,  uunnttoouucchhwwiinn,  wwttoouucchhllnn,
       iiss__lliinneettoouucchheedd, iiss__wwiinnttoouucchheedd  -  ccuurrsseess  refresh  control
       routines

SSYYNNOOPPSSIISS
       ##iinncclluuddee <<ccuurrsseess..hh>>
       iinntt ttoouucchhwwiinn((WWIINNDDOOWW **wwiinn));;
       iinntt ttoouucchhlliinnee((WWIINNDDOOWW **wwiinn,, iinntt ssttaarrtt,, iinntt ccoouunntt));;
       iinntt uunnttoouucchhwwiinn((WWIINNDDOOWW **wwiinn));;
       iinntt wwttoouucchhllnn((WWIINNDDOOWW **wwiinn,, iinntt yy,, iinntt nn,, iinntt cchhaannggeedd));;
       iinntt iiss__lliinneettoouucchheedd((WWIINNDDOOWW **wwiinn,, iinntt lliinnee));;
       iinntt iiss__wwiinnttoouucchheedd((WWIINNDDOOWW **wwiinn));;

DDEESSCCRRIIPPTTIIOONN
       The  ttoouucchhwwiinn  and ttoouucchhlliinnee routines throw away all opti-
       mization information about which parts of the window  have
       been  touched,  by  pretending  that the entire window has
       been drawn on.  This is  sometimes  necessary  when  using
       overlapping  windows, since a change to one window affects
       the other window, but the records of which lines have been
       changed  in  the  other  window do not reflect the change.
       The routine ttoouucchhlliinnee only pretends that _c_o_u_n_t lines  have
       been changed, beginning with line _s_t_a_r_t.

       The  uunnttoouucchhwwiinn  routine  marks all lines in the window as
       unchanged since the last call to wwrreeffrreesshh.

       The wwttoouucchhllnn routine makes _n lines in the window, starting
       at  line  _y,  look as if they have (_c_h_a_n_g_e_d==11) or have not
       (_c_h_a_n_g_e_d==00) been changed since the last call to  wwrreeffrreesshh.

       The  iiss__lliinneettoouucchheedd and iiss__wwiinnttoouucchheedd routines return TTRRUUEE
       if the specified line/window was modified since  the  last
       call  to  wwrreeffrreesshh; otherwise they return FFAALLSSEE.  In addi-
       tion, iiss__lliinneettoouucchheedd returns EERRRR if _l_i_n_e is not valid  for
       the given window.

RREETTUURRNN VVAALLUUEE
       All  routines  return  the integer EERRRR upon failure and an
       integer value other than EERRRR upon  successful  completion,
       unless  otherwise  noted in the preceding routine descrip-
       tions.

PPOORRTTAABBIILLIITTYY
       The XSI Curses standard, Issue  4  describes  these  func-
       tions.

       Some  historic  curses  implementations had, as an undocu-
       mented feature,  the  ability  to  do  the  equivalent  of
       cclleeaarrookk((......,,    11))    by    saying   ttoouucchhwwiinn((ssttddssccrr))   or
       cclleeaarr((ssttddssccrr)).  This will not work under ncurses.





                                                                1





curs_touch(3X)                                     curs_touch(3X)


NNOOTTEESS
       Note that all routines except wwttoouucchhllnn may be macros.

SSEEEE AALLSSOO
       ccuurrsseess(3X), ccuurrss__rreeffrreesshh(3X).




















































                                                                2


